curl --request POST \
--url https://api.business.saapay.cm/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",
"kyc_status": "not_started",
"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>",
"id_type": "national_id",
"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"
}
}Customers
Create customer
Create an individual, retail, or business customer.
POST
https://api.business.saapay.cm
/
customers
curl --request POST \
--url https://api.business.saapay.cm/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",
"kyc_status": "not_started",
"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>",
"id_type": "national_id",
"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
Headers
Body
application/json
Response
Customer created.
Last modified on September 22, 2026