Cara Kerja Platform
Sebelum mulai coding, penting untuk memahami bagaimana platform IsiKuota bekerja di balik layar. Setiap transaksi yang Anda kirim melewati serangkaian proses — dari validasi, routing ke provider, hingga notifikasi balik ke server Anda.
Alur Transaksi
| Tahap | Keterangan |
|---|---|
| 1. Request | Client mengirim request transaksi via POST /v1/transaction dengan signature |
| 2. Routing | IsiKuota memvalidasi signature dan kirim request ke provider |
| 3. Proses | Provider memproses transaksi (pulsa, token, tagihan, dll) |
| 4. Response | IsiKuota mengembalikan status sinkron — pending, success, atau failed |
| 5. Callback | Webhook dikirim ke server client saat status transaksi final berubah |
Alur Status Transaksi
| Status | Keterangan |
|---|---|
pending | Transaksi diterima, menunggu diproses |
processing | Sedang diproses ke provider |
success | Transaksi berhasil |
failed | Transaksi gagal — saldo dikembalikan |
Tiga Cara Mengetahui Status
IsiKuota mendukung tiga mekanisme untuk mengetahui status transaksi:
- Sinkron — Response langsung saat request selesai. Status bisa
pending,success, ataufailed. - Webhook — Notifikasi dikirim ke server Anda saat status final berubah. Cocok untuk transaksi yang diproses secara asinkron.
- Polling Status — Server Anda memanggil
POST /v1/statusdenganref_idsecara berkala sampai status menjadisuccessataufailed. Cocok sebagai cadangan jika webhook belum diterima, atau saat request order timeout.
tip
Selalu implementasikan webhook untuk menangani kasus di mana response sinkron mengembalikan pending. Status final akan dikirim via callback.
caution
Jika memakai polling, jangan lebih sering dari setiap 10 detik per transaksi, dan berhenti begitu status sudah final.
Langkah Selanjutnya
- Autentikasi — Cara mendapatkan dan menggunakan API Key
- Quick Start — Langsung coba transaksi pertama