Transaction Verification - APIs for Businesses

Request

Header Params

Accept

string

required

Example:

application/json

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer [your token]

Body Params application/json

identity_code

string

required

Search by reference number at merchant side

purpose_of_transaction

string

required

Search by transaction number at Bill24 side

tran_id

string

required

Search by transaction number at Bill24 side

bank_ref

string

required

Search by reference number at bank side

Example

{
  "identity_code": "0000012",
  "purpose_of_transaction": "INV0000012",
  "tran_id": "",
  "bank_ref": ""
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://merchantapi-demo.bill24.io/transaction/v2/verify' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer [your token]' \
--header 'Content-Type: application/json' \
--data-raw '{
  "identity_code": "0000012",
  "purpose_of_transaction": "INV0000012",
  "tran_id": "",
  "bank_ref": ""
}'

Responses

🟢200OK

application/json

Body

code

string

optional

Response code

message

string

optional

Response message in English

message_kh

string

optional

Response message in Khmer

data

object

optional

bill_amount

number

optional

Due amount of bill or invoice

fee_amount

number

optional

Transaction Fee setup at Bill24

total_amount

number

optional

Amount to pay = (bill amount + fee amount)

currency

string

optional

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

payment_token

string

optional

Token use to confirm payment or update amount (expired in 10 minutes)

payout_accounts

array [object {2}]

optional

Payout accounts information

Example

{
    "code": "SUCCESS",
    "message": "Transaction found",
    "message_kh": "ប្រតិបត្តិការបានរកឃើញ",
    "data": {
        "device_code": "1113",
        "channel_code": "CH1",
        "customers": [
            {
                "branch_code": "GB",
                "branch_name": "BBB",
                "customer_code": "C01",
                "customer_name": "BOT",
                "customer_name_latin": "BOT",
                "bill_no": "123",
                "amount": 10000
            }
        ],
        "tran_id": "5DD2B215208D",
        "tran_date": "2023-12-27T17:09:50.253174",
        "tran_amount": 10000,
        "fee_amount": 800,
        "total_amount": 10800,
        "currency": "KHR",
        "identity_code": "0000012",
        "bank_code": "",
        "bank_ref": "",
        "purpose_of_transaction": "INV0000012",
        "status": "pending",
        "description": ""
    }
}