Create Cardholder

post

https://api-sandbox.uqpaytech.com/api/v1/issuing/cardholders

Creates a new issuing cardholder object that can be issued cards.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

string

required

The cardholder’s email address.

first_name

string

required

The first name of the cardholder. Must be between 1 and 40 characters, containing only alphabetic characters and spaces. Spaces are not allowed at the beginning or end of the name.

last_name

string

required

The last name of the cardholder. Must be between 1 and 40 characters, containing only alphabetic characters and spaces. Spaces are not allowed at the beginning or end of the name.

date_of_birth

string

The cardholder's birth date with yyyy-mm-dd format.

country_code

string

required

length ≤ 2

Two-letter country code ISO 3166-1 alpha-2.

phone_number

string

required

The cardholder’s phone number.

See Phone Number Validation Rules For Cardholder for length validation details.

gender

string

enum

The cardholder's gender.

MALE - Male.
FEMALE - Female.

Allowed:

nationality

string

length between 2 and 2

The cardholder's nationality in ISO 3166-1 alpha-2 format. Required for STANDARD and ENHANCED KYC levels.

residential_address

object

The cardholder’s residential address.

identity

object

The cardholder's identity document information. Required for STANDARD and ENHANCED KYC levels.

kyc_verification

object

KYC verification information. Required for ENHANCED KYC level.

document_type

string

enum

The type of the identification document.

Allowed:

document

string

Base64 encoded identification document string, 2MB limitation.

Headers

x-on-behalf-of

string

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

x-idempotency-key

uuid

required

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Responses

200Cardholder creation successfully.

400Bad Request - The request was unacceptable, often due to missing a required parameter.

401Unauthorized - No valid API key or token provided.