Skip to main content

Card Lifecycle

Card States​

Short-lived 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.

stateDiagram-v2     [*]--> Created: Create Created-->Active: Provisioning     Active-->Cancelled : Cancel card, Expired     Cancelled --> [*]

State Transitions​

Create a card​

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

Cancel a card​

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