Merchant Proxy

Light Mode

Webhook

POSThttps://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

Header Params

string

required

Example:

application/json

Content-Type

string

required

Example:

application/json

Token

string

required

Example:

1603aa00dcc4426ba83298341bab126b

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

customers

array [object {7}] | null

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

number

optional

Amount of the bill or invoice

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

Responses

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

status

string

required

message

string

required

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

Last modified: 6 days ago