Webhook

Enable Webhook

Once the payment is complete, Bill24 will push payment data to merchant system, requiring the implementation of a webhook on the merchant side.

:::note
Merchant need to enable this feature in Bill24 portal
:::

Parameters Repsonse

Field	Type	Remark
tran_id	String	Transaction number at Bill24 side
tran_date	String	Transaction date
tran_amount	Decimal	Original amount of the transaction
fee_amount	Decimal	Fee charge of the transaction
total_amount	Decimal	Total paid amount
currency	String	Currency code (ISO 4217)
identity_code	String	Reference number at merchant side
bank_code	String	Bank code at Bill24 side
bank_ref	String	Reference number at bank side
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)
channel_code	String	Payment channel code (You can get channel code from GetBillerProfile function)
status	String	Status of the transaction
description	String	Description
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": "174952172035635",
    "tran_date": "2023-05-10T15:47:12.890062",
    "tran_amount": 50000.00,
    "fee_amount": 500.00,
    "total_amount": 50500.00,
    "currency": "KHR",
    "identity_code": "234000545",
    "bank_code": "AMK",
    "bank_ref": "FT1234567890",
    "purpose_of_transaction": "INV23001",
    "device_code": "T1",
    "channel_code": "001",
    "status": "success",
    "description": "",
    "customers": [
        {
            "branch_code": "BRANCH-PP",
            "branch_name": "Phnom Penh Branch",
            "customer_code": "12340001",
            "customer_name": "ជា សំណាង",
            "customer_name_latin": "CHEA Samnang",
            "bill_no": "INV23001",
            "amount": 50000.00
        }
    ]
}

Last modified: 10 months ago