10416

Returns from the DoExpressCheckoutPayment API.

The API returns this error when a payment attempt through PayPal's Express Checkout fails because the maximum number of payment attempts for the given token has been exceeded.

The transaction has failed, and subsequent retries have caused the token to expire. Common causes include:

• Multiple payment attempts: The customer may have attempted to complete the payment multiple times using the same token, leading to the limit being reached.
• Payment failures: Repeated payment failures due to issues such as insufficient funds, incorrect payment details, or declined transactions can contribute to reaching the maximum attempt limit.
• Session expiry: The token may have expired due to the passage of time or inactivity, resulting in further attempts to use the same token triggering this error.

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.

• Generate a new token: Implement a process to generate a new token for the customer when this error occurs. This can be achieved by redirecting the customer to the initial checkout page to start the process anew. This ensures that a fresh token is issued, allowing the payment process to proceed without further issues.
• Avoid retrying failed transactions: In the event of a failed transaction, do not retry the DoExpressCheckoutPayment API call with the same token. Instead, guide the customer through the process of obtaining a new token to prevent repeated failures.
• Verify token uniqueness: Implement a mechanism to verify that the token being used has not already been used for a previous transaction. PayPal tokens are single-use and cannot be reused. This step helps prevent the reuse of tokens and ensure the integrity of the payment process.

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

• REST APIs
• PayPal Checkout
• PayPal Developer homepage

• See the developer portal for more information on NVP/SOAP APIs.
• See a complete list of NVP/SOAP error codes.