Register Customer

View as Markdown
Registers or upserts a customer sender profile for the authenticated account. **Authentication:** - **REQUIRED**: Basic Auth only (`Authorization: Basic base64(client_id:client_secret)`). **Behavior:** 1. Validates required sender fields (flat JSON at root, not nested under `sender`). 2. Creates (201) or updates (200) the registered customer profile under your account. **Response:** - Returns `customer_id`, normalized sender fields, and `created_at` / `updated_at` when available. `customer_id` returned here is required for `decodeQr`, `getQuotation`, and `executePayout`. **Field code references:** - `ic_type` must be one of the supported identification document type codes: `NIC`, `PP`, `WEP`. - `occupation` must be one of the supported occupation codes: `OCC1` through `OCC11`.

Request

This endpoint expects an object.
name_firststringRequired
name_laststringRequired
genderstringRequired
ic_numberstringRequired
ic_typestringRequired
ic_countrystringRequired
occupationstringRequired
country_of_residencestringRequired
phonestringRequired
emailstringRequiredformat: "email"
nationalitystringRequired
dobdateRequired
addressstringRequired
ic_expiry_datedateRequired

Response

Created
customer_idstring
name_firststring
name_laststring
genderstring
ic_numberstring
ic_typestring
ic_countrystring
occupationstring
country_of_residencestring
phonestring
emailstringformat: "email"
nationalitystring
dobdate
addressstring
ic_expiry_datedate
created_atdatetime
updated_atdatetime

Errors

400
Bad Request Error