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 (if
currency is null or empty Sub Biller can add any account
currency)

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-03-27 09:55:16

Onboarding

Get Available Banks