Register Customer

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, DL.

• occupation must be one of the supported occupation codes: OCC1 through OCC11.

Corridor-specific profile notes:

• Peru (PE): store occupation, email, phone, and gender (MALE or FEMALE) before decode.
• Vietnam (VN): nationality (ISO 3166-1 alpha-2) is required. It is checked when the payer’s KYC record is first created, i.e. their first VN payout; backfill existing payers with updateCustomer.
• LATAM corridors (AR, BR, PE, BO, CO): name_first, name_last, ic_number, ic_country required for lock/compliance.
• Use checkCustomer.allowed to verify corridor eligibility before decode.