10621

API

Last updated: Apr 10th, 12:07pm

Returns from the following NVP/SOAP API calls:

  • DoAuthorization
  • DoCapture
  • DoReferenceTransaction
  • DoUATPAuthorization
  • DoVoid

Cause

The PayPal Order ID (“O-XXXXXXXXXX” ID) has expired . The order ID is only valid for a limited period, within which the merchant is expected authorize or capture a transaction. If the order ID is expired, the authorization or capture steps will not be executed.

Sometimes, when product delivery lead times are long, this issue can occur because the order is on hold until the item ships.

Impact

The payment has failed and the customer needs to be contacted to procure funds.

Resolution

This error will most likely happen when the customer is not present on the website and when the order is awaiting fulfilment. Merchants are advised to reach out to the customer and either:

  • Ask them to checkout with PayPal again
  • Send them a PayPal invoice to get the payment
  • Have them pay through any alternative payment method because the PayPal payment couldn’t be completed.
    • To avoid this issue, you may capture funds before the order ID expires.
    • A PayPal Order ID is valid for 29 days. Merchants are expected to authorize or capture funds within that period. You may reach out to PayPal support if there’s a need to extend the validity period of an Order ID.
    • Clear communication with customers is key to initiate the payment again.

Upgrade

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

Additional resources

See a complete list of NVP/SOAP error codes.

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