Transaction Initiation

POST

https://merchantapi-demo.bill24.io/transaction/v2/init

This operation is to create transaction at Bill24.
Merchant who using our SDKs can use tran_id from response payload to load the SDK

NOTE

Required merchant redirect_url to open success screen, Bill24 SDKs also have a default success screen.

Request

Header Params

Body Params application/json

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

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

Modified at 2025-03-24 02:58:22

Authorization

Transaction Verification