Skip to main content

Audience:

DevelopersOperators

Virtual card statuses

The lifecycle of a virtual card, from consent to cancelation. These statuses also represent the status of the Swan card contract. For the model behind the flow, refer to virtual cards.

Statuses

Virtual card statusExplanation
ConsentPendingVirtual card was added and is waiting for the cardholder's consent.

Next steps:
  • If consent is refused or fails, the status moves directly to Canceled.
  • Otherwise, the status moves to Processing.
ProcessingConsent has been received and the card is being prepared. This status only applies when adding multiple virtual cards (addCards mutation).

Next steps:
  • After the card is ready, the status moves to Enabled.
  • If the card is canceled before it's ready, the status moves to Canceling.
EnabledVirtual card is available for use.

Next steps:
  • If the card is canceled, the status moves to Canceling.
CancelingCard is in the process of being canceled.

Next steps: Card is Canceled. After a card is assigned the Canceling status, the process can't be reversed.
CanceledCard is canceled, no longer available for use, and can't be re-enabled.