Full Example

Integration Process

---

How to get started.

Merchants are required to implement the below endpoints:

1 Proxy 🔗

The Proxy functions as an interface, allowing Bill24 to retrieve customer or invoice data whenever a payment is initiated through any of the available bank channels.

:::note
This endpoint implement by Merchant side.
Method: POST
Please provide the best URL endpoint: https://yourdomain/proxy
:::

Example Request Payload

{
    //could be invoice code, consumer code or something that merhcant identify to in query. 
    "consumer_code": "CU003035"
}

Example Response Payload

{
    "code": 0,
    "message": "Success",
    "message_kh": "",
    "data": {
        "consumer_code": "CU003035",
        "consumer_name": "ញ៉េប នីម",
        "consumer_name_latin": "Nheb Nim",
        "phone": "010888999",
        "currency": "USD",
        "due_amount": 10,
        "min_amount": -1,
        "max_amount": 5000,
        "balance": 0,
        "description": "Invoice on Feb-2024",
        "last_bill_date": "2024-2-29 10:46:33",
        "last_due_date": "2024-3-30 10:46:33",
        "last_pay_date": "2024-01-05 10:46:33"
    }
}

---

2 Webhook 🔗

When customers make a payment, Bill Gateway will instantly inform the Merchant / Biller System about the transaction status through a Webhook. The transaction details sent to the Webhook endpoint will be in JSON format.

:::note
This endpoint implement by Merchant side.
Method: POST
Please provide the best URL endpoint: https://yourdomain/webhook
:::

Example Request 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
        }
    ]
}
}

Example Response Payload

{
    "status": "Success",
    "message": "SUCCESS",
}

:::note
If there is a failure when posting the webhook to your end, we will make up to 5 retry attempts following our queue rules.
:::