Skip to main content
POST
Create cardholder

Authorizations

Authorization
string
header
required

Your API key from Console → Settings → Key & Access, sent as Authorization: Bearer ncl_....

Body

multipart/form-data
email
string
required

Email

Example:

"767665454@qq.com"

firstName
string
required

Last name

Example:

"Edward George"

lastName
string
required

First name

Example:

"Mitchell"

phone
string
required

Phone number

Example:

"18696941327"

phoneCode
string
required

Phone country code

Example:

"86"

binId
string
required

BIN ID

Example:

"473"

businessMode
string
required

Business mode (B2B/B2C). B2C mode requires the identity document fields.

Example:

"B2C"

idType
string
required

passport: Passport

Example:

"passport"

idFrontAttachmentKey
string
required

Front of ID document (from Upload image)

Example:

"1f13408a-46f6-6a7a-aafa-8266772a93c3"

certId
string
required

ID number

Example:

"554450184"

certCountryCode
string
required

ID document country code (ISO 3166-1 alpha-2)

Example:

"CN"

selfieAttachmentKey
string

Selfie, required when the BIN uses advanced verification (from Upload image)

Example:

"1f1487fb-bedf-6442-8508-4ec3212e74cb"

Response

200 - application/json

Success

code
integer
required
msg
string
required
data
object
required