Webhook

POST

https://mock.apidog.com/m1/444561-0-default/webhook

Bill24 send transaction detail through this interface to merchant. This endpoint implement by merchant side.

NOTE

Change to your best URL:https://yourdomain/webhook

Request Header mock API:

Name	value	Description
`Success`	`success`	Test case successful (default success)
`Fail`	`fail`	Test case fail

Request

Body Params application/json

tran_id

string

optional

Reference transaction at Bill24

tran_no

string

optional

Transaction number at Bill24

payment_service_type

string

optional

Transaction type
Ex:
1.Bank Channel: transaction from Bank channel (mobile app, …)
2.KHQR: transaction scan QR code pay
3.Deeplink/Checkout: transaction from checkout page or from deeplink app to app
4.Direct Debit: transaction auto direct debit

tran_date

string

optional

Transaction date (Current Date )

tran_amount

number

optional

Original amount of the transaction

currency

string

optional

Currency code ISO 4217 (USD, KHR...)

bank_code

string

optional

Bank code at Bill24

bank_name

string

optional

Bank’s name

bank_ref

string

optional

Reference number at bank side

identity_code

string

optional

Reference number at merchant side
(This code used to confirm the payment)

purpose_of_transaction

string

optional

Bill issue date or bill number

device_code

string

optional

Serial number of QR code display device or terminal

status

string

optional

Status of the transaction

Customer

array [object {7}]

optional

List of customer data

branch_code

string

optional

Branch code

branch_name

string

optional

The name of the branch

customer_code

string

optional

Customer code

customer_name

string

optional

The name of the customer

customer_name_latin

string

optional

The name of the customer in Latin

bill_no

string

optional

Bill or invoice number

amount

string

optional

Amount of the bill or invoice

Example

{
  "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
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mock.apidog.com/m1/444561-0-default/webhook' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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
        }
    ]
}'

Responses

🟢200Success

application/json

Body

status

string

required

message

string

required

Examples

SuccessError

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

Modified at 2025-03-06 11:11:31

Transaction Verification