Error Codes

PayPal Error Code List and what they mean. Please check here before contacting support for assistance. You may need to Contact PayPal.

ACTION_DOES_NOT_MATCH_INTENT

Order was created with an intent to CAPTURE.

AGREEMENT_ALREADY_CANCELLED

The requested agreement is already cancelled. You cannot bill this person because they cancelled it recently. They need to sign up again.

AMOUNT_CANNOT_BE_SPECIFIED

The requested action could not be performed, semantically incorrect, or failed business validation.

AMOUNT_MISMATCH

The amount specified does not match the breakdown.

AMOUNT_NOT_PATCHABLE

The requested action could not be performed, semantically incorrect, or failed business validation.

AMOUNT_LESS_THAN_MIN_VALUE

The requested action could not be completed, was semantically incorrect, or failed business validation.

AUTH_CAPTURE_NOT_ENABLED

The requested action could not be performed, semantically incorrect, or failed business validation.

AUTHENTICATION_FAILURE

Authentication failed due to missing authorization header, or invalid authentication credentials.

AUTHORIZATION_AMOUNT_EXCEEDED

The requested action could not be performed, semantically incorrect, or failed business validation.

AUTHORIZATION_CURRENCY_MISMATCH

The requested action could not be performed, semantically incorrect, or failed business validation.

BILLING_AGREEMENT_NOT_FOUND

The requested Billing Agreement token was not found.

CANNOT_BE_NEGATIVE

Must be greater than or equal to zero. Please contact the merchant to have this resolved.

CANNOT_BE_ZERO_OR_NEGATIVE

Must be greater than zero. Please contact the merchant to have this resolved.

CARD_BRAND_NOT_SUPPORTED

Processing of this card brand is not supported. Please have the customer use a different card type supported by PayPal or by PayPal for this country.

CARD_COUNTRY_NOT_SUPPORTED

The country in which this card was issued is not currently supported.

CARD_TYPE_NOT_SUPPORTED

The requested action could not be performed, semantically incorrect, or failed business validation.

INVALID_SECURITY_CODE_LENGTH

The requested action could not be performed, semantically incorrect, or failed business validation.

CITY_REQUIRED

The specified country requires a city (address.admin_area_2).

COMPLIANCE_VIOLATION

Transaction cannot be processed due to a possible compliance violation. This is something you need to contact PayPal about.

Authorization failed due to insufficient permissions. The customer or the Merchant need to agree to the billing agreement terms.

COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE

The requested action could not be completed, was semantically incorrect, or failed business validation.

CURRENCY_NOT_SUPPORTED_FOR_CARD_TYPE

The requested action could not be performed, semantically incorrect, or failed business validation.

CURRENCY_NOT_SUPPORTED_FOR_COUNTRY

The requested action could not be performed, semantically incorrect, or failed business validation.

CURRENCY_NOT_SUPPORTED_BY_PAYMENT_SOURCE

The requested action could not be completed, was semantically incorrect, or failed business validation.

DECIMAL_PRECISION

The value of the field should not be more than two decimal places.

DOMESTIC_TRANSACTION_REQUIRED

This transaction requires the payee and payer to be resident in the same country.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

DUPLICATE_INVOICE_ID

Duplicate Invoice ID detected.

DUPLICATE_REQUEST_ID

The value of PayPal-Request-Id header has already been used.

FIELD_NOT_PATCHABLE

Field cannot be patched.

INSTRUMENT_DECLINED

The funding instrument presented was either declined by the processor or bank.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

UNSUPPORTED_INTENT_FOR_PAYMENT_SOURCE

The requested action could not be completed, was semantically incorrect, or failed business validation.

INTERNAL_SERVER_ERROR

An internal server error has occurred. Please try again in an hour.

INTERNAL_SERVICE_ERROR

An internal service error has occurred.

INVALID_ACCOUNT_STATUS

Account validations failed for the user.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

INVALID_ARRAY_MAX_ITEMS

The number of items in an array parameter is too large.

INVALID_ARRAY_MIN_ITEMS

The number of items in an array parameter is too small.

INVALID_COUNTRY_CODE

Country code is invalid.

INVALID_CURRENCY_CODE

Currency code is invalid or is not currently supported. Please use a supported one.

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.

INVALID_PARAMETER_SYNTAX

The value of a field does not conform to the expected format.

INVALID_PARAMETER_VALUE

The value of a field is invalid.

INVALID_PARAMETER

Cannot be specified as part of the request.

INVALID_PATCH_OPERATION

