Step 11: Request a refund
You can issue full or partial refunds against previously successful Captured funds.
Note: When you have issued a refund, that amount is no longer available for authorisation or capture.
After a refund is successfully processed, the Refund object is in a Completed state, and a Refund notification email is sent to the buyer.
If the Refund is declined by Amazon, the Refund object is in a Declined state. For more information, see step 4, "Check the response for errors or declines" below.
There is no time limit for initiating a refund, but the longer you take to request a refund, the more likely that a payment method associated with the purchase will become invalid and the refund will fail.
Note: If you infrequently run into refund scenarios, you can manually issue refunds through Seller Central in lieu of integrating the Refund API call into your workflow.
Request a refund by doing this:
- Make a call to the Refund API. For a detailed list of the available parameters for this API call, go to the technical description of the Refund API call in the API reference guide.
- Listen for the Refund IPN message returned by Amazon. Refund requests are not processed in real time and the initial RefundStatus is always Pending. Processing time varies and can be several hours. Amazon will notify you of the processing status via an IPN message.
- Get Refund Details. You can query the details of a Refund object by calling the GetRefundDetails API using the AmazonRefundId that was returned with the Refund IPN message.
- Check the response for errors or declines. You need to handle any errors that may occur from the API call, and you need to manage any refunds that are in a Declined state.
If a Refund is declined, you see one of the following reason codes in the response:
Amazon has rejected the refund. You should issue a refund to the buyer in an alternate manner (for example, a gift card or store credit).
Amazon could not process the transaction because of one of the following:
- Amazon could not process the transaction because of an internal error.
- A refund has already been issued from an A-to-z Guarantee claim or from a chargeback.
For more information, see Handling errors from Amazon Pay API calls.