Webhook Notification
Tentang Webhook Notification
Saat sistem kami menerima pembayaran dari vendor bank maka kami akan mengirimkan sebuah post request notifikasi ke alamat url yang anda telah setup sebelumnya.
Setup Webhook Notification
untuk mengatur alamat url yang digunakan untuk webhook notification anda bisa menggunakan alamat api endpoint berikut ini :
# HTTP Request
POST/client/webhook
# Body Parameters
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| timestamp | DATETIME (YYYY-MM-DD HH:II:SS) | YA | Waktu terkini saat request dilakukan di sisi anda. Hanya request kurang dari 15 detik yang akan di proses |
| url | STRING | YA | Alamat url yang akan digunakan, harus menggunakan HTTP POST METHOD |
* Contoh Request Body
{
"timestamp" : "2020-03-26 04:00:00",
"url" : "https://domain.com/payment/notification",
}
"timestamp" : "2020-03-26 04:00:00",
"url" : "https://domain.com/payment/notification",
}
# Response
| Parameter | Type | Description |
|---|
* Contoh Response Body
{
"status" : "success"
}
"status" : "success"
}
Pengiriman Webhook
Berikut POST request yang akan kami kirimkan ke alamat notification url anda:
# HTTP Request Body
| Name | Description |
|---|---|
| order_id | Merupakan referensi order id transaksi anda. |
| payment_ref | Merupakan payment referensi yang kami terima dari platform pembayaran. |
| platform | Asal platform pembayaran. |
| channel_id | Id Channel yang digunakan customer untuk melakukan pembayaran, yang mengintepretasikan atm, mobile-banking, internet-banking, edc, dll. |
| payment_amount | Jumlah pembayaran yang dilakukan. |
| deposit_amount | Jumlah kelebihan pembayaran yang akan kami catat dalam bentuk deposit. |
| trx_date | Waktu terjadinya pembayaran dalam format Y-m-d H:i:s. |
| status | Status transaksi berupa partial, payment dan reversal. Dimana partial adalah status jika pembayaran di lakukan secara partial dan belum lunas, saat lunas pembayaran akan berubah menjadi payment |
| remaining_bill_amount | Jumlah sisa tagihan yang tersisa. |
# HTTP Request Header
| Name | Description |
|---|---|
| X-CLASSID-SIGNATURE | Untuk memastikan request adalah dari kami, maka kami akan mengirim signature payload yang kami kirim sesuai API_SECRET yang anda miliki. |
NOTES
Untuk memastikan request adalah dari kami, mohon membandingkan X-CLASSID-SIGNATURE yang kami kirim sesuai dengan signature yang akan anda generate saat menerima payload yg kami kirimkan.