Create Cardholder

post

https://api-sandbox.interlace.money/open-api/v3/cardholders

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

CaaS Integration Tutorial

A step-by-step guide for setting up card programs, managing cardholders, and issuing cards within the CaaS workflow.

Occupation Code

Valid occupation codes for the occupation field.
You can find the full list of valid codes here.

Supported ID Types by Country/Region

Mainland China
- CN-RIC
- PASSPORT
Hong Kong
- HK-HKID
- PASSPORT
United States
- DLN
- PASSPORT
- Government-Issued ID Card
Other Countries/Regions
- DLN
- PASSPORT
- Government-Issued ID Card
- EU Residency Permit
- UAE Residency Permit

Important Notice

To ensure data consistency and global compliance, all phone number fields in Cardholder and KYC-related APIs are validated and parsed using Google’s official libphonenumber library.

The submitted phone number (countryCode + phoneNumber) will be validated according to the library’s rules, including but not limited to:

• Validity of the country/region calling code
• Correctness of the phone number format
• Whether the number can be parsed as a valid international phone number

All phone numbers are formatted and normalized through this library before entering the system, ensuring reliability for authentication, notifications, and risk-control processes.

Body Params

Corporate-managed card used for internal business expenses, such as advertising, SaaS subscriptions, travel, and logistics.

binId

string

required

The Id of the bin.

accountId

uuid

required

The UUID of the Account.

profileId

uuid

Optional. Required for MoR mode clients.

cardholderTier

string

required

Defaults to CORPORATE_MANAGED

"CORPORATE_MANAGED"

firstName

string

required

User’s first name. Only English alphabet letters (A–Z, a–z) are allowed. Example: John

lastName

string

required

User’s last name. Only English alphabet letters (A–Z, a–z) are allowed. Example: Smith

Note: The combined length of firstName and lastName (with space) must be ≤ 23 characters.

cardholderRole

string

enum

required

Role of the cardholder within the organization, used to distinguish different operational responsibilities.

Allowed:

cardholderLabel

string

Custom label assigned to the cardholder for internal management and identification. Example: Marketing Ad

nameAbbreviation

string

NameAbbreviation is used as an alternative display name when the full name exceeds length constraints or when a shorter format is needed for presentation.

referenceId

string

Unique identifier for referencing the associated request or resource.

string

required

User’s email address. Example: [email protected]

nationality

string

Two-letter country code of nationality, as defined in ISO 3166-1 alpha-2. Example: US. Required for BB BINs.

dob

string

required

Date of birth in YYYY-MM-DD format. Example: 1990-01-01. Required for BB BINs.

phoneNumber

string

required

length ≤ 15

Phone number without the country code, length ≤ 15. Example: 13800138000

phoneCountryCode

string

required

length ≤ 3

The international dialing code of the cardholder's mobile phone, numbers only, no "+", length ≤ 3. Example: 86

ssn

string

9-digit SSN if country is US. Example: 123456789

address

object

required

User’s address.

Responses

CaaS Integration Tutorial

Occupation Code

Supported ID Types by Country/Region

Important Notice

200OK

400Bad Request