Reseller API

Ringkasan

Jual akun otomatis lewat API

Integrasikan stok akun Leonardo 8500 ke sistemmu. Satu request, langsung dapat akunnya — dibayar dari saldo bot Telegram-mu.

Base URL — semua endpoint relatif terhadap domainmu: https://reseller.botelexkey.online/v1

Auth	Header `X-Reseller-Key: rsk_…` di setiap request
Format	JSON in / JSON out · `Content-Type: application/json`
Produk	Khusus `leonardo_ai` (Leonardo 8500 Credit)
Bayar	Potong saldo bot. Stok kosong → saldo otomatis di-refund

Ambil API key

Self-service dari Telegram

API key kamu diterbitkan sendiri lewat bot — tidak perlu minta admin.

Buka bot Telegram, ketik /start atau /menu.
Tekan tombol 🔗 RESELLER API.
Bot menampilkan key kamu: rsk_…. Simpan baik-baik — ini rahasia, jangan dibagikan.
Butuh key baru? Tekan 🔄 Reset Key — key lama langsung mati.

Key terikat ke akun Telegram-mu, dan saldo yang dipotong adalah saldo akun itu. Satu reseller = satu key aktif.

Saldo & pembayaran

Top-up dulu, order instan

Tiap order memotong saldo bot sebesar harga_reseller × quantity. Isi saldo lewat menu Saldo di bot (QRIS, dll). Cek saldo kapan saja lewat GET /v1/me.

Kalau saldo kurang, order ditolak 402 tanpa memotong apa pun. Kalau stok habis setelah saldo terpotong, saldo otomatis dikembalikan.

Endpoint

GET/v1/me

Info akun reseller: nama, saldo, harga reseller, dan stok terkini. Pakai ini untuk cek sebelum order.

Request

curl https://reseller.botelexkey.online/v1/me \
  -H "X-Reseller-Key: rsk_xxxxxxxxxxxxxxxx"

200 · Response

{
  "success": true,
  "name": "tokosaya",
  "balance": 150000,      // saldo (Rp)
  "product": "leonardo_ai",
  "unit_price": 6500,    // otomatis = harga bot − 500
  "stock": 27,          // stok tersedia
  "enabled": true
}

POST/v1/order

Beli akun. Memotong saldo lalu mengembalikan kredensial akun langsung di response.

Body

Field	Tipe	Keterangan
`quantity` wajib	integer	Jumlah akun, 1–100.
`client_ref` opsional	string	Kode unik ordermu. Retry dengan nilai sama tidak akan double-charge (lihat Idempotensi).

Request

curl -X POST https://reseller.botelexkey.online/v1/order \
  -H "X-Reseller-Key: rsk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"quantity": 10, "client_ref": "po-1001"}'

200 · Response

{
  "success": true,
  "order_id": "RSLR-20260820163500-A1B2",
  "quantity": 10,
  "unit_price": 6500,
  "total": 65000,
  "accounts": [
    "email1@hotmail.com|password1",
    "email2@hotmail.com|password2"
  ],
  "balance_after": 85000
}

Simpan accounts[] dari response — itu satu-satunya kali kredensial dikirim. order_id berguna untuk pencatatanmu.

Referensi

Kode error

Semua error berbentuk { "success": false, "error": "…" }, sebagian dengan field tambahan.

Status	error	Arti & solusi
401	`unauthorized`	Key salah/dicabut. Cek header `X-Reseller-Key`, atau ambil ulang di bot.
402	`insufficient_balance`	Saldo kurang. Response memuat `balance` & `required`. Top-up dulu.
409	`out_of_stock`	Stok kurang dari quantity. Saldo tidak terpotong (auto-refund). Field `available` = sisa stok.
400	`invalid_quantity`	quantity di luar 1–`max`. Field `max` menyertakan batasnya.
400	`bad_json`	Body bukan JSON valid.
500	`reseller_price_not_set`	Admin belum menetapkan harga reseller. Hubungi admin.
503	`reseller_disabled`	Fitur reseller sedang dimatikan admin.

Idempotensi

Sertakan client_ref unik di tiap POST /v1/order. Jika request diulang dengan client_ref yang sama (mis. karena timeout jaringan), server mengembalikan order yang sama — akun tidak diambil dua kali dan saldo tidak terpotong dua kali. Response berisi "idempotent": true.

Praktik aman: buat client_ref dari ID order di sistemmu, dan retry pakai nilai yang sama sampai dapat balasan sukses.