Important: This integration has been deprecated. Amazon Pay will continue to support this version but it will not be updated with new features. New integrations should use Amazon Pay Checkout.

Step 9: Request a refund

You can issue full or partial refunds against previously successful Capture operations by calling the Refund operation. The capture process generates an AmazonCaptureId that must be included in the call to the Refund operation.

Note: 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, the refund will fail, and you will need to contact your customer to complete the refund.

The Refund object

In Amazon Pay and Login with Amazon, a Refund object represents the movement of previously captured funds to the buyer's account from your account. At any time, the Refund object can be in one of the following three states:

Pending - Amazon does not process your refunds in real time. The Refund object is always in the Pending state when you first submit the refund request. You will receive a synchronous response to the Refund operation that indicates this status. The Refund object remains in the Pending state until it is processed by Amazon Pay. The processing time varies and can be several hours. After processing is complete, Amazon Pay notifies you of the processing status. For more information about how to receive the final refund status, see Getting the refund status below.
Declined - The Refund object is in the Declined state if the request is declined by Amazon. For more information, see Step 7: Prepare to handle declined authorizations.
Completed - The Refund object is in the Completed state after the refund is successfully processed.

Declined refunds

If the Refund operation call is declined, you see one of the following two reason codes included in the response:

AmazonRejected

Amazon has rejected the refund, potentially due to a negative balance in your merchant account. To resolve this, you should repay the negative seller balance (NSB) to Amazon, then attempt the refund again or issue a refund to the buyer in an alternate manner (for example, a gift card or store credit).

ProcessingFailure

ProcessingFailure indicates one of the following:

Amazon could not process the transaction because of an internal error.
The buyer has already received a refund from an A-to-z Guarantee claim or from a chargeback.

If you receive a ProcessingFailure reason code in the response, you should first check the A-to-z Guarantee claim and chargeback status for your order in Seller Central by clicking Performance. If no A-to-z claim or chargeback has been issued to the buyer and if the Capture object is still in the Completed state, retry your request in one to two minutes. If the retry attempt does not succeed, contact the buyer and issue the refund in an alternative way.

The following example shows how to call the Refund operation:

 
https://mws-eu.amazonservices.com/OffAmazonPayments_Sandbox/2013-01-01
?AWSAccessKeyId=AKIAFBM3LG5JEEXAMPLE
&Action=Refund
&AmazonCaptureId=S23-1234567-1234567-0000002
&RefundAmount.Amount=94.50
&RefundAmount.CurrencyCode=EUR
&RefundReferenceId=test_refund_1
&SellerRefundNote=Refund%20for%20Blue%20Shoes
&SellerId=YOUR_SELLER_ID_HERE
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2013-11-27T19%3A01%3A11Z
&Version=2013-01-01
&Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE

For more information about the Refund operation, including the request parameters and response elements, see Refund in the Amazon Pay API reference guide.

Getting the refund status

The response to the Refund operation includes a response element called the RefundStatus, which is always set to Pending. You later receive the final status of the refund request (for example, Completed or Declined) from Amazon Pay through the Instant Payment Notification service. For more information about the Instant Payment Notification service, see Synchronizing your systems with Amazon Pay.

You then have the option to query details of the Refund object by calling the GetRefundDetails operation using the AmazonRefundId that was returned with the Refund response. For more information, see GetRefundDetails in the Off-Amazon Payments API section reference.

Notifying buyers of successful refunds

Every time a successful refund takes place, Amazon Pay sends the buyer a Refund notification email with details about the refund.

Amazon Pay lets you specify various pieces of information in the emails sent by Amazon Pay, like your customer service email address, phone number, or note from the seller. For more information about customizing these emails, see Buyer-facing email content that you can provide.