10736

API

Last updated: Mar 3rd, 12:18pm

Returns from the following NVP/SOAP APIs:

  • DoAuthorization
  • DoExpressCheckoutPayment
  • DoReferenceTransaction
  • SetExpressCheckout
  • UpdateAuthorization

Cause

The shipping address information is invalid. The city, state, or postal code fails validation and does not match an existing address. The error message specifies which field is incorrect.

Common causes:

  • Validation rules allow payers to submit incomplete or invalid address data.
  • The system fails to capture or include the address field in the API request to PayPal.
  • The address format is incorrect. For example, there may be ZIP code with fewer than five digits or containing non-numeric characters.

Impact

The payment process is halted, preventing the customer from finalizing their purchase. This can lead to a poor customer experience and potentially lost sales if the issue is not resolved promptly.

Resolution

  • Redirect the buyer: Direct the buyer to the shipping information page to update their shipping address.
  • Validate postal code: Ensure the buyer enters a valid postal code before submitting the transaction. Implement validation checks to ensure the postal code field is not left blank and is in the correct format.
  • Review code: Verify that the shipping information is correctly captured and included in the API request.
  • Use ADDROVERRIDE field: Control how PayPal displays the shipping address using the optional ADDROVERRIDE field:
    • 0 – The PayPal checkout page does not display the shipping address.
    • 1 – The PayPal checkout page displays the shipping address from the SetExpressCheckout request instead of the buyer’s saved PayPal address. The buyer cannot edit the saved address if it is displayed.

Upgrade

The NVP/SOAP API integration method is deprecated. You can find more information about our latest integrations from the following resources:

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more