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¶
https://api.digiflazz.com/v1/buyer/fm/transaction
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 |