Request is not well-formed, syntactically incorrect, or violates schema.

INVALID_PAYER_ID

The payer ID is not valid.

INVALID_RESOURCE_ID

Specified resource ID does not exist.

INVALID_STRING_LENGTH

The value of a field is either too short or too long.

ITEM_TOTAL_MISMATCH

Verify the corresponding values and try the request again.

ITEM_TOTAL_REQUIRED

If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required.

MAX_AUTHORIZATION_COUNT_EXCEEDED

The requested action could not be performed, semantically incorrect, or failed business validation.

MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED

You have exceeded the maximum number of payment attempts. Please wait an hour and try again.

MAX_VALUE_EXCEEDED

Should be less than or equal to 9999999.99.

MISSING_REQUIRED_PARAMETER

A required field or parameter is missing.

MISSING_SHIPPING_ADDRESS

The shipping address is required when shipping_preference=SET_PROVIDED_ADDRESS.

MULTI_CURRENCY_ORDER

Multiple differing values of currency_code are not supported.

MULTIPLE_SHIPPING_ADDRESS_NOT_SUPPORTED

Multiple shipping addresses are not supported.

MULTIPLE_SHIPPING_OPTION_SELECTED

The requested action could not be performed, semantically incorrect, or failed business validation.

INVALID_PICKUP_ADDRESS

Invalid shipping address.

NOT_AUTHORIZED

Authorization failed due to insufficient permissions.

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.

NOT_PATCHABLE

Cannot be patched.

NOT_SUPPORTED

This field is not currently supported.

ORDER_ALREADY_AUTHORIZED

Order already authorized. If intent=AUTHORIZE only one authorization per order is allowed.

ORDER_ALREADY_CAPTURED

Order already captured. If intent=CAPTURE only one capture per order is allowed.

ORDER_ALREADY_COMPLETED

The order cannot be patched after it is completed.

ORDER_CANNOT_BE_SAVED

The requested action could not be performed, semantically incorrect, or failed business validation.

ORDER_COMPLETED_OR_VOIDED

The requested action could not be performed, semantically incorrect, or failed business validation.

ORDER_EXPIRED

The requested action could not be performed, semantically incorrect, or failed business validation.

ORDER_NOT_APPROVED

Payer has not yet approved the Order for payment.

ORDER_NOT_SAVED

The requested action could not be performed, semantically incorrect, or failed business validation.

ORDER_PREVIOUSLY_VOIDED

The requested action could not be performed, semantically incorrect, or failed business validation.

PARAMETER_VALUE_NOT_SUPPORTED

The value specified for this field is not currently supported.

PATCH_PATH_REQUIRED

Specify a path for the field for which the operation needs to be performed.

PATCH_VALUE_REQUIRED

Please specify a value to for the field that is being patched.

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.

PAYEE_ACCOUNT_LOCKED_OR_CLOSED

Payee account is locked or closed.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

PAYEE_ACCOUNT_RESTRICTED

The merchant account is restricted.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

PAYEE_BLOCKED_TRANSACTION

The fraud settings for this seller are such that this payment cannot be executed.

PAYER_ACCOUNT_LOCKED_OR_CLOSED

Payer account is locked or closed.

PAYER_ACCOUNT_RESTRICTED

Payer account is restricted.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

PAYER_CANNOT_PAY

Payer cannot pay for this transaction.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

The payer has not provided appropriate consent to proceed with this transaction.

PAYER_COUNTRY_NOT_SUPPORTED

Payer Country is not supported.

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.

PAYMENT_INSTRUCTION_REQUIRED

You must provide the payment instruction when you capture an authorized payment for intent=AUTHORIZE.

PERMISSION_DENIED

You do not have permission to access or perform operations on this resource.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

POSTAL_CODE_REQUIRED

The specified country requires a postal code.

POSTAL_CODE_FORMAT

You must create your account on PayPal directly and provide all valid information for your country in order to continue with account creation.

PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH

The requested action could not be performed, semantically incorrect, or failed business validation.

REDIRECT_PAYER_FOR_ALTERNATE_FUNDING

Transaction failed. Redirect the payer to select another funding source.

REFERENCE_ID_NOT_FOUND

Filter expression value is incorrect.

REFERENCE_ID_REQUIRED

'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided.

DUPLICATE_REFERENCE_ID

reference_id must be unique if multiple purchase_unit are provided.

SHIPPING_ADDRESS_INVALID

Provided shipping address is invalid.

SHIPPING_OPTION_NOT_SELECTED

