Card status
The enum CardStatus defines the potential states a card can be in. The state of a given card can be retrieved using the method WPPComponents.getCardStatus.
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
| Status | Meaning | Recommended action |
|---|---|---|
UNAVAILABLE | Google Pay turned off or unsupported on the user's device | Prompt the user to install or enable Google Pay. |
NOT_PROVISIONED | Card eligible but not yet provisioned | Offer "Add to Google Wallet". |
PROVISIONED | Card active | Offer "Set default NFC payment" if desired. |
PENDING | Activation in progress | Show a pending state and poll getCardStatus for updates. |
NEEDS_IDENTITY_VERIFICATION | KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. incomplete | Relaunch the provisioning flow to finish verification. |
SUSPENDED | Temporarily blocked | Direct the user to contact issuer support. |
UNKNOWN | Unrecognized state | Log the state and show a fallback message. |