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
Path Parameters
The subaccount `id`.
Request Body
multipart/form-data
The seller's name as the document prints it.
`national_id`, `passport`, `driving_license` or `residence_permit`.
"national_id""passport""driving_license""residence_permit"The document's number, 4 to 64 characters.
The seller's date of birth, `YYYY-MM-DD`.
The document's expiry date, `YYYY-MM-DD`: an expired document is refused.
The document's picture or scan: JPG, PNG or PDF, 10 MB at most, readable (500 pixels on its shorter side).
Response Body
application/json
application/json
application/json
curl -X POST "https://api.wajub.com/accounts/acc_Gt6yU3nE8rM1kS5vX9bQ/identity" \ -F full_name="Ada Mbarga" \ -F document_type="national_id" \ -F document_number="112233445" \ -F birth_date="1990-04-12" \ -F document="string"{ "code": 201, "status": "Created", "message": "Identity document received", "identity": { "status": "pending", "document_type": "national_id", "submitted_at": "2026-11-19T10:00:00+00:00" }}Created