Interlace
APl Definitions

Create Cardholder

post
https://api-sandbox.interlace.money/open-api/v3/cardholders
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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

BIN-Specific Card Issuance Requirements

Different BIN groups have different requirements for card issuance. Please ensure that the cardholder information meets the requirements of your intended BIN.

FieldBB BINBZ BINIQ BIN
Cardholder NameMax. 24Max. 24Max. 24
Phone NumberN/AN/A✓
Email✓✓✓
Date of Birth (DOB)N/A✓N/A
StateMax. 30Max. 603–254
CityMax. 30Max. 603–254
Address Line 1Max. 48Max. 60Max. 254
Address Line 2Max. 48Max. 60Max. 254

Notes:

  • Cardholder Name refers to the combined length of firstName, a space, and lastName.
  • ✓ indicates that the field is used for card issuance under the corresponding BIN.
  • All required fields must still be provided when creating a cardholder, even if they are not used for card issuance under the selected BIN.

Important Notice

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.

string
required

The Id of the bin.

uuid
required

The UUID of the Account.

uuid

Optional. Required for MoR mode clients.

string
required
Defaults to CORPORATE_MANAGED

"CORPORATE_MANAGED"

string
required

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

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.

string
enum
required

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

Allowed:
string

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

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.

string

Unique identifier for referencing the associated request or resource.

string
required

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

string

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

string
required

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

string
required
length ≤ 15

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

string
required
length ≤ 3

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

string

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

address
object
required

User’s address.

Responses

Updated about 21 hours ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 21 hours ago

Did this page help you?