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 only 2 wallets
with any currency )

name

string

optional

Wallet name

currency

string

optional

Wallet currency

Example

{
  "sync_code": "C001",
  "name": "Kouern Deav",
  "name_kh": "កឿនដៀវ",
  "phone": "081991210/077881701",
  "email": "deavkouern@gmail.com",
  "wallet": [
    {
      "name": "Kouern Deav's Wallet(KHR)",
      "currency": "KHR"
    },
    {
      "name": "Kouern Deav's Wallet(USD)",
      "currency": "USD"
    }
  ]
}

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": "C001",
  "name": "Kouern Deav",
  "name_kh": "កឿនដៀវ",
  "phone": "081991210/077881701",
  "email": "deavkouern@gmail.com",
  "wallet": [
    {
      "name": "Kouern Deav'\''s Wallet(KHR)",
      "currency": "KHR"
    },
    {
      "name": "Kouern Deav'\''s Wallet(USD)",
      "currency": "USD"
    }
  ]
}'

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

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": {
    "sync_code": "C001",
    "name": "Kouern Deav",
    "name_kh": "កឿនដៀវ",
    "phone": "081991210/077881701",
    "email": "customer@gmail.com",
    "wallet": [
      {
        "name": "Kouern Deav's Wallet(KHR)",
        "currency": "KHR"
      },
      {
        "name": "Kouern Deav's Wallet(USD)",
        "currency": "USD"
      }
    ]
  }
}

Modified at 2025-04-08 07:27:45

Authorization

Get Payment Methods