Topup¶
Seluruh transaksi FM kami akan diproses secara sinkron, yang berarti seluruh permintaan request akan langsung mendapatkan respon status sukses/gagal/pending. Apabila status transaksi telah berubah, maka kami akan mengirimkan callback atau report ke url yang telah Anda set di Pengaturan Koneksi FM.
Endpoint¶
Request¶
Berikut ini format topup yang dapat Anda gunakan:
| Parameter | Deskripsi | Tipe Data | Wajib |
|---|---|---|---|
| command | Perintah yang harus dieksekusi: TOPUP | String |
Ya |
| pin | Pin FM Anda | String |
Ya |
| product | Kode produk Anda | String |
Ya |
| msisdn | Nomor tujuan pelanggan (Format: counter.msisdn jika lebih dari sekali) | String |
Ya |
| refTrxid | Transaksi ID unik Digiflazz | String |
Ya |
Contoh Request¶
<?xml version="1.0"?>
<fm>
<command>TOPUP</command>
<pin>123456</pin>
<product>S10</product>
<msisdn>087800001230</msisdn>
<refTrxid>ref-01</refTrxid>
</fm>
Contoh Request Multi¶
<?xml version="1.0"?>
<fm>
<command>TOPUP</command>
<pin>123456</pin>
<product>S10</product>
<msisdn>2.087800001230</msisdn>
<refTrxid>ref-02</refTrxid>
</fm>
Info
Di asumsikan PIN FM Anda yang didaftarkan di Digiflazz adalah 123456
Response dan Callback¶
Berikut ini format response dan callback yang kami berikan:
| Parameter | Deskripsi | Tipe Data | Wajib |
|---|---|---|---|
| status | Status Transaksi | String |
Ya |
| message | Pesan atau keterangan transaksi | String |
Ya |
| fmTrxid | Transaksi ID unik dari kami | String |
Ya |
| refTrxid | Transaksi ID unik FM Anda | String |
Ya |
Contoh Response/Callback Pending¶
<?xml version="1.0"?>
<fm>
<status>1</status>
<message>S10.087800001230 Hrg=10000 PROSES Saldo Rp. 990000. Tele:@telegram Wa:081234512345.</message>
<fmTrxid>fm-01</fmTrxid>
<refTrxid>ref-01</refTrxid>
</fm>
Contoh Response/Callback Sukses¶
<?xml version="1.0"?>
<fm>
<status>0</status>
<message>S10.087800001230 Hrg=10000 SUKSES SN:1234567890. Saldo Rp. 990000. Tele:@telegram Wa:081234512345.</message>
<fmTrxid>fm-01</fmTrxid>
<refTrxid>ref-01</refTrxid>
</fm>
Contoh Response/Callback Gagal¶
<?xml version="1.0"?>
<fm>
<status>2</status>
<message>S10.087800001230 Hrg=10000 GAGAL Saldo Rp. 990000. Alasan = Transaksi Gagal. Tele:@telegram Wa:081234512345.</message>
<fmTrxid>fm-01</fmTrxid>
<refTrxid>ref-01</refTrxid>
</fm>
Testcase Development Mode¶
Berikut adalah contoh request topup yang dapat anda gunakan pada saat proses development
Data¶
| msisdn | Status |
|---|---|
| 087800001230 | Pending lalu Callback Sukses |
| 087800001232 | Pending lalu Callback Gagal |