Onboarding

POST

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

This endpoint is used to register a Sub Biller and allows them to link an account for settlement.

If the bank_id field is filled in, the return_url field becomes required

Request

Header Params

Body Params application/json

Example

{
    "supplier_sync_code": "Cpo001",
    "name": "Station 1",
    "name_kh": "ស្ថានីយ៏ទី១",
    "address": "Chbar Ompov,Phnom Penh",
    "return_url": "https://example.com/redirect-page",
    "bank_id": "AC",
    "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/on_boarding_supplier' \
--header 'Content-Type:  application/json' \
--header 'Authorization:  Bearer {token get from endpoint (Authorization)}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "supplier_sync_code": "Cpo001",
    "name": "Station 1",
    "name_kh": "ស្ថានីយ៏ទី១",
    "address": "Chbar Ompov,Phnom Penh",
    "return_url": "https://example.com/redirect-page",
    "bank_id": "AC",
    "currency": "KHR"
}'

Responses

🟢200Success

application/json

Body

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/47291847702ACPUREJaPKqhYg"
        }
    }
}

🔵310Response

🔵312Response

⚪1Response

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

Authorization

Get Available Banks