XENSYISME

Dokumentasi API Reseller

Hubungkan web store kamu ke XENSYISME. Kamu tidak perlu menyimpan stok sendiri: web kamu membeli akun langsung dari XENSYISME memakai saldo, dan kamu bebas menentukan harga jual sendiri.

1. Langkah awal

  1. Berlangganan resmi lewat tombol Berlangganan (akun trial tidak bisa memakai API).
  2. Top up saldo terlebih dahulu di menu Developer. Tanpa saldo, semua pembelian lewat API ditolak.
  3. Tekan Buat API Key. Key tetap tersimpan di menu Developer (bisa disembunyikan/ditampilkan) — pasang di server web kamu, jangan taruh di kode browser.
  4. Simpan juga Kode Pemulihan di Profil agar akun, saldo, dan API key tidak hilang saat ganti HP atau data browser terhapus.

2. Autentikasi

Kirim API key di setiap request (dari server, bukan browser):

Authorization: Bearer XENSY_xxxxxxxxxxxxxxxx

Base URL: https://xensyiissme-ress.lovable.app/api/public/v1. Batas 60 request per menit.

3. Endpoint

Cek saldo

GET /balance
→ { "ok": true, "balance": 25000, "currency": "IDR" }

Daftar produk & stok

GET /products
→ { "ok": true, "products": [ { "id": "uuid", "name": "Netflix", "duration_label": "1 Bulan", "price": 15000, "stock": 12, ... } ] }

price adalah harga modal yang dipotong dari saldo kamu. Harga jual di web kamu atur sendiri.

Beli akun

POST /orders
Content-Type: application/json
{ "product_id": "uuid", "quantity": 1 }

→ 201 { "ok": true, "balance": 10000, "order": {
    "order_code": "API-XXXX", "status": "delivered", "total": 15000,
    "accounts": [ { "email": "...", "password": "...", "cookies": null, "notes": "" } ] } }

Ambil ulang order

GET /orders/API-XXXX

Semua pembelian API juga tersimpan di Library akun kamu.

4. Kode error

401 INVALID_API_KEY       API key salah atau sudah diganti
403 NOT_RESELLER          Belum join Reseller
403 RESELLER_EXPIRED      "Masa Reseller habis, silahkan join ulang."
402 INSUFFICIENT_BALANCE  Saldo kosong / tidak cukup, silahkan top up
409 OUT_OF_STOCK          Stok tidak cukup
429 RATE_LIMITED          Terlalu banyak request

Saran: tampilkan pesan message dari respons langsung di web store kamu, misalnya saat 403 tampilkan "Masa Reseller habis, silahkan join ulang" dan saat 402 tampilkan "Saldo kosong".

5. Syarat & Ketentuan

  • API key dan semua fitur hanya aktif selama status Reseller aktif. Saat masa Reseller habis, semua request ditolak sampai kamu join ulang. Saldo tidak hangus dan bisa dipakai lagi setelah join ulang.
  • Saldo hanya untuk pembelian di XENSYISME dan tidak dapat ditarik atau diuangkan kembali.
  • Pembelian yang berhasil memotong saldo dan tidak dapat dibatalkan. Kendala akun hubungi CS Admin lewat Telegram dengan menyertakan Order ID.
  • Kamu bertanggung jawab menjaga kerahasiaan API key dan kode pemulihan. Jika bocor, segera buat API key baru (key lama otomatis tidak berlaku).
  • Dilarang menjual ulang API key, membagikan akses, atau menyalahgunakan layanan. Admin berhak mencabut status Reseller jika terjadi pelanggaran.