Transaction Initiation - APIs for Businesses

Request

Header Params

Accept

string

required

Example:

application/json

Content-Type

string

required

Example:

application/json

token

string

required

Example:

Bearer [your token]

Body Params application/json

identity_code

string

required

Reference number from merchant system

purpose_of_transaction

string

optional

Bill issue date or bill number

device_code

string

optional

Serial number of QR code display device or terminal(You need to map the device code in your system)

description

string

optional

currency

string

required

Currency code (ISO 4217)

amount

integer

required

Amount to pay

language

string

optional

Language km Khmer , en English

cancel_url

string

required

The URL that will redirect to when customer cancel the payment

redirect_url

string

required

The URL that will redirect to after payment completed

channel_code

string

required

Payment channel code (You can get channel code from GetBillerProfile function) the value in this field required only Biller enable KHQR service.

user_ref

string

optional

User reference

customers

array [object {7}]

required

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

integer

required

Amount of the bill or invoice

Example

{
  "identity_code": "test001dfdfA",
  "purpose_of_transaction": "13",
  "device_code": "1113",
  "description": "",
  "currency": "KHR",
  "amount": 10000,
  "language": "km",
  "cancel_url": "",
  "redirect_url": "https://bill24.com.kh/",
  "channel_code": "",
  "user_ref": "x111",
  "customers": [
    {
      "branch_code": "GB",
      "branch_name": "BBB",
      "customer_code": "C01",
      "customer_name": "BOT",
      "customer_name_latin": "BOT",
      "bill_no": "123",
      "amount": 10000
    }
  ]
}

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/init' \
--header 'Accept: application/json' \
--header 'token: Bearer [your token]' \
--header 'Content-Type: application/json' \
--data-raw '{
   "identity_code": "test001dfdfA",
  "purpose_of_transaction": "13",
  "device_code": "1113",
  "description": "",
  "currency": "KHR",
  "amount": 10000,
  "language": "km",
  "cancel_url": "",
  "redirect_url": "https://bill24.com.kh/",
  "channel_code": "",
  "user_ref": "x111",
  "customers": [
    {
      "branch_code": "GB",
      "branch_name": "BBB",
      "customer_code": "C01",
      "customer_name": "BOT",
      "customer_name_latin": "BOT",
      "bill_no": "123",
      "amount": 10000
    }
]
}'

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

supplier

object

optional

customer

object

optional

balances

array [object {16}]

optional

Example

{
  "code": "SUCCESS",
  "message": "Transaction init successful",
  "message_kh": "បង្កើតប្រតិបត្តិការជោគជ័យ",
  "data": {
    "tran_id": "7B9807BB3854",
    "identity_code": "test001dfdfA",
    "payment_link": "https://checkout-demo.bill24.io/checkout/7B9807BB3854",
    "khqr_string": "00020101021230400016amkbkhppxxx@amkb010477770208TESTKHQR520449005802KH5921ស៊ុបភើមែនខេអេកឃ្យូអ័រ6010Phnom Penh540810800.0053031165502025606800.0062470306Bill240512test001dfdfA070411130802131103CH163040E83"
  }
}