Help Center - Personal Account
  • Home
  • Payments and Transfers
  • Disputes and Limitations
  • My Account
  • My Wallet
  • Login & Security
  • Seller Tools

How do I handle PayPal API timeouts and internal server error messages?

Generally, PayPal API timeouts and internal server error messages result from server or connectivity issues.

The following API methods can produce this error:

  • DoDirectPayment.
  • DoExpressCheckoutPayment.
  • DoAuthorization.
  • DoCapture.

When an internal server error or timeout message is received in response to an API request that processes a payment, make sure the buyer wasn't charged. To do this, refer to your existing reconciliation processes to identify the buyer's completed transactions.

If you don't have a reconciliation process or are unsure whether that process identified a completed transaction, you can use the TransactionSearch API to locate any transactions that took place when the error occurred. If the API returns a result matching your transaction, use the GetTransactionDetails API with the Transaction ID to receive the data for that transaction. You can retry the transaction safely if the TransactionSearch API doesn't return a matching result.

Note: Your cache and cookies can also cause this error. If timeouts continue, try testing in another browser, test in Incognito/Private mode, or clear your cache and cookies.

Using the TransactionSearch API.

How do I resolve API timeout problems?

PayPal NVP and SOAP API Reference Guides.

More ways we can help

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