Transaction Initiation

POST

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

This operation is to create transaction and generate QR code.

Request

Header Params

Body Params application/json

Example

{
    "identity_code": "8071723952085",
    "purposeOfTransaction": "",
    "deviceCode": "",
    "description": "Testing",
    "currency": "USD",
    "amount": 10,
    "language": "USD",
    "cancelUrl": "http://dl-merchant-sample.bill24.io/success",
    "redirectUrl": "http://dl-merchant-sample.bill24.io/success",
    "channel_code": "CH1",
    "userRef": "",
    "customers": [
        {
            "branchCode": "01",
            "branchName": "Bill24",
            "customerCode": "C0001",
            "customerName": "Veansa",
            "customerNameLatin": "BILL-20251205-YJNE7U",
            "billNo": "",
            "customer_phone": "010888999",
            "customer_email": "example@gmail.com",
            "amount": 10
        }
    ]
}

Request Code 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 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'token: {AccessToken}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identity_code": "8071723952085",
    "purposeOfTransaction": "",
    "deviceCode": "",
    "description": "Testing",
    "currency": "USD",
    "amount": 10,
    "language": "USD",
    "cancelUrl": "http://dl-merchant-sample.bill24.io/success",
    "redirectUrl": "http://dl-merchant-sample.bill24.io/success",
    "channel_code": "CH1",
    "userRef": "",
    "customers": [
        {
            "branchCode": "01",
            "branchName": "Bill24",
            "customerCode": "C0001",
            "customerName": "Veansa",
            "customerNameLatin": "BILL-20251205-YJNE7U",
            "billNo": "",
            "customer_phone": "010888999",
            "customer_email": "example@gmail.com",
            "amount": 10
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": "SUCCESS",
    "message": "Transaction initiation success.",
    "message_kh": ប្រតិបត្តិការបង្កើតជោគជ័យ",
    "data": {
        "identity_code": "174952172035635",
        "payment_link": "https:/bill24.io/pay/Bill24_EYhKXzwC0",
        "khqr_string": "00020101021229450014wing_khqr@wing011009666645540209WingBank52045999530384054041.005802KH5915Kranh Virackbot6010PhnomPenh9917001316847322197766304E117"
    }
}

Modified at 2025-12-08 02:37:12

Overview

Transaction Verification