Physical and digital cards
The information on this page is relevant only for API version 2024-03-31 and later. For older API versions, see Physical and digital cards.
Learn how to create physical personalized cards and add personalized cards (physical/virtual) to a digital wallet.
Physical cards
You can opt for a physical card when creating personalized cards (if applicable for your region). Physical cards will be delivered to the postal address specified by you. You will also need to activate them to be able to transact on the card.
If you want to issue a physical card, provide the following fields in Create a card API request in addition to the required fields for a personalized commercial card or a consumer card.
form_factor: Set this toPHYSICAL.activate_on_issue: Set this parameter totrueto activate the physical card upon creation. This will allow the cardholder to use the card as soon as it’s delivered to their postal address.postal_address.*: Address for physical card delivery. If you do not specify an address via this object, the card will be issued to the cardholder'spostal_addressas set in Create a cardholder API. If a postal address is unavailable then the cardholder's address fromindividual.addresswill be used instead.
Activate a physical card
Only physical cards require activation because virtual cards are automatically activated by default. With physical cards, you can choose to activate them by setting active_on_issue to true while creating the card in Create a card API request. This will allow the card to be active upon delivery to the cardholder’s postal address. If you wish to defer the activation, you can do it using Activate a card API request.
Digital cards
Cards (PHYSICAL or VIRTUAL) issued to individuals can be added to a digital wallet, for example, Google Pay, Apple Pay if supported in your region. See FAQ for more information.