Skip to main content
POST
/
otc
/
business_customer
Create Customer
curl --request POST \
  --url https://api.linkio.world/otc/business_customer \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --header 'ngnc-sec-key: <api-key>' \
  --data '
{
  "business_name": "<string>",
  "business_email": "jsmith@example.com",
  "phone_number": "<string>",
  "registered_address": "<string>",
  "registered_country": "NGA"
}
'
{
  "code": "CRT_SUCCESSFUL",
  "CustomerID": "acm123456",
  "KYB_Link": "<string>",
  "message": "Customer created."
}

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_Link
string<uri>

KYB form link for compliance verification.

​
message
string
Example:

"Customer created."