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/order 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 |
Dua Cara Menerima Status
IsiKuota mendukung dua 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.
tip
Selalu implementasikan webhook untuk menangani kasus di mana response sinkron mengembalikan pending. Status final akan dikirim via callback.
Langkah Selanjutnya
- Autentikasi — Cara mendapatkan dan menggunakan API Key
- Quick Start — Langsung coba transaksi pertama