10411

API

Last updated: Feb 26th, 3:24pm

Returns from the following NVP/SOAP API calls:

  • SetExpressCheckout
  • DoExpressCheckoutPayment
  • CreateBillingAgreement

Cause

The API returns this error when the current Express Checkout session has expired. This error indicates that the token value is no longer valid, typically because the session has exceeded its time limit.

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

  • Inform the customer: Communicate to the customer that the Express Checkout transaction has expired and must be restarted. Display an error message explaining the situation and provide a button that enables the customer to restart the Express Checkout flow. Redirect them back to PayPal to approve the use of PayPal again.
  • Restart the checkout process: Initiate a new Express Checkout session without reusing the expired token value in the SetExpressCheckout request. Since you already know the final OrderTotal, ensure that you update the value for that element if necessary. Additionally, review and update the values for ReturnURL and CancelURL to ensure they are accurate.
  • Check token validity: By default, the token is only valid for 3 hours. If your business requires a longer token validity period, contact PayPal customer service to request an extension of the token expiry time.
  • Enhance user experience: To minimize customer frustration, streamline the process of restarting the checkout session. Ensure that the customer can easily resume their purchase with minimal steps and clear instructions.

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