Callback¶

Ringkasan¶

Callback adalah sebuah metode di mana sebuah sistem akan secara otomatis mengirimkan informasi atau notifikasi kepada URL yang telah ditentukan setelah suatu proses atau transaksi selesai diproses.

HTTP Request¶

Properti	Nilai
Metode	`POST`
Content-Type	`application/json`

URL Callback¶

POST {callback_url}

Payload Callback¶

Contoh respons sukses¶

{
  "code": "DRYN02",
  "msisdn": "089674950955#1000",
  "request_id": "25071w2123q12700001",
  "trxid": 13170,
  "price": 1700,
  "rc": "00",
  "balance": 0,
  "sn": "DNID MAUXXXX EGXXXXX",
  "message": "SUKSES"
}

Contoh respons gagal¶

{
  "code": "DRYN02",
  "msisdn": "0896774950955#1000",
  "request_id": "0015fk5qwixoa5fj",
  "trxid": 17,
  "price": 1700,
  "rc": "23",
  "balance": 45700,
  "message": "Gagal, Gagal biller"
}

Deskripsi parameter¶

Parameter	Keterangan
`code`	Kode produk
`msisdn`	Nomor tujuan pelanggan
`request_id`	Identitas permintaan transaksi dari sisi client
`trxid`	Identitas transaksi yang diberikan oleh server kami
`price`	Nominal / harga transaksi
`rc`	Kode respons transaksi
`balance`	Sisa saldo
`sn`	Nomor serial / referensi (tersedia pada transaksi sukses)
`message`	Pesan status transaksi

Daftar lengkap nilai rc: Kode respons (RC).

Respons callback / acknowledgement¶

Penerima callback boleh mengembalikan respons HTTP sebagai tanda bahwa request callback telah diterima.

Contoh:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success"
}

Acknowledgement ini tidak digunakan untuk memicu pemrosesan lanjutan

Kebijakan retry¶

Callback tidak menerapkan mekanisme retry otomatis.

Jika pengiriman callback gagal karena timeout, gangguan jaringan, atau HTTP response yang tidak berhasil, callback tidak akan dikirim ulang secara otomatis oleh sistem.

Jika diperlukan, notifikasi callback dapat dikirim ulang secara manual dari sistem.

Jika status akhir transaksi belum diterima, gunakan API Cek Status (POST /status) dengan request_id yang sama untuk mendapatkan status transaksi terbaru.