Card status
The enum CardStatus defines the potential states a card can be in. The state of a given card can be retrieved using getCardStatusInWallet.
State machine
The following diagram shows the typical transitions between card states. unknown isn't shown - it's a fallback the SDK returns when it can't determine the current state.
States
| State | Description |
|---|---|
unavailable | The wallet is not available (for example, Google Pay or Apple Pay is turned off or unsupported). |
alreadyAdded | The card is already added to the wallet. You should hide the Add to Wallet button since the card has already been added. |
notAdded | The card is not added to the wallet. |
requiresActivation | The card requires activation. Relaunch the provisioning flow to activate. |
activating | The card is in the process of being activated. Inform user and retry later. |
suspended | The card is suspended in the wallet by the issuer. Direct the user to issuer support. |
deactivated | The card is deactivated in the wallet. Inform user; card cannot be used. |
unknown | Unknown status. Log and show fallback message. |
googlePayError | A Google Pay-specific error occurred. Validate card data and retry. |