Last updated: September 16, 2026
The Orders v2 API returns the following issues under the INVALID_REQUEST error name.
The Payments v1 API returns validation problems under a generic VALIDATION_ERROR error name instead of the itemized issue codes on this page.
Note: If an issue persists or if you have further questions, reach out to paypal-techsupport.com.
Use this section if you're using the Payments v1 API, or if your Orders v2 error response doesn't include a specific issue code.
| Cause |
|
|---|---|
| Impact | The payment process is halted, preventing the buyer from finalizing their purchase. This can lead to lost sales if the issue is not resolved promptly. |
| Resolution |
|
The Orders v2 API returns this error.
| Cause | The number of items in an array parameter is too small. This can
happen when a required array field, such as |
|---|---|
| Impact | The payment process is halted, preventing the buyer from finalizing their purchase. This can lead to lost sales if the issue is not resolved promptly. |
| Resolution |
|
The Orders v2 API returns this error.
| Cause | The value provided for a field doesn't match its required syntax or format. |
|---|---|
| Impact | The payment process is halted, preventing the buyer from finalizing their purchase. This can lead to lost sales if the issue is not resolved promptly. |
| Resolution |
|
The following fields return INVALID_PARAMETER_SYNTAX when their value doesn't match the required syntax or format:
application_context/localepayer/address/country_codepayer/birth_datepayer/email_addresspayer/payer_idpayer/phone/phone_number/country_codepayer/phone/phone_number/extension_numberpayer/phone/phone_number/national_numberpayment_source/paypal/experience_context/app_switch_preference/app_urlpayment_source/skrill/country_codepayment_source/twint/country_codepayment_source/wero/country_codepurchase_units/0/amount/breakdown/discount/valuepurchase_units/0/amount/breakdown/handling/valuepurchase_units/0/amount/breakdown/item_total/valuepurchase_units/0/amount/breakdown/shipping/valuepurchase_units/0/amount/breakdown/shipping_discount/valuepurchase_units/0/amount/breakdown/tax_total/valuepurchase_units/0/amount/valuepurchase_units/0/items/0/tax/valuepurchase_units/0/items/1/unit_amount/valuepurchase_units/0/payee/display_data/business_emailpurchase_units/0/payee/email_addresspurchase_units/0/payee/merchant_idpurchase_units/0/shipping/address/country_codeThe Orders v2 API returns this error.
| Cause | The value of a field isn't valid, even though it matches the field's expected format. |
|---|---|
| Impact | The payment process is halted, preventing the buyer from finalizing their purchase. This can lead to lost sales if the issue is not resolved promptly. |
| Resolution |
|
The Orders v2 API returns this error.
| Cause | The value of a field is either too short or too long. |
|---|---|
| Impact | The payment process is halted, preventing the buyer from finalizing their purchase. This can lead to lost sales if the issue is not resolved promptly. |
| Resolution |
|
The Orders v2 API returns this error.
| Cause | A required field or parameter is missing from the request. |
|---|---|
| Impact | The payment process is halted, preventing the buyer from finalizing their purchase. This can lead to lost sales if the issue is not resolved promptly. |
| Resolution |
|