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