Error Codes and Transaction Status

Transaction Status (PayPal Payments)

Paypal Status

Paypal Status description

Paysafe Status

Paysafe Status Code

Completed

The funds for this captured payment were credited to the payee's PayPal account.

COMPLETED

201

Declined

The funds could not be captured.

FAILED

200

Pending

The funds for this captured payment was not yet credited to the payee's PayPal account. The reason why the captured payment status is PENDING or DENIED

Status details_reason_Enum	Description
BUYER_COMPLAINT	The payer initiated a dispute for this captured payment with PayPal.
CHARGEBACK	The captured funds were reversed in response to the payer disputing this captured payment with the issuer of the financial instrument used to pay for this captured payment.
ECHECK
INTERNATIONAL_WITHDRAWAL
PENDING_REVIEW	The captured payment is pending manual review
OTHER	No additional specific reason can be provided. For more information about this captured payment, visit your account online or contact PayPal.
RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION	The payee has not yet set up appropriate receiving preferences for their account. For more information about how to accept or deny this payment, visit your account online. This reason is typically offered in scenarios such as when the currency of the captured payment is different from the primary holding currency of the payee.
REFUNDED	The captured funds were refunded.
TRANSACTION_APPROVED_AWAITING_FUNDING	The payer must send the funds for this captured payment. This code generally appears for manual EFTs.
UNILATERAL	The payee does not have a PayPal account.
VERIFICATION_REQUIRED	The payee's PayPal account is not verified.

PROCESSING

200

Failed

There was an error while capturing payment.

FAILED

200

Transaction Status (PayPal Withdrawals)

Paypal Status	Paypal Status description	Paysafe Status	Paysafe Status code
PENDING	Your payout requests were received and will be processed soon.	PROCESSING	201
PROCESSING	Your payout requests were received and are now being processed.	PROCESSING	201
SUCCESS	Your payout batch was processed and completed. Check the status of each item for any holds or unclaimed transactions.	COMPLETED	201
DENIED	Your payout requests were denied, so they were not processed. Check the error messages to see any steps necessary to fix these issues.	Failed	200

Errors

PayPal does not return any error codes, they only return error messages. Here is a comprehensive list of error messages 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 Detail(s)	Paysafe Status
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. Merchant configuration is incorrect. Verify setup in Netbanx	FAILED
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. Ensure recipient of account is correct	FAILED
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. Transaction already cancelled.	FAILED
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
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
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
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
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
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
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.	ERROR
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.	ERROR
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.	FAILED
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
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
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
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
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
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
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
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
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
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
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
SHIPPING_ADDRESS_INVALID	Provided shipping address is invalid.	502	1001	External Gateway Error	An external gateway error occurred. Provided shipping address is invalid.	ERROR
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
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
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
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
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
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
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
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
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
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
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
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
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
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

Was this page helpful?

On this Page

Transaction Status (PayPal Payments)
Transaction Status (PayPal Withdrawals)
Errors

Search Overlay

Error Codes and Transaction Status

Was this page helpful?

Thank you for your response!