Add Link Account

POST

https://merchantapi-demo.bill24.io/on_boarding/add_link_account

This endpoint is used to allow Sub Biller to link their account for settlement.

Request

Header Params

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {token get from endpoint (Authorization) }

Body Params application/json

supplier_sync_code

string

required

Sub Biller id at Biller side

bank_id

string

required

Bank id is used to identify the bank where the Sub Biller wants to activate an account can get from endpoint (Get Available
Banks)

return_url

string

required

Url to return when add account successful (provide by
Biller)

currency

string

optional

Currency that allow Sub Biller to add specific account (KHR)

Example

{
    "supplier_sync_code": "Cpo001",
    "bank_id": "AC",
    "return_url": "https://example.com/redirect-page",
    "currency": "KHR"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://merchantapi-demo.bill24.io/on_boarding/add_link_account' \
--header 'Content-Type:  application/json' \
--header 'Authorization:  Bearer {token get from endpoint (Authorization) }' \
--header 'Content-Type: application/json' \
--data-raw '{
    "supplier_sync_code": "Cpo001",
    "bank_id": "AC",
    "return_url": "https://example.com/redirect-page",
    "currency": "KHR"
}'

Responses

🟢200Success

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

Data object

code

string

optional

Supplier code at Bill24 side

supplier_sync_code

string

optional

Sub Biller id at Biller side

name

string

optional

Sub Biller name in English

name_kh

string

optional

Sub Biller name in Khmer

address

string

optional

Sub Biller address

add_link_account

object

optional

Data object

Example

{
    "code": "000",
    "message": "success",
    "message_kh": "ជោកជ័យ",
    "data": {
        "code": "2839",
        "supplier_sync_code": "Cpo001",
        "name": "station 1",
        "name_kh": "ស្ថានីយ៍១",
        "address": "Chbar Ompov,Phnom Penh",
        "add_link_account": {
            "web_url": "https://example.bank.com.kh/47291847702ACPURDF8ShEJaPKqhYg"
        }
    }
}

🔵314Response

🔵312Response

⚪1Response

Modified at 2025-07-08 17:11:15

Get Available Banks

Verify Linked Bank Account