Authorization
default A public key (pk./pk_test.) is accepted on /payments, /customers, /links, /invoices and the catalogue reads (/channels, /providers, /countries, /currencies); anything that moves money out, reads the balance or manages the account answers 406 to it. It is an identifier, never an authorization. Use a secret key (sk./sk_test.) for sensitive operations (transfers, refunds, balance), or a restricted key (rk./rk_test.) scoped to specific permissions. The _test. variant of any key selects the sandbox environment, there is no separate sandbox URL. Never expose your secret key in client-side code.
In: header
Header Parameters
Your key for this request, 1 to 128 characters of letters, digits and `. _ : -`. The same request sent again with the same key returns the first answer instead of doing the work twice. See [Idempotency](/api/idempotency).
Request Body
application/json
Profile type: `individual` (default) or `business`.
"individual""business"Email address. Required if `phone` is not provided.
Phone number. Required if `email` is not provided.
Two-letter country code the phone number is read in when it is written without its international prefix.
Full name. `first_name` and `last_name` are refused: send the full name here.
Accepted for older integrations: copied into `business_name` when that one is not sent.
Refused: send the full name in `name`.
Refused: send the full name in `name`.
Individuals only: the date of birth, `YYYY-MM-DD`, before today.
Individuals only.
"male""female""other"Businesses only: the registered name. Required when `type` is `business`.
Businesses only: the legal form or line of business, as you record it.
Businesses only: the trade register number.
Businesses only: a tax number kept on the profile. The tax ids Tax checks are added with `POST /customers/{id}/tax_ids`.
Businesses only: who signs for the business.
Businesses only: their title.
Your description of the customer, up to 1 000 characters.
Your internal notes.
Preferred currency, ISO 4217.
The primary shipping address.
Two-letter country code.
City.
Street and number.
State or region.
Postal code, where the country has them.
Building, floor or landmark.
The primary billing address, with the same fields as `address`.
Two-letter country code.
City.
Street and number.
State or region.
Postal code, where the country has them.
Building, floor or landmark.
The customer's language, `fr` or `en`: invoices sent to them are written in it.
ISO 4217 codes.
Locales such as `fr` or `en`.
A group name of your own, to filter the list with `customer_group`.
Your labels, up to 50 characters each.
Free-form key-value data.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://api.wajub.com/customers" \ -H "Idempotency-Key: customer-amina-diallo" \ -H "Content-Type: application/json" \ -d '{}'{ "code": 200, "status": "OK", "message": "Customer already exists for this merchant", "customer": { "id": "cus_Qe7Tb2Wn5Lr9Xc4Mv8Hk1Zs3", "email": "amina@example.com", "name": "Amina Diallo", "status": "active" }}OK