PayPal Error Codes
PayPal does not return any error codes, they only return error messages. Here is a comprehensive list of error messages (for withdrawals) returned from PayPal as found on their developer site:
https://developer.paypal.com/docs/api/orders/v2/#errors
| PayPal Error Message | Paypal Error Description | Paysafe HTTP Status Code | Paysafe Error Code | Paysafe Error Message | Paysafe Error Details | Paysafe Status | Paysafe Status Reason |
|---|---|---|---|---|---|---|---|
| ACTION_DOES_NOT_MATCH_INTENT | Order was created with an intent to CAPTURE. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Change to something like Merchant configuration is incorrect. Verify setup in Netbanx | FAILED | N/A |
| AUTH_CAPTURE_NOT_ENABLED | The requested action could not be performed, semantically incorrect, or failed business validation. The authorization and capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. The authorization and capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account. Change to something like Ensure recipient of account is correct | FAILED | N/A |
| AGREEMENT_ALREADY_CANCELLED | The requested agreement is already cancelled. The specified agreement ID cannot be used for this transaction. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested agreement is already cancelled. The specified agreement ID cannot be used for this transaction. "Agreement" likely means nothing to integrator. Change to something like Transaction already cancelled. | FAILED | N/A |
| AMOUNT_CANNOT_BE_SPECIFIED | The requested action could not be performed, semantically incorrect, or failed business validation. An authorization amount can only be specified if an order was saved by calling /v2/checkout/orders/{order_id}/save. Save the order and try again. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. An authorization amount can only be specified if an order was saved by calling /v2/checkout/orders/{order_id}/save. | FAILED | N/A |
| AMOUNT_MISMATCH | The amount specified does not match the breakdown. The amount must equal item_total + tax_total + shipping + handling + insurance - shipping_discount - discount. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The amount specified does not match the breakdown. The amount must equal item_total + tax_total + shipping + handling + insurance - shipping_discount - discount. | ERROR | N/A |
| AUTHENTICATION_FAILURE | Authentication failed due to missing authorization header, or invalid authentication credentials. The account validations failed for the user. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Authentication failed due to missing authorization header, or invalid authentication credentials. The account validations failed for the user. | ERROR | N/A |
| AUTHORIZATION_AMOUNT_EXCEEDED | The requested action could not be performed, semantically incorrect, or failed business validation. The specified authorization amount exceeded the allowable limit. Specify a different amount and try the request again. Alternately, contact Customer Support to increase your limits. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. The specified authorization amount exceeded the allowable limit. Specify a different amount and try the request again. | FAILED | N/A |
| AUTHORIZATION_CURRENCY_MISMATCH | The requested action could not be performed, semantically incorrect, or failed business validation. The currency of the authorization must match the currency of the order that the payer created and approved. Check the currency_code and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. The currency of the authorization must match the currency of the order that the payer created and approved. Check the currency_code and try the request again. | FAILED | N/A |
| BILLING_AGREEMENT_NOT_FOUND | The requested Billing Agreement token was not found. Verify the token and try the request again. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested Billing Agreement token was not found. Verify the token and try the request again. | FAILED | N/A |
| CANNOT_BE_NEGATIVE | Must be greater than or equal to zero. Try the request again with a different value. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Must be greater than or equal to zero. Try the request again with a different value. | FAILED | N/A |
| CANNOT_BE_ZERO_OR_NEGATIVE | Must be greater than zero. Try the request again with a different value. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Must be greater than zero. Try the request again with a different value. | ERROR | N/A |
| CARD_TYPE_NOT_SUPPORTED | The requested action could not be performed, semantically incorrect, or failed business validation. Processing of this card type is not supported. Use another card type. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. Processing of this card type is not supported. Use another card type. | FAILED | N/A |
| INVALID_SECURITY_CODE_LENGTH | The requested action could not be performed, semantically incorrect, or failed business validation. The security_code length is invalid for the specified card type. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. The security_code length is invalid for the specified card type. | FAILED | N/A |
| CITY_REQUIRED | The specified country requires a city (address.admin_area_2). Specify a city and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The specified country requires a city (address.admin_area_2). Specify a city and try the request again. | ERROR | N/A |
| COMPLIANCE_VIOLATION | Transaction cannot be processed due to a possible compliance violation. To get more information about the transaction, call Customer Support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Transaction cannot be processed due to a possible compliance violation. | FAILED | N/A |
| CONSENT_NEEDED | Authorization failed due to insufficient permissions. To continue with this transaction, the payer must provide consent. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Authorization failed due to insufficient permissions. To continue with this transaction, the payer must provide consent. | FAILED | N/A |
| CURRENCY_NOT_SUPPORTED_FOR_CARD_TYPE | The requested action could not be performed, semantically incorrect, or failed business validation. The currency code is not supported for direct card payments for this card type. See Currency Codes for list of supported currency codes. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. The currency code is not supported for direct card payments for this card type. | ERROR | N/A |
| CURRENCY_NOT_SUPPORTED_FOR_COUNTRY | The requested action could not be performed, semantically incorrect, or failed business validation. Currency code not supported for direct card payments in this country. Please refer https://developer.paypal.com/docs/integration/direct/rest/currency-codes/ for list of supported currency codes. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. Currency code not supported for direct card payments in this country. | ERROR | N/A |
| DECIMAL_PRECISION | The value of the field should not be more than two decimal places. Verify the number of decimal places and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The value of the field should not be more than two decimal places. Verify the number of decimal places and try the request again. | ERROR | N/A |
| DOMESTIC_TRANSACTION_REQUIRED | This transaction requires the payee and payer to be resident in the same country. To create this payment, a domestic transaction is required. | 502 | 1001 | External Gateway Error | An external gateway error occurred. This transaction requires the payee and payer to be resident in the same country. To create this payment, a domestic transaction is required. | ERROR | N/A |
| DUPLICATE_INVOICE_ID | Duplicate Invoice ID detected. To avoid a duplicate transaction, verify that the invoice ID is unique for each transaction. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Duplicate Invoice ID detected. To avoid a duplicate transaction, verify that the invoice ID is unique for each transaction. | ERROR | N/A |
| DUPLICATE_REQUEST_ID | The value of PayPal-Request-Id header has already been used. Specify a different value and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The value of PayPal-Request-Id header has already been used. Specify a different value and try the request again. | ERROR | N/A |
| INSTRUMENT_DECLINED | The funding instrument presented was either declined by the processor or bank. The specified funding instrument cannot be used for this payment. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The funding instrument presented was either declined by the processor or bank. The specified funding instrument cannot be used for this payment. | FAILED | N/A |
| INTERNAL_SERVER_ERROR | An internal server error has occurred. Retry the request later. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The funding instrument presented was either declined by the processor or bank. The specified funding instrument cannot be used for this payment. | FAILED | N/A |
| INTERNAL_SERVICE_ERROR | An internal service error has occurred. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The funding instrument presented was either declined by the processor or bank. The specified funding instrument cannot be used for this payment. | FAILED | N/A |
| INVALID_ACCOUNT_STATUS | Account validations failed for the user. To continue with this transaction, the payer must provide consent. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Account validations failed for the user. To continue with this transaction, the payer must provide consent. | FAILED | N/A |
| INVALID_ARRAY_MAX_ITEMS | The number of items in an array parameter is too large. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The number of items in an array parameter is too large. | ERROR | N/A |
| INVALID_ARRAY_MIN_ITEMS | The number of items in an array parameter is too small. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The number of items in an array parameter is too small. | ERROR | N/A |
| INVALID_COUNTRY_CODE | Country code is invalid. For list of supported country codes, see Country and Region Codes. | 502 | 1001 | External Gateway Error | An external gateway error occurred.Country code is invalid. | ERROR | N/A |
| INVALID_CURRENCY_CODE | Currency code is invalid or is not currently supported. For a list of supported currency codes, see Currency Codes. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Currency code is invalid or is not currently supported. | FAILED | N/A |
| INVALID_JSON_POINTER_FORMAT | Path should be a valid JavaScript Object Notation (JSON) Pointer that references a location within the request where the operation is performed. The path is not valid. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Path should be a valid JavaScript Object Notation (JSON) Pointer that references a location within the request where the operation is performed. The path is not valid. | ERROR | N/A |
| INVALID_PARAMETER_SYNTAX | The value of a field does not conform to the expected format. Verify that the pattern is supported and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The value of a field does not conform to the expected format. Verify that the pattern is supported and try the request again. | ERROR | N/A |
| INVALID_PARAMETER_VALUE | The value of a field is invalid. Verify the parameter value and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The value of a field is invalid. Verify the parameter value and try the request again. | ERROR | N/A |
| INVALID_PARAMETER | Cannot be specified as part of the request. Check that the API supports this parameter and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Cannot be specified as part of the request. Check that the API supports this parameter and try the request again. | ERROR | N/A |
| XXXXXX | Order was created with an intent to CAPTURE. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Change to something like Merchant configuration is incorrect. Verify setup in Netbanx | FAILED | N/A |
| INVALID_PAYER_ID | The payer ID is not valid. Verify the payer ID and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The payer ID is not valid. Verify the payer ID and try the request again. | ERROR | N/A |
| INVALID_RESOURCE_ID | Specified resource ID does not exist. Verify the resource ID and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Specified resource ID does not exist. Verify the resource ID and try the request again. | ERROR | N/A |
| INVALID_STRING_LENGTH | The value of a field is either too short or too long. Verify the minimum and maximum values and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The value of a field is either too short or too long. Verify the minimum and maximum values and try the request again. | ERROR | N/A |
| ITEM_TOTAL_MISMATCH | Verify the corresponding values and try the request again. The item total should equal the sum of (unit_amount * quantity) across all items for a purchase_unit. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Verify the corresponding values and try the request again. The item total should equal the sum of (unit_amount * quantity) across all items for a purchase_unit. | ERROR | N/A |
| ITEM_TOTAL_REQUIRED | If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required. The amount.breakdown.item_total value was not found. | 502 | 1001 | External Gateway Error | An external gateway error occurred. If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required. The amount.breakdown.item_total value was not found. | ERROR | N/A |
| MAX_AUTHORIZATION_COUNT_EXCEEDED | The requested action could not be performed, semantically incorrect, or failed business validation. The maximum number of authorizations that are allowed for the order was reached. To increase your limit, contact Customer Support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. | FAILED | N/A |
| MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED | You have exceeded the maximum number of payment attempts. To review the maximum number of payment attempts allowed and retry this transaction, call Customer Support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. You have exceeded the maximum number of payment attempts. | FAILED | N/A |
| MAX_VALUE_EXCEEDED | Should be less than or equal to 9999999.99. Try the request again with a different value. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Should be less than or equal to 9999999.99. Try the request again with a different value. | ERROR | N/A |
| MISSING_REQUIRED_PARAMETER | A required field or parameter is missing. Verify that you have specified all required parameters and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. A required field or parameter is missing. Verify that you have specified all required parameters and try the request again. | ERROR | N/A |
| MISSING_SHIPPING_ADDRESS | The shipping address is required when shipping_preference=SET_PROVIDED_ADDRESS. Verify that you have provided the shipping address and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The shipping address is required when shipping_preference=SET_PROVIDED_ADDRESS. Verify that you have provided the shipping address and try the request again. | ERROR | N/A |
| MULTI_CURRENCY_ORDER | Multiple differing values of currency_code are not supported. The entire order request must have the same currency code. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Multiple differing values of currency_code are not supported. The entire order request must have the same currency code. | ERROR | N/A |
| MULTIPLE_SHIPPING_ADDRESS_NOT_SUPPORTED | Multiple shipping addresses are not supported. Try the request again with the same shipping_address. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Multiple shipping addresses are not supported. Try the request again with the same shipping_address. | ERROR | N/A |
| MULTIPLE_SHIPPING_OPTION_SELECTED | The requested action could not be performed, semantically incorrect, or failed business validation. Only one shipping.option can be set to selected = true. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. Only one shipping.option can be set to selected = true. | ERROR | N/A |
| INVALID_PICKUP_ADDRESS | Invalid shipping address. If the 'shipping_option.type' is set as 'PICKUP' then the 'shipping_detail.name.full_name' should start with 'S2S' meaning Ship To Store. Example: 'S2S My Store'. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Invalid shipping address. If the 'shipping_option.type' is set as 'PICKUP' then the 'shipping_detail.name.full_name' should start with 'S2S' meaning Ship To Store. Example: 'S2S My Store'. | ERROR | N/A |
| NOT_AUTHORIZED | Authorization failed due to insufficient permissions. To check that your application has sufficient permissions, log in to the PayPal Developer Portal. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Authorization failed due to insufficient permissions. To check that your application has sufficient permissions, log in to the PayPal Developer Portal. | ERROR | N/A |
| NOT_ENABLED_FOR_CARD_PROCESSING | The request fails. The API Caller account is not setup to be able to process card payments. Please contact PayPal customer support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The request fails. The API Caller account is not setup to be able to process card payments. | FAILED | N/A |
| NOT_SUPPORTED | This field is not currently supported. Specify only supported parameters and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. This field is not currently supported. Specify only supported parameters and try the request again. | ERROR | N/A |
| ORDER_ALREADY_AUTHORIZED | Order already authorized. If intent=AUTHORIZE only one authorization per order is allowed. The order was already authorized and you can create only one authorization for an order. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The order was already authorized and you can create only one authorization for an order. | FAILED | N/A |
| ORDER_ALREADY_CAPTURED | Order already captured. If intent=CAPTURE only one capture per order is allowed. The order was already captured and you can capture only one payment for an order. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The order was already captured and you can capture only one payment for an order. | FAILED | N/A |
| ORDER_CANNOT_BE_SAVED | The requested action could not be performed, semantically incorrect, or failed business validation. The option to save an order is only available if the intent is AUTHORIZE and the processing_instruction is ORDER_SAVED_EXPLICITLY. Change the intent to AUTHORIZE and the processing_instruction to ORDER_SAVED_EXPLICITLY and try the request again. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. The option to save an order is only available if the intent is AUTHORIZE and the processing_instruction is ORDER_SAVED_EXPLICITLY. | FAILED | N/A |
| ORDER_COMPLETED_OR_VOIDED | The requested action could not be performed, semantically incorrect, or failed business validation. Order is voided or completed and hence cannot be authorized. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. Order is voided or completed and hence cannot be authorized. | FAILED | N/A |
| ORDER_EXPIRED | The requested action could not be performed, semantically incorrect, or failed business validation. Order is expired and hence cannot be authorized. Please contact Customer Support if you need to increase your order validity period. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. Order is expired and hence cannot be authorized. | FAILED | N/A |
| ORDER_NOT_APPROVED | Payer has not yet approved the Order for payment. The payer has not yet approved payment for the order. Redirect the payer to the rel:approve URL that was returned in the HATEOAS links in the create order response or provide a valid payment_source in the request. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Payer has not yet approved the Order for payment. | FAILED | N/A |
| ORDER_NOT_SAVED | The requested action could not be performed, semantically incorrect, or failed business validation. Please save the order by calling v2/orders/{order_id}/save or alternately, If you do not intend to save the order, PATCH the order to update the value of processing_instruction to NO_INSTRUCTION. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. Please save the order by calling v2/orders/{order_id}/save or alternately, If you do not intend to save the order, PATCH the order to update the value of processing_instruction to NO_INSTRUCTION. | FAILED | N/A |
| ORDER_PREVIOUSLY_VOIDED | The requested action could not be performed, semantically incorrect, or failed business validation. This order has been previously voided and cannot be voided again. Verify the order id and try again. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. This order has been previously voided and cannot be voided again. Verify the order id and try again. | FAILED | N/A |
| PARAMETER_VALUE_NOT_SUPPORTED | The value specified for this field is not currently supported. The specified parameter value is not supported. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The value specified for this field is not currently supported. The specified parameter value is not supported. | ERROR | N/A |
| PAYEE_ACCOUNT_INVALID | Payee account specified is invalid. Please check the payee.email_address or payee.merchant_id specified and try again. Ensure that either payee.merchant_id or payee.email_address is specified. Specify either payee.merchant_id or payee.email_address. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Payee account specified is invalid | ERROR | N/A |
| PAYEE_ACCOUNT_LOCKED_OR_CLOSED | Payee account is locked or closed. To get more information about the status of the account, call Customer Support. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Payee account is locked or closed. | ERROR | N/A |
| PAYEE_ACCOUNT_RESTRICTED | The merchant account is restricted. To get more information about the status of the account, call Customer Support. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The merchant account is restricted. | ERROR | N/A |
| PAYEE_BLOCKED_TRANSACTION | The fraud settings for this seller are such that this payment cannot be executed. Verify the fraud settings. Then, retry the transaction. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The fraud settings for this seller are such that this payment cannot be executed. Verify the fraud settings. Then, retry the transaction. | FAILED | N/A |
| PAYER_ACCOUNT_LOCKED_OR_CLOSED | Payer account is locked or closed. To get more information about the status of the account, call Customer Support. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Payer account is locked or closed. | ERROR | N/A |
| PAYER_ACCOUNT_RESTRICTED | Payer account is restricted. To get more information about the status of the account, call Customer Support. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Payer account is restricted. | ERROR | N/A |
| PAYER_CANNOT_PAY | Payer cannot pay for this transaction. Please contact the payer to find other ways to pay for this transaction. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Payer cannot pay for this transaction.x | FAILED | N/A |
| PAYER_CONSENT_REQUIRED | The payer has not provided appropriate consent to proceed with this transaction. To proceed with the transaction, you must get payer consent. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The payer has not provided appropriate consent to proceed with this transaction. | FAILED | N/A |
| PAYER_COUNTRY_NOT_SUPPORTED | Payer Country is not supported. The Payer country is not supported. Redirect the payer to select another funding source. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Payer Country is not supported. | ERROR | N/A |
| PAYEE_NOT_ENABLED_FOR_CARD_PROCESSING | The API Caller account is not setup to be able to process card payments. Please contact PayPal customer support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The API Caller account is not setup to be able to process card payments. | FAILED | N/A |
| PAYMENT_INSTRUCTION_REQUIRED | You must provide the payment instruction when you capture an authorized payment for intent=AUTHORIZE. For details, see Capture authorization. For intent=CAPTURE, send the payment instruction when you create the order. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. You must provide the payment instruction when you capture an authorized payment for intent=AUTHORIZE. | FAILED | N/A |
| PERMISSION_DENIED | You do not have permission to access or perform operations on this resource. If you make API calls on behalf of a merchant or payee, ensure that you have been granted appropriate permissions to continue with this request. | 502 | 1001 | External Gateway Error | An external gateway error occurred. You do not have permission to access or perform operations on this resource. | ERROR | N/A |
| POSTAL_CODE_REQUIRED | The specified country requires a postal code. Specify a postal code and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The specified country requires a postal code. Specify a postal code and try the request again. | ERROR | N/A |
| PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH | The requested action could not be performed, semantically incorrect, or failed business validation. The amount provided in the preferred shipping option should match the amount provided in amount breakdown. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. The amount provided in the preferred shipping option should match the amount provided in amount breakdown. | ERROR | N/A |
| REDIRECT_PAYER_FOR_ALTERNATE_FUNDING | Transaction failed. Redirect the payer to select another funding source. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The transaction failed. Redirect the payer to select another funding source. | FAILED | N/A |
| REFERENCE_ID_NOT_FOUND | Filter expression value is incorrect. Check the value of the reference_id and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Filter expression value is incorrect. Check the value of the reference_id and try the request again. | ERROR | N/A |
| REFERENCE_ID_REQUIRED | 'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided. Provide a unique value for reference_id for each purchase_unit and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. 'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided. Provide a unique value for reference_id for each purchase_unit and try the request again. | ERROR | N/A |
| DUPLICATE_REFERENCE_ID | reference_id must be unique if multiple purchase_unit are provided. Provide a unique value for reference_id for each purchase_unit and try the request again. | 502 | 1001 | External Gateway Error | An external gateway error occurred. reference_id must be unique if multiple purchase_unit are provided. Provide a unique value for reference_id for each purchase_unit and try the request again. | ERROR | N/A |
| SHIPPING_ADDRESS_INVALID | Provided shipping address is invalid. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Provided shipping address is invalid. | ERROR | N/A |
| SHIPPING_OPTION_NOT_SELECTED | The requested action could not be performed, semantically incorrect, or failed business validation. At least one of the shipping.option values must be selected = true. | 502 | 1001 | External Gateway Error | An external gateway error occurred. The requested action could not be performed, semantically incorrect, or failed business validation. At least one of the shipping.option values must be selected = true. | ERROR | N/A |
| SHIPPING_OPTIONS_NOT_SUPPORTED | Shipping options are not supported when application_context.shipping_preference is set as NO_SHIPPING or SET_PROVIDED_ADDRESS. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Shipping options are not supported when application_context.shipping_preference is set as NO_SHIPPING or SET_PROVIDED_ADDRESS. | ERROR | N/A |
| TAX_TOTAL_MISMATCH | Should equal sum of (tax * quantity) across all items for a given purchase_unit. The tax total must equal the sum of (tax * quantity) across all items for a purchase_unit. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Should equal sum of (tax * quantity) across all items for a given purchase_unit. The tax total must equal the sum of (tax * quantity) across all items for a purchase_unit. | ERROR | N/A |
| TAX_TOTAL_REQUIRED | If item details are specified (items.tax_total and items.quantity), the corresponding amount.breakdown.tax_total is required. The amount.breakdown.tax_total is a required field. | 502 | 1001 | External Gateway Error | An external gateway error occurred. If item details are specified (items.tax_total and items.quantity), the corresponding amount.breakdown.tax_total is required. The amount.breakdown.tax_total is a required field. | ERROR | N/A |
| TRANSACTION_AMOUNT_EXCEEDS_MONTHLY_MAX_LIMIT | The transaction amount exceeds monthly maximum limit. To review the monthly transaction limits and retry this transaction, call Customer Support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The transaction amount exceeds monthly maximum limit. | FAILED | N/A |
| TRANSACTION_BLOCKED_BY_PAYEE | The requested action could not be performed, semantically incorrect, or failed business validation. The transaction was blocked by the payee’s Fraud Protection settings. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The requested action could not be performed, semantically incorrect, or failed business validation. The transaction was blocked by the payee’s Fraud Protection settings. | FAILED | N/A |
| TRANSACTION_LIMIT_EXCEEDED | Total payment amount exceeded transaction limit. To review the transaction limit and retry this transaction, call Customer Support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Total payment amount exceeded transaction limit. | FAILED | N/A |
| TRANSACTION_RECEIVING_LIMIT_EXCEEDED | The transaction exceeds the payee's receiving limit. To review the transaction limit and retry this transaction, call Customer Support. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The transaction exceeds the payee's receiving limit. | FAILED | N/A |
| TRANSACTION_REFUSED | The transaction was refused. Verify the transaction and try the request again. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. The transaction was refused. Verify the transaction and try the request again. | FAILED | N/A |
| UNSUPPORTED_INTENT | intent=AUTHORIZE is not supported for multiple purchase units. Only intent=CAPTURE is supported. | 502 | 1001 | External Gateway Error | An external gateway error occurred. intent=AUTHORIZE is not supported for multiple purchase units. Only intent=CAPTURE is supported. | ERROR | N/A |
| UNSUPPORTED_PAYMENT_INSTRUCTION | Only supported when the intent=CAPTURE. If intent is AUTHORIZE, you must provide a payment_instruction when you capture payment for the authorization. For details, see capture authorized payment. | 502 | 1001 | External Gateway Error | An external gateway error occurred. If intent is AUTHORIZE, you must provide a payment_instruction when you capture payment for the authorization. | ERROR | N/A |
| PAYEE_ACCOUNT_NOT_SUPPORTED | Payee does not have an account with PayPal. Your current setup requires the 'payee' to have a verified account with PayPal before you can process transactions on their behalf. | 502 | 1001 | External Gateway Error | An external gateway error occurred.Payee does not have an account with PayPal. Your current setup requires the 'payee' to have a verified account with PayPal before you can process transactions on their behalf. | ERROR | N/A |
| PAYEE_ACCOUNT_NOT_VERIFIED | Payee has not verified their account with PayPal. Your current setup requires the 'payee' to have an account with PayPal before you can process transactions on their behalf. | 502 | 1001 | External Gateway Error | An external gateway error occurred. Payee has not verified their account with PayPal. Your current setup requires the 'payee' to have an account with PayPal before you can process transactions on their behalf. | ERROR | N/A |
| PAYEE_NOT_CONSENTED | Payee does not have appropriate consent to allow the API caller to process this type of transaction on their behalf. Your current setup requires the 'payee' to provide a consent before this transaction can be processed successfully. | 402 | ALTERNATE-PAYMENTS-GATEWAY-4 | Transaction declined | The transaction was declined by the processing gateway. Payee does not have appropriate consent to allow the API caller to process this type of transaction on their behalf. Your current setup requires the 'payee' to provide a consent before this transaction can be processed successfully. | FAILED | N/A |
Was this page helpful?
On this Page