Troubleshooting and SDK errors (Push Provisioning)
This page covers errors from the Push ProvisioningPush Provisioning A method that allows cardholders to add their card to a digital wallet (such as Apple Pay or Google Pay) directly from your app. The card details are securely tokenized and sent to the wallet provider, streamlining the process and enhancing the user experience compared to manual provisioning. This feature is currently in beta. SDK, which reports errors through WPPError, an error type returned from the SDK's provisioning operations.
WPPError
WPPError contains the following properties:
| Property | Type | Description |
|---|---|---|
description | String | A description providing further details of how the error occurred. |
reason | String | A description of the underlying reason for the error. More in depth than the description. |
domain | WeavrProvisioningErrorDomain | A domain of the error, providing an approximate category of where the error occurred. |
underlyingErrorCode | Int? | The error code that our SDK received from the platform. |
errorCode | WeavrProvisioningErrorCode | The error code as defined by our SDK. |
Push provisioning error codes
The enum WeavrProvisioningErrorCode outlines a series of error codes that the SDK can surface when something goes wrong. As per the following table:
| Error Code | Description | Integer Code |
|---|---|---|
cardNotEligibleForProvisioning | The card is not eligible for provisioning. | 1003 |
cantFindProviderToUse | Couldn't find the provider to use. This can occur when there's a problem obtaining the provider from the API, e.g. a client error or server error. | 1004 |
emptyEntries | No card entries provided by the user. | 1005 |
userCancelled | The user canceled the flow. | 1006 |
unauthorized | The token is not present or is rejected during provisioning. | 2002 |
missingCardId | The card Id is empty. | 2003 |
missingCardLastFourDigits | The last four digits of the card provided is empty. | 2005 |
missingCardholderName | The card holder name of the card provided is empty. | 2006 |
missingCardDescription | The card description of the card provided is empty. | 2007 |
cantBeAddedToAppleWallet | Couldn't add the card to Apple Wallet. | 3001 |
cantFindViewController | Couldn't find the top most view controller to display the provisioning view controllers. | 5001 |
cantObtainPaymentPassRequestConfiguration | The payment pass request configuration needed by Apple Wallet to provision the card couldn't be created. | 5002 |
cantCreateProvisioningExtensionPaymentPassEntry | The SDK couldn't create the extension payment pass entry needed by Apple Wallet. | 5003 |
cantCreateProvisioningExtensionPaymentPassRequest | The SDK couldn't create the payment pass request to add the card selected by the user to Apple Wallet. | 5004 |
unknown | An unknown error occurred. | -1 |