Issue virtual card

Issues a new virtual card and assigns it to an existing cardholder. The cardholder to whom the card is to be assigned must first be created using the create a cardholder endpoint, and the cardholder's resultant cardholderId should be used in the path of this endpoint.

It's only possible to assign cards using this endpoint to cardholders whose status is 1 (approved), having successfully completed the necessary compliance process.

When successful, this endpoint automatically generates and assigns the cardId and the card's connected account, which is used for inbound transaction processing and credit settlements to the card, and to systematically segregate and manage pending and held balances associated with the card.

The card's 16-digit primary account number (PAN), card verification value/code (CVV/CVC), and expiry date will also be generated and stored against the cardId at this time, which sensitive data can only be exposed by this endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

A cardholder's unique ID.

Body Params
string

A localized system alias for a card, intended for the cardholder's convenience to distinguish between cards and possible users of those cards.

string
required
length between 1 and 26

Cardholder's preferred name as it relates to this virtual card.

integer

An optional maximum card transaction limit, specific to this card. Can't be greater than the transactionLimit of the cardholder. In the absence of a card-level transactionLimit, the cardholder's transactionLimit (if any) is inherited by default. This parameter is currency- and decimal-implied (e.g. a value of 1000 would represent $10.00 in a U.S. dollar-denominated card program).

Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json