Dokumentasi API Reseller
Base URL: https://ikyymodzvip.shop/api/v1
Autentikasi: header Authorization: Bearer rsl_xxx (atau X-API-Key). Buat key di menu API. Semua order dibayar dari saldo reseller. Batas: 60 request/menit, 20 order/menit per key.
GET /balance
curl https://ikyymodzvip.shop/api/v1/balance -H "Authorization: Bearer rsl_xxx"
{"success":true,"data":{"balance":125000,"name":"Budi","email":"budi@mail.com"}}
GET /products
Daftar produk, paket (variant_id), harga reseller, dan stok.
{"success":true,"data":[{"id":"abc","name":"Produk X","category":"Game","status":"available",
"variants":[{"id":"abc:0","label":"7 Hari","price":15000,"stock":12}]}]}
POST /orders
Body JSON: variant_id (dari /products), qty (1-20), ref (ID order milikmu, wajib untuk keamanan: ref yang sama tidak membeli ganda dan mengembalikan order yang sama dengan "duplicate":true). Pakai ref baru untuk membeli ulang setelah order gagal.
curl -X POST https://ikyymodzvip.shop/api/v1/orders -H "Authorization: Bearer rsl_xxx" -H "Content-Type: application/json" \
-d '{"variant_id":"abc:0","qty":2,"ref":"INV-1001"}'
{"success":true,"data":{"order_id":"RS-XXXXXXXXXX","status":"paid","product":"Produk X","variant":"7 Hari",
"qty":2,"unit_price":15000,"total":30000,"keys":[{"key":"AAAA"},{"key":"BBBB"}],"balance":95000}}
GET /orders/:id GET /orders
Detail satu order, atau 50 order terakhir.
Kode error
invalid_key 401 | API key salah / dicabut |
ip_not_allowed 403 | IP tidak ada di daftar izin key |
invalid_variant / invalid_qty / invalid_ref 400 | Parameter salah |
out_of_stock 400 | Stok kurang (lihat field stock) |
insufficient_balance 402 | Saldo kurang (lihat balance, total) |
ref_in_progress 409 | ref sedang diproses, cek lagi sebentar |
delivery_failed 502 | Key gagal diambil, saldo dikembalikan otomatis |
rate_limited 429 | Terlalu banyak request |