CHECKOUT/ DEEPLINK

Light Mode

Transaction Initiation

POSTtransaction/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, Bill24 SDKs also have a default success screen.
:::

Request

Header Params

string

optional

Example:

application/json

Content-Type

string

optional

Example:

application/json

token

string

optional

Example:

[token]

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

optional

The URL that will redirect to when customer cancel the payment

redirect_url

string

optional

The URL that will redirect to after payment completed

channel_code

string

required

Payment channel code(You can get channel code from GetBillerProfile function)

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

{
  "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": "CH1",
  "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

Responses

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

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

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

Last modified: 7 months ago