Transaction Verification - APIs for Businesses

Request

Header Params

Content-Type

string

required

Example:

application/json

Accept

string

required

Example:

application/json

token

string

required

AccessToken will be share separately

Example:

{AccessToken}

Body Params application/json

Body Params

identity_code

string

required

Search by reference number at merchant side

tran_id

string

optional

Search by transaction number at Bill24 side

bank_ref

string

optional

Search by reference number at bank side

purpose_of_transaction

string

required

Search by bill issue date or bill number

Example

{
  "identity_code": "234000545",
  "purpose_of_transaction": "INV23001"
}

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 'token: {AccessToken}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identity_code": "234000545",
    "purpose_of_transaction": "INV23001"
}'

Responses

🟢200Success

application/json

Body

Responses

code

string

required

Response code

message

string

required

Response message

data

object

required

Data object

tran_id

string

required

Transaction number at Bill24 side

tran_date

string

required

Transaction date

tran_amount

integer

required

Original amount of the transaction

fee_amount

integer

required

Fee charge of the transaction

total_amount

integer

required

Total paid amount

currency

string

required

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

identity_code

string

required

Reference number at merchant side

bank_code

string

required

Bank code at Bill24 side

bank_ref

string

required

Reference number at bank side

purpose_of_transaction

string

required

Bill issue date or bill number

status

string

required

Status of the transaction

customer_code

string

optional

Customer code

customer_name

string

optional

Name of the customer

customer_phone

string

optional

Phone number of the customer

description

string

optional

Description

Example

{
  "code": "SUCCESS",
  "message": "Transaction found.",
  "data": {
    "tran_id": "fb8ca8005094",
    "tran_date": "2023-05-10T15:47:12.890062",
    "tran_amount": 20000,
    "fee_amount": 500,
    "total_amount": 20500,
    "currency": "KHR",
    "identity_code": "234000545",
    "bank_code": "AMK",
    "bank_ref": "FT1234567890",
    "purpose_of_transaction": "INV23001",
    "status": "success",
    "customer_code": "",
    "customer_name": "",
    "customer_phone": "",
    "description": ""
  }
}