Create Customer

POST

https://merchantapi-demo.bill24.io/customer/create

This endpoint use to create customer Profile at bill24 side

If you choose to add wallets while creating a customer. The name and currency fields in the wallet will become required.

Request

Header Params

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {token get from endpoint (Authorization)}

Body Params application/json

sync_code

string

required

Identity code for customer at Biller side

name

string

required

Customer's name

name_kh

string

optional

Customer's name

phone

string

optional

Customer's phone

string

optional

Customer's email

wallet

array [object {2}]

optional

Optional if you want to create wallet along when create
customer you can pass this information.(can create wallet with KHR currency )

name

string

optional

Wallet name

currency

string

optional

Wallet currency

Example

{
    "sync_code": "C0001",
    "name": "Customer A",
    "name_kh": "អតិថិជន ក",
    "phone": "010 795 790",
    "email": "Sample@gmail.com",
    "wallet": [
        {
            "name": "Customer A Wallet",
            "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/customer/create' \
--header 'Content-Type:  application/json' \
--header 'Authorization:  Bearer {token get from endpoint (Authorization)}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sync_code": "C0001",
    "name": "Customer A",
    "name_kh": "អតិថិជន ក",
    "phone": "010 795 790",
    "email": "Sample@gmail.com",
    "wallet": [
        {
            "name": "Customer A Wallet",
            "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

string

optional

Id of customer

sync_code

string

optional

Identity code for that customer at biller side

name

string

optional

Customer's name

name_kh

string

optional

Customer's name in khmer

phone

string

optional

Customer's phone

string

optional

Customer's email

wallet

array [object {2}]

optional

Example

{
    "code": "000",
    "message": "Success",
    "message_kh": "ជោគជ័យ",
    "data": {
        "id": "5a736f6c-df75-4598-a1ed-bc1850482a0d",
        "sync_code": "C0001",
        "name": "Customer A",
        "name_kh": "អតិថិជន ក",
        "phone": "010 795 790",
        "email": "Sample@gmail.com",
        "wallet": [
            {
                "name": "Customer A Wallet",
                "currency": "KHR"
            }
        ]
    }
}

Modified at 2025-07-08 17:19:55

Delete Customer

Get Payment Methods