This is a draft guide. Content is subject to change.

Handle authorization declines

[Step 7 of 9] In case of a processor decline on the authorization being returned by the acquirer, you can offer the buyer the possibility to select a new credit card from the Amazon account and try to place the order again. This recovery flow will be available in the Amazon Pay Decline page, hosted on Amazon Pay domain.


1. Get Checkout Session

In case of a processor decline being returned by the acquirer, call Get Checkout Session to retrieve the details of the object. A new amazonPayRedirectUrl will be returned as part of the API response.

Note: Please make sure to check the checkoutResultReturnUrl parameter you find in the Checkout Session details. After the Amazon Pay Decline page, the buyer will be sent back to checkoutResultReturnUrl. On this endpoint the logic to process the payment with the acquirer should be executed. If such endpoint should be different from the one the buyer was redirected to after the Amazon Pay Processing page, update the endpoint calling Update Checkout Session.


2. Redirect buyer to the Amazon Pay Decline Handling page

Once you retrieved the new amazonPayRedirectUrl, redirect the buyer to the Amazon Pay Decline page. In this page, the buyer will be able to see the rejected credit card used for the first authorization attempt, and select another one from the Amazon account to try a new payment attempt.


3. Repeat Step 6 to try a new payment attempt

When the buyer confirms the new credit card selected from the Amazon wallet, buyer will be redirected to the checkoutResultReturnUrl.

At this point you should try to process the payment again following the same instructions outlined in Step 6 of this guide.