Create a cardholder

post

https://api-sandbox.interlace.money/open-api/v2/cards/{accountId}/cardholder

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🌟
Important Notice
As required by our banking partner, all cards require user information to be submitted for bank review before issuance.
When you call this Create Cardholder API, the system will automatically submit user information for bank review. The review status will be pushed to your system via webhook notifications.

Card Issuance Tutorials

Mode	Documentation Link
MoR Mode - Business Use	View Docs
MoR Mode - Consumer Use	View Docs
Gateway Mode - Business Use	View Docs
Gateway Mode - Consumer Use	View Docs
Distributor	View Docs

What's Changing?

You may provide an an Occupation Code when submitting KYC/Cardholder applications.

You can find the full list of valid codes here.
For easier selection, you also can refer to this summary list to quickly identify your category

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

Sharing Sumsub Token

If you are using Sumsub for KYC, you can share the Token with Interlace.
For detailed steps, see Sumsub Token Sharing Integration – Operational Guide.

Path Params

accountId

string

required

The UUID of the Account.

Body Params

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

profileId

uuid

required

Required only for MoR mode clients.

cardholderTier

string

required

Defaults to CORPORATE_MANAGED

"CORPORATE_MANAGED"

cardholderRole

string

enum

required

cardholderRole.

Allowed:

cardholderLabel

string

cardholderLabel.

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.

string

required

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

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

nationality

string

required

Nationality. Use a two-letter country code as defined in ISO 3166-1 alpha-2. Example: US

dob

string

required

Date of birth in YYYY-MM-DD format. Example: 1990-01-01

address

object

required

Responses

Important Notice

Card Issuance Tutorials

What's Changing?

Supported ID Types by Country/Region

Sharing Sumsub Token

200OK

400Bad Request