Card Lifecycle

Card States

Virtual cards are activated and ready to use by default. When the card is either expired or cancelled by the user it will transition to the cancelled state.

Card Lifecycle
Card Lifecycle Flow Diagram

State Transitions

Create a card

Call the Create Card operation to request Immersve generate a card, returning an ID. It is ready to use when a call to Get Card with the card ID returns a payload with status "active".

Block a card

Calling the Freeze Card endpoint will temporarily block a card. While a card is blocked it cannot be used to perform transactions.

Unblock a card

To remove a block the Unfreeze Card endpoint is called. This returns the card to an active status allowing it to once again be used to perform transactions.

Cancel a card

Should a cardholder change their mind prior to presenting the card to a merchant, cancel the card by calling the Cancel Card endpoint.