The requested action could not be performed, semantically incorrect, or failed business validation.

SHIPPING_OPTIONS_NOT_SUPPORTED

The requested action could not be performed, semantically incorrect, or failed business validation.

TAX_TOTAL_MISMATCH

Should equal sum of (tax * quantity) across all items for a given purchase_unit.

TAX_TOTAL_REQUIRED

If item details are specified (items.tax_total and items.quantity), the corresponding amount.breakdown.tax_total is required.

TRANSACTION_AMOUNT_EXCEEDS_MONTHLY_MAX_LIMIT

The transaction amount exceeds monthly maximum limit.

TRANSACTION_BLOCKED_BY_PAYEE

The requested action could not be performed, semantically incorrect, or failed business validation.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

TRANSACTION_LIMIT_EXCEEDED

Total payment amount exceeded transaction limit.

The transaction exceeds the payee's receiving limit. This is an issue with the amount allowed to be received by the PayPal account. Please contact PayPal support.

TRANSACTION_RECEIVING_LIMIT_EXCEEDED

The transaction exceeds the payee's receiving limit. This is an issue with the amount allowed to be received by the PayPal account. Please contact PayPal support.

TRANSACTION_REFUSED

The transaction was refused. This could be for any number of reasons such as the customer had INSUFFICIENT FUNDS, FUNDING SOURCE, FAILURE TO CONFIRM THEIR PAYPAL EMAIL ADDRESS or their CARD WAS DECLINED. This is an error with the CUSTOMER, not Upgrade.Chat. Please contact your customer or have them contact PayPal as they are the only ones that can correct this issue.

Upgrade.Chat support cannot fix this issue. This is an issue with the customer's payment method. Please do not contact support about this. Contact PayPal.

UNSUPPORTED_INTENT

intent=AUTHORIZE is not supported for multiple purchase units. Only intent=CAPTURE is supported.

Please report this issue to https://upgrade.chat/support

UNSUPPORTED_PATCH_PARAMETER_VALUE

The value specified for this field is not currently supported.

Please report this issue to https://upgrade.chat/support

UNSUPPORTED_PAYMENT_INSTRUCTION

Only supported when the intent=CAPTURE.

Please report this issue to https://upgrade.chat/support

PAYEE_ACCOUNT_NOT_SUPPORTED

Payee does not have an account with PayPal. They need to create an account in order to continue with checkout.

PAYEE_ACCOUNT_NOT_VERIFIED

Payee has not verified their account with PayPal. No transactions can be completed for this customer / merchant until their account is verified.

PAYEE_NOT_CONSENTED

Payee does not have appropriate consent to allow the API caller to process this type of transaction on their behalf. There is nothing Upgrade.Chat can do about this. The customer / merchant needs to approve the transaction and billing agreement.

AMOUNT_CHANGE_NOT_ALLOWED

The amount specified is different from the amount authorized by payer.

BILLING_AGREEMENT_ID_MISMATCH

Billing Agreement ID must match the one that was provided during order creation.

PAYPAL_REQUEST_ID_REQUIRED

A PayPal-Request-Id is required if you are trying to process payment for an Order.

PAYMENT_ALREADY_APPROVED

The payment has already been approved.

INCOMPATIBLE_PARAMETER_VALUE

The value of the field is incompatible with other fields in the order.

INVALID_PREVIOUS_TRANSACTION_REFERENCE

The authorization or capture referenced by previous_transaction_reference is not valid. This could be either because the previous_transaction_reference is not found or doesn't belong to the payee.

PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK

The capture referenced by previous_transaction_reference has a chargeback and hence cannot be used for this order.

PREVIOUS_TRANSACTION_REFERENCE_VOIDED

The status of authorization referenced by previous_transaction_reference is VOIDED and hence cannot be used for this order.

PAYMENT_SOURCE_MISMATCH

The payment_source in the request must match the payment_source used for the authorization or capture referenced by previous_transaction_reference.

MERCHANT_INITIATED_WITH_SECURITY_CODE

stored_payment_source.payment_initiator = MERCHANT is not supported if payment_source.card.security_code is present in the order.

MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS

stored_payment_source.payment_initiator = MERCHANT is not supported if 3D-Secure authentication results are present in the order.

MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS

stored_payment_source.payment_initiator = MERCHANT is not supported if more than one purchase_unit is present in the Order.

PREAPPROVED_PAYMENTS

This is an error with the customer's account. You or the customer must contact PayPal to resolve or use a different payment method.

Last updated