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": ""
  }
}