Reseller API

Ringkasan

Jual akun otomatis lewat API

Integrasikan stok produk dari bot ke sistemmu — akun Leonardo, file JSON, email, link redeem, dan lainnya. Satu request, langsung dapat barangnya — 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	Beberapa produk: akun Leonardo (`leonardo_ai`), file JSON Leonardo (`leonardo_ai_8500_json`), Outlook, Hotmail, link redeem Gemini, ChatGPT Plus, dll. Daftar & stok live di `GET /v1/products`. Kirim `product_id` saat order; default `leonardo_ai`.
Harga	Produk Leonardo = harga bot − Rp500; produk lain = harga bot. Selalu ikut harga bot terkini — cek `unit_price` di `GET /v1/products`.
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)
  "products": [ /* semua produk — sama seperti GET /v1/products */ ],
  "product": "leonardo_ai",   // default
  "unit_price": 4500,    // harga default (Leonardo = harga bot − 500)
  "stock": 1854,        // stok default
  "enabled": true
}

GET/v1/products

Daftar semua produk yang bisa dibeli via API, lengkap dengan harga reseller (unit_price) dan stok terkini. Pakai id-nya sebagai product_id saat order.

Request

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

200 · Response

{
  "success": true,
  "products": [
    { "id": "leonardo_ai",           "unit_price": 4500,  "stock": 1854 },
    { "id": "leonardo_ai_8500_json", "unit_price": 4500,  "stock": 230 },
    { "id": "gemini_redeem_link",    "unit_price": 20000, "stock": 37 },
    { "id": "outlook_email",         "unit_price": 2000,  "stock": 982 },
    { "id": "hotmail_email",         "unit_price": 2000,  "stock": 997 }
  ]
}

Stok 0 = produk sedang habis; order akan ditolak 409 tanpa memotong saldo. Cek dulu di sini sebelum order banyak.

POST/v1/order

Beli produk. Memotong saldo lalu mengembalikan barangnya langsung di response — kredensial akun (accounts[]) atau isi file (files[] untuk produk JSON).

Body

Field	Tipe	Keterangan
`product_id` opsional	string	ID produk: `leonardo_ai` (akun, default) atau `leonardo_ai_8500_json` (file JSON). Lihat daftar & stok via `GET /v1/products`.
`quantity` wajib	integer	Jumlah, 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 '{"product_id": "leonardo_ai_8500_json", "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. Untuk produk JSON (leonardo_ai_8500_json), isi tiap file ada di files[] berupa { "filename", "content" } — simpan tiap content sebagai berkas .json. 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.