# Error Codes ## **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. {% hint style="danger" %} 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. {% endhint %} ## **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. {% hint style="danger" %} 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. {% endhint %} ## **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. {% hint style="danger" %} 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. {% endhint %} ## **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](https://tools.ietf.org/html/rfc6901) 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. {% hint style="danger" %} 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. {% endhint %} ## **PAYEE\_ACCOUNT\_RESTRICTED** The merchant account is restricted. {% hint style="danger" %} 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. {% endhint %} ## **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. {% hint style="danger" %} 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. {% endhint %} ## **PAYER\_CANNOT\_PAY** Payer cannot pay for this transaction. {% hint style="danger" %} 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. {% endhint %} ## **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. {% hint style="danger" %} 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. {% endhint %} ## **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. {% hint style="danger" %} 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. {% endhint %} ## **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. {% hint style="danger" %} 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. {% endhint %} ## **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**](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**](https://upgrade.chat/support) ## **UNSUPPORTED\_PAYMENT\_INSTRUCTION** Only supported when the `intent=CAPTURE`. Please report this issue to [**https://upgrade.chat/support**](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 ![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-Mb7JHhtnI6B4iuoY0O_%2F-Mb7K8x56Ck1ruxxw-LG%2Fimage.png?alt=media\&token=d77aa3a2-1188-45cf-b956-ccb19b1653df) This is an error with the customer's account. You or the customer must contact PayPal to resolve or use a different payment method.