Recover from error code 10486
Important: This integration method is deprecated as of January 1, 2017. PayPal continues to support existing merchants using this method, but please be advised new features and enhancements will not be applied to these integration. For new integrations, see Redirect for an alternate funding source.
When a buyer's funding source fails, the
DoExpressCheckoutPayment call returns a
10486 error. If this error occurs, you can redirect the buyer back to PayPal where they can choose an alternate funding source or add a new one.
A funding source may fail for these reasons:
- The billing address associated with the financial instrument could not be confirmed.
- The transaction exceeds the card limit.
- The transaction was denied by the card issuer.
These sections provide further details:
You can initiate the recovery process with this Express Checkout implementation:
|PaymentAction type||API operation|
These features do not support the recovery process:
- Reference Transactions
- Recurring Payments
Error code details
The Express Checkout error response parameters for the NVP and SOAP API formats are:
You may redirect the buyer back to PayPal multiple times as long as this error code is returned. Then prompt the buyer to choose another payment method available on your site.
Integration details depend on how
PaymentAction is set in your implementation.
Sale or authorization integrations
Upon receiving this error code for a sale ora authorization, redirect the buyer back to PayPal using the existing Express Checkout token. On the PayPal page, the buyer is presented with an error message explaining the reason for the decline. Additionally, the buyer is given the option to select an alternate funding source or add a new one. After the buyer changes the financial instrument, you can reattempt the payment.
This diagram shows the redirect flow for
DoExpressCheckoutPayment when PaymentAction is set to sale or authorization:
Note: This feature makes no changes to the current token expiry period.
Modify your front-end error code handling to redirect the buyer back to PayPal using the same redirect URL that was used to originally start the checkout flow.
This example shows the redirect URL and token:
Test your integration
The PayPal Sandbox is a self-contained, virtual testing environment that mimics the live PayPal production environment. It provides a shielded space where you can watch your application process calls to the PayPal APIs, without touching any live PayPal accounts. By substituting fictitious sandbox accounts and their associated authentication credentials in your PayPal API calls, you can test and debug your application without referencing any real PayPal users or their PayPal accounts. To set up your sandbox test environment, see the PayPal Sandbox Testing Guide.
To test your error-handling code, configure a fictitious Sandbox buyer's PayPal account to return error
10486 when it is used to execute an Express Checkout payment in the Sandbox environment.
Test a sale or authorization integration
- Log in to https://www.sandbox.paypal.com using your buyer's test PayPal account.
- Replace the contents of the street address Line-1 of the buyer's test credit card, with
- Execute a typical Express Checkout payment flow against the sandbox environment using the same buyer account and with the same credit card that you just modified.
- When you execute
DoExpressCheckoutPayment, error code
10486is returned. Your code should redirect the buyer back to PayPal using the same redirect URL used to start the checkout flow and the same Express Checkout token.
The buyer's experience
When the buyer returns to PayPal, they are prompted with proper error messaging on the PayPal page. If the buyer's PayPal login session is still active, they do not need to log in again.
For example, the buyer might see an error message similar to this on the PayPal page:
We're sorry, but your transaction couldn't be completed using the selected card, Visa x-1234, because it has been denied by the card issuer. Another payment method has been chosen for you. Please continue with this payment method, or choose a different way to pay.