Sign in

v1

latestOpenAPI 3.0.02026-08-04620256.0 KB
Card

Create Card

post/cards

Headers

Accept-Versionstring required

Specifies the API version to use for this request.

Request body

cardType'Virtual' | 'Physical' required

Specifies the type of card to create. Possible values:

physical: Select if you plan to use this card to create a physical form later.

virtual: Select if the card will remain digital-only.

Note: Selecting physical does not immediately produce a physical card; it must be requested separately via the shipping endpoint. Once set to virtual, the card type cannot be changed to physical. This choice is final and determines future options.

spendLimitnumber float

Sets the maximum spending limit for this card at the time of creation by allocating funds from the availableToAllocate amount in the master account balance.

Note: Only relevant for clients using the standard authorization model. Clients in this model must use spendLimit to define and monitor each card’s maximum spending capacity.

customerType'Business' | 'Consumer' required

Specifies whether the cardholder is an individual or a business. Possible values:

Business: For corporate customers, aligned with Commercial BIN products.

Consumer : For personal customers, aligned with Retail BIN products.

expiryDatestring date nullable

Specifies the expiry date of the card in the format YYYY-MM-DD. This must be at least 1 month from the date of creation. If not specified, the expiry date defaults to 3 years from the creation date.

preferredCardNamestring required

The name to be printed on the physical card, displayed in uppercase. Allowed characters: letters (A-Z, a-z), digits (0-9), non-English letters (äöüÄÖÜ), space, and / - ^ . apostrophe and right parenthesis.

secondaryCardNamestring

The name to be printed on the physical card, displayed in uppercase. Unsupported characters: ;:!?<>~\%^@{}|[]”_.

Note: If you wish to print a physical card with the secondaryCardName, please communicate with your relationship manager. This is an additional feature that must be activated during the card design approval process.

cardDesignstring uuid

The ID of the card design artwork approved by Visa. You can retrieve this ID using the GET /card-design/ endpoint.

Example request

{
  "kyc": {
    "dob": "1990-08-08",
    "residentialAddress": {
      "country": "HKG"
    }
  },
  "expiryDate": "2025-08-08"
}

Response

Successfully created a card

idstring required