Converting a Card from Virtual to Physical

You can create both physical and virtual cards. The type of card created can be seen in the CardType attribute of the card object. For more information see Creating a Card.

You can convert a virtual card to a physical card at any time via an API call.

📘

Note

The convert virtual card to physical option must be configured at the time of your card program setup. For details, contact your Implementation Manager.

When converted, the new physical card will have the same Primary Account Number (PAN) as the virtual card. The cardholder can continue to use their existing virtual card until the cardholder has received and activated their physical card.

Activating a Physical Card

Where a virtual card has been activated, the physical card will also be active in transit. We recommend you enforce virtual only usage until the cardholder has received the card. You also need to activate the card to ensure GPS has the updated card record data (where CVV2 and expiry date differ to the virtual card).

Converting a Card from a Virtual to Physical

Step 1: Identify the card's public token

Before converting a card, identify the corresponding public token in the API Call. This is returned in the response to creating a card.

Step 2: Convert the Card

When you have the public token, convert the card using the Convert Card endpoint.

👍

API Explorer

See the Convert card endpoint.

The API triggers the inclusion of the card in the next XML card manufacturer file for your programme.
As part of the conversion to a physical card, a new expiry date and CVV2 will be generated if the conversion and production of the XML card file falls in a different calendar month to the virtual card creation.

A successful response will return a 200 code along with the updated CardType.
Following successful conversion, replacement or renewal, cards are generated as physical card records.

❗️

Note

Currently GPS does not support a card conversion from a Physical Card Type to a Virtual Card type.