Errors

Merchant initialization

Number Domain Text Explanation
1 Merchant Failed to load merchant information Merchant user information not found in PayPal.
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.
11 Merchant Merchant not whitelisted to make offline payments. Please follow the instructions here 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. Please 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.

Card reader connection

Number Domain Text Explanation
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.

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.
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.
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).
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.
11 Transaction Refund card mismatch The card presented for the refund is not the same one used for the original payment.
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.
21 Transaction Capture 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 Failed to retrieve authorized transactions Unable to retrieve the list of authorized transactions.
24 Transaction Void transaction failed 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 Capture validation failed 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 Auth retrieval validation failed 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.

Network request

Number Domain Text Explanation
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 There is no internet connectivity.
Feedback