Issue a new card

post

https://your_connector_url/customers/{customerId}/cards

Creates and issues a new physical or virtual card for a customer. This endpoint handles both debit and credit cards, supports custom card designs, delivery addresses, and limit configurations. The card will be created in the banking provider system.

Business Context: Used when issuing a card to a user or creating a company card. The card details returned are displayed in the frontend application. Supports multi-company scenarios where different merchants can issue cards.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

customerId

string

required

Unique identifier of the customer (top-level entity)

Body Params

Card issuance request containing all necessary information to create a new card

Base limit fields that can be set on cards. This extends AdditionalParams, allowing additional custom limit properties.

cardLimitDaily

int32

Daily spending limit - STANDARD PROPERTY

cardLimitMonthly

int32

Monthly spending limit - STANDARD PROPERTY

cardLimitTransaction

number

Per-transaction spending limit - STANDARD PROPERTY

lifetimeSpendLimit

double

Total lifetime spending limit - STANDARD PROPERTY

cardMinLimitTransaction

double

Minimum transaction limit - STANDARD PROPERTY

cardMinLimitTransactionForPhysicalBusiness

double

Minimum transaction limit for physical business cards - STANDARD PROPERTY

accountId

string

required

ID of the account to which the card will be linked - REQUIRED

fundingType

string

enum

Defaults to DEBIT

Funding type of the card. Defaults to DEBIT when omitted. Extensible; current supported values are DEBIT and CREDIT.

Allowed:

companyId

string

Company/merchant identifier

userId

string

User to whom the card will be issued

physical

boolean

Defaults to false

Whether to issue a physical card (true) or virtual card (false)

nameOnCard

string

length ≤ 21

Cardholder name to be printed on the card (max 21 characters)

cardDeliveryName

string

Name for card delivery (required for physical cards)

cardDeliveryAddress

object

cardBillingAddress

object

dateOfBirth

int64

Cardholder date of birth (epoch timestamp)

phone

object

string

Cardholder email address

firstName

string

Cardholder first name

lastName

string

Cardholder last name

cardProgramme

string

Card programme/tier (e.g., STANDARD, PREMIUM)

cardDesign

string

Card design template identifier

currency

string

Card currency (ISO 4217)

readOnly

boolean

Whether the card should be read-only (for direct debit)

billingAccountId

string

Billing account ID for credit cards

Responses

200Card issued successfully

400Bad request - Invalid input parameters

404Resource not found

500Internal server error