Skip to main content
POST
https://api.business.bumxpress.com
/
customers
curl --request POST \
  --url https://api.business.bumxpress.com/customers \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --data '
{
  "external_ref": "your-internal-id-123",
  "customer_type": "individual",
  "first_name": "Awa",
  "last_name": "Ngu",
  "id_number": "ID123456",
  "id_type": "national_id",
  "email": "awa@example.com",
  "phone": "+237670000000",
  "country_code": "CM",
  "nationality_code": "CM",
  "date_of_birth": "1990-05-15",
  "address_line1": "123 Main Street",
  "city": "Douala",
  "occupation": "Engineer",
  "source_of_funds": "salary"
}
'
{
  "customer_type": "individual",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "active",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "external_ref": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "business_name": "<string>",
  "id_number": "<string>",
  "email": "jsmith@example.com",
  "phone": "+237670000000",
  "country_code": "CM",
  "nationality_code": "CM",
  "date_of_birth": "2023-12-25",
  "address_line1": "<string>",
  "city": "<string>",
  "occupation": "<string>",
  "source_of_funds": "<string>",
  "_meta": {
    "idempotency_key": "<string>",
    "idempotency_replayed": true
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "quote_id is required"
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "quote_id is required"
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "quote_id is required"
  }
}
Create a customer before starting payment flows so quotes, payments, transfers, and webhook events can be reconciled to your internal records.

Authorizations

​
X-Api-Key
string
header
required

Public API key from the merchant dashboard.

​
X-Api-Secret
string
header
required

Secret shown once when the API key is created.

Headers

​
Idempotency-Key
string
required

Unique key for this business intent. Reuse only when retrying the same request body.

Body

application/json
​
external_ref
string

Merchant reference, unique per merchant.

​
customer_type
enum<string>
default:individual
Available options:
individual,
retail,
business
​
first_name
string
​
last_name
string
​
business_name
string
​
id_number
string
​
id_type
enum<string>
Available options:
national_id,
passport,
driver_license
​
email
string<email>
​
phone
string
Example:

"+237670000000"

​
country_code
string
Required string length: 2
Example:

"CM"

​
nationality_code
string
Required string length: 2
Example:

"CM"

​
date_of_birth
string<date>
​
address_line1
string
​
city
string
​
occupation
string
​
source_of_funds
string

Response

Customer created.

​
customer_type
enum<string>
default:individual
required
Available options:
individual,
retail,
business
​
id
string<uuid>
required
​
merchant_id
string<uuid>
required
​
kyc_status
enum<string>
required
Available options:
not_started,
pending,
approved,
rejected
​
status
string
required
Example:

"active"

​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
external_ref
string

Merchant reference, unique per merchant.

​
first_name
string
​
last_name
string
​
business_name
string
​
id_number
string
​
id_type
enum<string>
Available options:
national_id,
passport,
driver_license
​
email
string<email>
​
phone
string
Example:

"+237670000000"

​
country_code
string
Required string length: 2
Example:

"CM"

​
nationality_code
string
Required string length: 2
Example:

"CM"

​
date_of_birth
string<date>
​
address_line1
string
​
city
string
​
occupation
string
​
source_of_funds
string
​
_meta
object
Last modified on July 8, 2026