Skip to main content
POST
Create Customer

Authorizations

ngnc-sec-key
string
header
default:""
required

Headers

idempotency-key
string
required

A unique key (e.g. UUID) to prevent duplicate customer creation on retries.

Body

application/json
business_name
string
required

Legal name of the customer's business.

business_email
string<email>
required

Business contact email address.

phone_number
string
required

Business phone number including country code.

registered_address
string
required

Registered business address.

registered_country
string
required

ISO 3166-1 alpha-3 country code (e.g. NGA, USA, GBR).

Pattern: ^[A-Z]{3}$
Example:

"NGA"

Response

Customer created successfully.

code
string
Example:

"CRT_SUCCESSFUL"

CustomerID
string

Unique customer ID to pass in onramp/offramp requests.

Example:

"acm123456"

KYB form link for compliance verification.

message
string
Example:

"Customer created."