Errors

SDKCurrentLast updated: August 26th 2021, @ 9:33:35 am


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.

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.

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.
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.