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). Know Your Customer - the identity verification process for consumer customers. This process allows you to securely verify your user's identity. Weavr asks users to submit the information and documentation they need for approval 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. |