Mulai terhubung.
Kembangkan layananmu.

Uji koneksi tanpa membeli

1. Login sebagai Member, buka API Reseller Center, lalu buat API Key. Simpan key lengkap ketika pertama ditampilkan.
2. Siapkan saldo akun. Pembelian mengikuti syarat akun dan saldo; beberapa alur mensyaratkan deposit sukses minimal Rp2.000.
3. Simpan base URL dan key di environment backend. Gunakan HTTPS pada website produksi.
4. Kirim GET /balance. Setelah berhasil, lanjutkan katalog. Cek saldo tidak membuat order atau memotong saldo.

export ZYREX_API_URL='https://zyrexotp.com/api/v1'
export ZYREX_API_KEY='API_KEY_KAMU'

curl --request GET "$ZYREX_API_URL/balance" \
  --header "Authorization: Bearer $ZYREX_API_KEY" \
  --header 'Accept: application/json'

Ganti API_KEY_KAMU secara lokal. Jangan mengirim key ke halaman dokumentasi, menaruhnya di frontend, atau membagikan file environment.

Alur OTP untuk setiap server

1. Tampilkan harga jual price dari offer kepada pelanggan. Harga memakai rupiah; quoted_price SERVER 1/3 adalah nilai validasi terpisah, jangan dihitung ulang.
2. Simpan satu Idempotency-Key unik 16–128 karakter dan payload order di database sistem kamu sebelum mengirim POST. UUID adalah pilihan yang sesuai.
3. Kirim order satu kali, simpan order_id, nomor, harga dan status. Cek status berdasarkan order_id milik akun yang sama.
4. Poll setiap 5–10 detik dengan batas waktu. Hentikan ketika kode diterima atau status terminal. Hindari polling seluruh pesanan sekaligus.

Endpoint dan parameter

Path berikut relatif terhadap base URL. Semua endpoint memerlukan key; halaman dokumentasi dan file contoh dapat dibuka tanpa key.

Body POST /order

Request builder

Pilih server dan bahasa. Ini hanya membuat contoh kode; tidak mengirim request atau melakukan pembelian.

Isi ID sesuai hasil katalog dan simpan Idempotency-Key sebelum membeli.

Pilih server dan bahasa untuk memuat contoh. File client juga tersedia di bagian Unduhan.

Contoh Python/PHP/Node.js memakai file client yang dapat diunduh. Semua contoh membaca key dari environment, tidak melakukan retry pembelian secara otomatis, dan membiarkan aplikasi kamu memeriksa http_status serta body.

# Python: pasang dependency terlebih dahulu
python -m pip install requests
python zyrex_client.py GET /balance

# Node.js 18+ (tanpa npm dependency)
node zyrex_client.mjs GET /balance

# PHP 8+ dengan ekstensi cURL
php zyrex_client.php GET /balance

# Pembelian eksplisit: isi request.json dari katalog dan gunakan key tersimpan
python zyrex_client.py POST /order request.json ID_KEY_YANG_DISIMPAN
node zyrex_client.mjs POST /order request.json ID_KEY_YANG_DISIMPAN
php zyrex_client.php POST /order request.json ID_KEY_YANG_DISIMPAN

Respons pembelian dan status

{
  "success": true,
  "order_id": "ORDER_ID",
  "server": 2,
  "phone": "6281234567890",
  "status": "waiting",
  "price": 2500,
  "balance": 17500
}

Field service dapat muncul pada SERVER 1/3. Status/replay juga dapat menyertakan otp dan received. Field server dapat berupa angka atau string angka pada endpoint lama. Normalisasikan dengan String(server) pada sistem kamu.

{
  "success": true,
  "order_id": "ORDER_ID",
  "server": 2,
  "status": "received",
  "phone": "6281234567890",
  "otp": "123456",
  "received": true,
  "balance": 17500
}

Jika HTTP 202 tidak memiliki order_id, simpan Idempotency-Key atau reservation_ref yang tersedia. Jangan memanggil /order/null. Ulangi request asli memakai key dan payload yang sama, atau hubungi Admin bila tetap belum pasti.

Integrasi SMM

1. GET /smm/services memberi id, nama, kategori, min, max, price_per_1000 dan requires_comments.
2. Gunakan service_id dari katalog. Pastikan target memenuhi ketentuan layanan dan quantity berada dalam min–max.
3. POST /smm/order dengan Idempotency-Key yang disimpan. Harga dihitung server; jangan mengirim harga sendiri sebagai sumber tagihan.
4. Simpan order_id yang dikembalikan, lalu GET /smm/order/ORDER_ID. Status SMM dapat berupa Pending, Processing, In progress, Partial, Completed atau Canceled.

{
  "service_id": "SERVICE_ID",
  "target": "TARGET_YANG_VALID",
  "quantity": 1000
}

Jika requires_comments=true, sertakan comments dengan satu komentar per baris, contoh "comments": "Komentar pertama\nKomentar kedua". Jumlah tagihan mengikuti jumlah baris. Harga katalog adalah per 1.000, total mengikuti markup/pembulatan backend. Untuk SMM, respons 202 dapat menyertakan pending=true, reservation_ref dan error.code=order_pending. Simpan semuanya sampai hasil jelas.

Error dan tindakan berikutnya

31 kode referensi

Sebagian alur mengirim message langsung, sebagian error.code/error.message. Selalu baca status HTTP, success, status, pending dan pesan. Jangan hanya memeriksa apakah HTTP 200.

{"success": false, "error": {"code": "invalid_api_key", "message": "API key tidak valid atau nonaktif."}}

Retry, batas request, dan refund

• Batas per key: 20 request pembelian per menit (OTP dan SMM berbagi bucket), serta 180 request lainnya per menit. Pembatalan memakai bucket request lainnya. Waktu tunggu rate limit disampaikan dalam message.
• Satu pesanan = satu Idempotency-Key, juga saat timeout atau koneksi terputus. Key berbeda menandakan pembelian berbeda dan bisa menagih lagi.
• Pengulangan yang telah tersimpan memberi order yang sama tanpa membeli lagi. Payload berbeda dengan key sama ditolak. Permintaan lama sebelum dukungan receipt dapat menghasilkan duplicate_request; hubungi Admin untuk pemeriksaan.
• Pembatalan OTP tersedia setelah minimal 3 menit. Bila kode sudah masuk atau pembatalan belum dikonfirmasi, refund tidak langsung diberikan.
• Refund hanya mengikuti pembatalan/penolakan yang terkonfirmasi dan ledger transaksi. Tidak ada jaminan refund hanya karena waktu polling berakhir.
• Waktu tunggu OTP aktif pada alur saat ini sekitar 5 menit, lalu sistem memeriksa pembatalan; hasil akhirnya tetap mengikuti konfirmasi server. Jangan membuat timer lokal yang mengkredit saldo pelanggan tanpa memeriksa hasil ZYREX.

Paket integrasi reseller

Sebelum menghubungi Admin