PayPal Here SDK errors
SDKDeprecatedLast updated: November 8th 2022, @ 10:41:15 am
Important: PayPal Here is deprecated. PayPal doesn't accept new integrations but continues to support existing integrations.
Merchant initialization
| Number | Domain | Text | Explanation |
|---|---|---|---|
| 1 | Merchant | Failed to load merchant information. | Merchant user information not found in PayPal. |
| 2 | Merchant | Failed to load required merchant information. | Required info not loaded. |
| 3 | Merchant | Merchant not initialized. | Not initialized. |
| 4 | Merchant | Access token or clientId/secret is missing from provided credentials. | Missing credentials. |
| 5 | Merchant | Environment is missing from provided credentials. | Environment not provided. |
| 6 | Merchant | Data required to create the merchant object are missing. | Merchant data not provided. |
| 7 | Merchant | Failed to load required merchant user information. | Required merchant information such as address, country, email, or business name were not found. |
| 8 | Merchant | Failed to load required merchant status information. | Required merchant information such as status, currency code, business category, or payment types were not found. |
| 9 | Merchant | The token is either invalid or missing. | Invalid token. |
| 10 | Merchant | The token data to build the composite token is either invalid or missing. | Token data not provided. |
| 11 | Merchant | Merchant not allow listed to make offline payments. | For more information, see Offline payment to enable offline payments. |
| 12 | Merchant | Online initialize required once before you can initialize offline. | An online merchant initialization is needed on this device prior to proceeding with an offline merchant initialization. |
| 13 | Merchant | Failed to load offline merchant information. | Unable to get the information of the previously successful online merchant initialization. Complete a successful online merchant initialization on this device before proceeding. |
| 14 | Merchant | Failed to reload online merchant information. Did you have an active merchant before switching to offline mode? | This will occur if an offline merchant initialization was done and there's attempt to replay offline transactions. In this scenario, there needs to be an online merchant initialization prior to replaying since the original initialization was offline. |
| 15 | Merchant | merchantInitialized callback is missing. | merchantInitialized callback not provided. |
| 16 | Merchant | The region is not eligible for the web feature. | Web feature not enabled. |
| 17 | Merchant | Merchant not white listed to make QRC payments. | QRC ineligible. |
Card reader connection
| Number | Domain | Text | Explanation |
|---|---|---|---|
| 12 | PaymentDevice | Payment was cancelled. | Payment was cancelled. |
| 18 | PaymentDevice | Card reader connection action was canceled. | User canceled card reader connection prompt. |
| 30 | PaymentDevice | Software update failed. | Firmware update on the card reader failed. Offer the firmware update one more time. |
| 45 | PaymentDevice | Connection was closed. | Card reader disconnect. Check Bluetooth connection, reader power status, and make sure the app is in the foreground to keep connection. |
DeviceError
| Number | Domain | Text | Explanation |
|---|---|---|---|
| 0 | DeviceError | Generic error. | Generic error. |
| 1 | DeviceError | Contactless reader timed out waiting for payment presentation. | Contactless reader timed out waiting for payment presentation. |
| 2 | DeviceError | Contactless payment not allowed on this card. | NFC not allowed. |
| 3 | DeviceError | Try different card. | Try different card. |
| 4 | DeviceError | Must insert presented card. | Must insert presented card. |
| 5 | DeviceError | Must swipe presented card. | Must swipe presented card. |
| 6 | DeviceError | Hardware error. | Hardware error. |
| 7 | DeviceError | Presented card is blocked. | Presented card is blocked. |
| 8 | DeviceError | Payment was declined. Contact issuer. | Contact CardIssuer. |
| 9 | DeviceError | Chip is invalid. | Chip is invalid. |
| 10 | DeviceError | Cannot swipe a chip card. | Cannot swipe a chip card. |
| 11 | DeviceError | Card not in slot. | Smart card not in slot. |
| 12 | DeviceError | Payment was cancelled. | Payment was cancelled. |
| 13 | DeviceError | Contactless payment was aborted by card insert. | Contactless payment was aborted by card insert. |
| 14 | DeviceError | Contactless payment was aborted by card swipe. | Contactless payment was aborted by card swipe. |
| 15 | DeviceError | Bad EMV data. | Bad EMV data. |
| 16 | DeviceError | Device not connected. | Device not connected. |
| 17 | DeviceError | Device cannot accept messages in its current state. | Cannot accept message. |
| 18 | DeviceError | Action was cancelled. | Action was cancelled. |
| 19 | DeviceError | Secure entry failed. | Secure entry failed. |
| 20 | DeviceError | Numeric entry failed. | Numeric entry failed. |
| 21 | DeviceError | Data validation error. | Data validation error. |
| 22 | DeviceError | Received unexpected response. | Received unexpected response. |
| 23 | DeviceError | Received failure response. | Received failure response. |
| 24 | DeviceError | Failed to retrieve expected data. | Failed to retrieve expected data. |
| 25 | DeviceError | Battery Low. | Battery low. |
| 26 | DeviceError | Unable to retrieve the file from the device. | Unable to retrieve the file from the device. |
| 27 | DeviceError | File import failed. | File import failed. |
| 28 | DeviceError | Device initialization failed. | Device initialization failed. |
| 29 | DeviceError | Tip entry failed. | Tip entry failed. |
| 30 | DeviceError | Software Update Failed. | Software update failed. |
| 31 | DeviceError | Device not functional at this moment. | Device not functional at this moment. |
| 32 | DeviceError | Software update is pending. | Software update is pending. |
| 33 | DeviceError | Cancel reading card data. | Cancel reading card data. |
| 34 | DeviceError | Card reader not available for connection. | Card reader not available for connection. |
| 35 | DeviceError | Downloaded firmware file was corrupt. | Downloaded firmware file was corrupt. |
| 36 | DeviceError | Received unexpected request. | Received unexpected request. |
| 37 | DeviceError | Could not complete requested action. | Could not complete requested action. |
| 38 | DeviceError | Received unexpected request. | Received unexpected request. |
| 39 | DeviceError | Blacklisted. | Blacklisted. |
| 40 | DeviceError | Bad Swipe Data. | Bad swipe data. |
| 41 | DeviceError | Signature collection cancelled. | Signature collection cancelled. |
| 42 | DeviceError | User cancelled. | User cancelled. |
| 43 | DeviceError | Signature not presented. | Signature not presented. |
| 44 | DeviceError | Write to device failed. | Write to device failed. |
| 45 | DeviceError | Connection was closed. | Connection was closed. |
| 46 | DeviceError | Invalid card data. | Invalid card data. |
| 47 | DeviceError | Unable to connect. | Unable to connect. |
| 48 | DeviceError | Further action on buyer phone is required. | Further action on buyer phone is required. |
| 49 | DeviceError | Software update is in progress. | Software update is in progress. |
| 50 | DeviceError | Card reader has an active transaction. | Card reader has an active transaction. |
| 51 | DeviceError | Software update canceled. | Software update canceled. |
| 52 | DeviceError | Firmware checksum does not match. | Firmware checksum does not match. |
| 53 | DeviceError | No response received within the timeout duration. | No response received within the timeout duration. |
| 54 | DeviceError | Battery info is not supported. | Battery info is not supported. |
SDK
| Number | Domain | Text | Explanation |
|---|---|---|---|
| 1 | SDK | Action was cancelled by user. | User cancelled. |
| 2 | SDK | Unable to retrieve file from device storage. | File not found. |
| 3 | SDK | The arguments passed are invalid. | Validation error. |
| 4 | SDK | Card reader scanner not initialized. | Card reader scanner not initialized. |
| 5 | SDK | No reader found. | No reader found. |
| 6 | SDK | Bluetooth disabled. | Bluetooth disabled. |
| 7 | SDK | User logout. | User logout. |
| 8 | SDK | Selected reader unavailable. | Selected reader unavailable. |
| 9 | SDK | Multiple card readers associated with the provided ReaderConfiguration. | Multiple readers. |
| 10 | SDK | An ongoing card reader selection can not be interrupted. | Selection in progress. |
| 11 | SDK | Rapid successive calls. | Rapid successive calls. |
| 12 | SDK | A card reader is already connected. | A card reader is already connected. |
| 13 | SDK | Stopping auto connect to start a new scan. | Stopping auto connect to start a new scan. |
Transaction attempt
| Number | Domain | Text | Explanation |
|---|---|---|---|
| 3 | Merchant | Merchant not initialized. | Merchant was not initialized. You need to first initialize the merchant with a valid access token. |
| 7 | PaymentDevice | Presented card was blocked. | The presented EMV card was identified to be blocked. Ask the card holder to contact the issuer. |
| 8 | PaymentDevice | Payment was declined. Contact issuer. | EMV card payment was declined by the payment processor. Ask the card holder to contact the issuer. |
| 9 | PaymentDevice | Invalid Chip card. | Unable to read chip data from the presented card. |
| 25 | PaymentDevice | Device low on battery. | The connect card reader was low on battery. The merchant should connect the card reader to power before taking another transaction. |
| 32 | PaymentDevice | Software update is pending. | The card reader has a pending firmware update that will need to be completed prior to taking additional payments. |
| 33 | PaymentDevice | Card read was canceled. | Attempt to read EMV chip card data was canceled. The user may have pulled the card out or the card was faulty. Recreate a new transaction and start over. |
| 40 | PaymentDevice | Bad swipe data. | The card reader was not able to read the card's track data. |
| 1 | Transaction | Transaction canceled by customer. | Transaction was canceled by the customer by either pressing the cancel button on the app, pulling out the card during payment, or by pressing the X button on the card reader (on card reader models that have a keypad). |
| 2 | Transaction | The transaction was cancelled. | Generic cancel. |
| 3 | Transaction | Cannot continue with specified card. | Card can't continue. |
| 4 | Transaction | No functional devices. | No functional devices. |
| 5 | Transaction | The invoice status is not eligible for the given transaction. | This error can occur if you begin payment on an already paid invoice. |
| 6 | Transaction | The invoice amount was too low. | The grand total of items on the invoice was less than the allowed minimum amount. |
| 7 | Transaction | The invoice amount was too high. | The grand total of items on the invoice was more than the allowed maximum amount. |
| 8 | Transaction | Failed to collect signature. | Failed to collect signature. |
| 9 | Transaction | Cannot swipe chip card. | Cannot swipe chip card. |
| 10 | Transaction | Must swipe the card. | Must swipe the card. |
| 11 | Transaction | The card presented for the refund is not the same one used for the original payment. | Refund card mismatch. |
| 12 | Transaction | Presented card is not of the expected type. | Card type mismatch. |
| 13 | Transaction | Unable to retrieve location information. | Location error. |
| 14 | Transaction | Invoice ID is required to complete this refund. | Missing invoiceID. |
| 15 | Transaction | Transaction number or invoice id is required to complete this refund. | Missing transaction number or invoiceID. |
| 16 | Transaction | Cannot discard the presented card. | Cannot discard card. |
| 17 | Transaction | Multiple Contactless Cards Detected. | Multiple contactless cards detected. |
| 18 | Transaction | Try different interface. | Try different interface. |
| 19 | Transaction | Cannot clear transaction when a payment is in progress. | Cannot invoke the clear() API on a transaction context when the payment is in progress. Allow the payment to proceed to completion or the customer should cancel it from the app UI. |
| 20 | Transaction | The authorization request has failed. | Authorization failed. |
| 21 | Transaction | The capture request has failed | Capture of the authorized transaction failed. See the developer message on the returned error object for more information. |
| 22 | Transaction | Authorization is not possible for this payment mode. | Cannot perform an AUTH transaction for non-card payment types. |
| 23 | Transaction | Unable to retrieve list of authorizations. | Failed to retrieve authorized transactions. |
| 24 | Transaction | Unable to void the authorization | Unable to void the authorized transaction. See the developer message on the returned error object for more information. |
| 25 | Transaction | Current operation not supported. | See the developer message on the returned error object for more information. One possible scenario is that auth/capture is not supported for the merchant country. |
| 26 | Transaction | Validation failed for payment capture. | See the developer message on the returned error object for more information. However, one of the required parameters for the capture call may be either missing or invalid. |
| 27 | Transaction | Validation failed for retrieving list of authorized transactions. | See the developer message on the returned error object for more information. However, one of the required parameters for the authorization retrieval call may be either missing or invalid. |
| 28 | Transaction | Invalid invoice item. | Not allowed to have an invalid item in the invoice item list. |
| 29 | Transaction | Offline Payment Enabled. | Receipts cannot be sent in offline mode. |
| 30 | Transaction | Offline Payment Transaction Limit Reached. | The per transaction amount limit has been reached for offline payments. |
| 31 | Transaction | Offline Payment Total Limit Reached. | The limit for the total amount of offline transactions saved has been reached. |
| 32 | Transaction | Offline Payment Mode is not available for Audio Readers. | The audio jack readers are not available for offline mode. |
| 33 | Transaction | NFC Contactless Limit Reached. | NFC contactless limit reached. |
| 34 | Transaction | Offline Payment Stopped. | Offline payment stopped. |
| 35 | Transaction | Offline Payment key in is not allowed. | Offline payment key in is not allowed. |
| 36 | Transaction | Pay and Vault payment failed. | The payment portion of the pay and vault transaction has failed. Payment and vaulting are run asynchronously, so even though one has failed, the other may not have. |
| 37 | Transaction | Vault failed. | The payment method was unable to be vaulted. |
| 40 | Transaction | Failed due to outage. | transaction failed due to outage. |
| 41 | Transaction | QRC session timed out. | QRC session timed out. |
| 42 | Transaction | QRC polling failed. | QRC polling failed. |
| 43 | Transaction | Cannot clear transaction after QRC transaction. | Cannot clear transaction after QR code is scanned. |
| 44 | Transaction | Failed to get the QRC service provider. | Failed QRC service provider. |
| 45 | Transaction | Failed to generate the QRC URL. | Failed QRC URL generation. |
| 46 | Transaction | Failed QRC. | Failed the QRC payment. |
| 47 | Transaction | Declined the QRC payment. | Declined QRC. |
| 48 | Transaction | Failed to get the QRC referrer(BN) code. | Failed QRC referrer code. |
| 49 | Transaction | Transaction cancelled by merchant. | Transaction cancelled by merchant. |
| 50 | Transaction | Cannot Cancel inflight transaction. | Cannot cancel inflight transaction. |
| 51 | Transaction | Missing digital card redemption information. | Missing digital card redemption information. |
| 52 | Transaction | The card was removed before it was read. | The chip card was removed from the reader before it was read. Initiate a new transaction and inform the card holder to keep the card inserted till the transaction completes. |
| 580022 | Transaction | Transaction declined. | This is a hard decline. Customer will need to use a different card or payment method. |
| 580031 | Retail | Contact issuer. | Contact card issuer. |
| 600075 | Retail | NFC payment declined. | NFC payment declined. |
| 6000164 | Retail | Incorrect online PIN. | Incorrect online PIN. |
| 6000165 | Retail | Online PIN max retry exceeded. | Online PIN max retry exceeded. |
Network request
| Number | Domain | Text | Explanation |
|---|---|---|---|
| 1 | Network | Request failed. | Request failed. |
| -1001 | Network | Network offline. | This error is returned when a network request times out due to a slow network or being in an offline state. |
| -999 | Network | SSL handshake failed. | SSL handshake failed. |
| 2 | Network | Network not allowed in offline mode. | Network not allowed in offline mode. |
| 401 | PayPalRest | Request Not Authorized. | The access token has expired or is not valid and credentials were not provided for the token refresh. If refresh credentials were provided, then the credentials are no longer valid. See the developer message on the returned error object for more information. |
| -1001 | PayPalRest | Network Offline. | This error is returned when a network request times out due to a slow network or being in an offline state. |