Webhook

Enable Webhook

Once the payment is completed, Bill24 will push payment data indicating payment success to merchant system for clear payment, requiring the implementation of a webhook on the merchant side.

Parameters Repsonse

Field	Type	Remark
tran_id	String	Reference transaction at Bill24
tran_no	String	Transaction number at Bill24
payment_service_type	String	Transaction type Ex: 1 Bank Channel 2 KHQR 3 Deeplink/Checkout 4 Direct Debit
tran_date	String	Transaction date
tran_amount	Decimal	Original amount of the transaction
currency	String	Currency code ISO 4217(USD, KHR...)
bank_code	String	Bank code at Bill24 side
bank_name	String	Bank’s name
bank_ref	String	Reference number at bank side
identity_code	String	Reference number at merchant side(This code used to confirm the payment)
purpose_of_transaction	String	Bill issue date or bill number
device_code	String	Serial number of QR code display device or terminal (You need to map the device code in your system)
status	String	Status of the transaction
customers	List of JSON	List of customer data

Response Payload for "customers"

Field	Type	Remark
branch_code	String	Branch code
branch_name	String	The name of the branch
customer_code	String	Customer code
customer_name	String	The name of the customer
customer_name_latin	String	The name of the customer in Latin
bill_no	String	Bill or invoice number
amount	Decimal	Amount of the bill or invoice

Example Response Payload

{
  "tran_id": "348b4b16-1f06-4563-8204-105a8420a067",
  "tran_no": "6K0BTGwG7HsF",
  "payment_service_type": "Bank Channel",
  "tran_date": "2024-11-29T16:58:16.727168",
  "tran_amount": 45,
  "currency": "USD",
  "bank_code": "AC",
  "bank_name": "ACLEDA",
  "bank_ref": "AC00112301",
  "identity_code": "37627011",
  "purpose_of_transaction": "",
  "device_code": "",
  "status": "success",
  "customers": [
    {
      "branch_code": "",
      "branch_name": "",
      "customer_code": "37627011",
      "customer_name": "MAO SAMON",
      "customer_name_latin": "",
      "bill_no": "",
      "amount": 45
    }
  ]
}