Skip to main content
POST
Register Cardholder Customer
Register a new cardholder customer profile and submit identity verification (KYC). Upon successful verification, use the returned customerId to issue virtual cards via POST /cards.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
firstName
string
required
Example:

"John"

lastName
string
required
Example:

"Doe"

email
string
required
Example:

"john.doe@example.com"

phoneNumber
string
required
Example:

"08012345678"

dialCode
string
default:+234
Example:

"+234"

dateOfBirth
string
Example:

"1995-05-15"

idType
enum<string>
Available options:
national_id,
passport,
drivers_license
Example:

"national_id"

idNumber
string
Example:

"12345678901"

line1
string
Example:

"15 Marina Street"

city
string
Example:

"Lagos"

state
string
Example:

"Lagos State"

postalCode
string
Example:

"100001"

country
string
default:NGA
Example:

"NGA"

Response

Customer registered and approved successfully