Amazon Pay and Login with Amazon integration guide

Step 10: 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.

Procedure

Request a refund by doing this:

  1. Make a call to the Refund API. Set the following values in the Refund request so that they appear in the buyer's Refund notification email and account status and in your Settlement and Transaction reports.
    • Refund Reference ID
    • Refund amount
    • Seller Refund Note
  2. 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 notifies you of the processing status via an IPN message.
  3. 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.
  4. 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:

    AmazonRejected

    Amazon has declined the refund because the maximum amount has already been refunded on the capture. You need to work with the buyer to issue a refund in an alternate way, such as issuing a gift card or a store credit.

    ProcessingFailure

    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.

    If you receive a ProcessingFailure reason code, 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 refund has been issued to the buyer and 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 another way.

    For more information, see Handling errors.


https://mws.amazonservices.com/OffAmazonPayments_Sandbox/2013-01-01
?AWSAccessKeyId=AKIAFBM3LG5JEEXAMPLE
&Action=Refund
&AmazonCaptureId=S23-1234567-1234567-0000002
&RefundAmount.Amount=199.00
&RefundAmount.CurrencyCode=GBP
&RefundReferenceId=test_refund_1
&SellerRefundNote=For%20your%20returned%20item%2C%20Casad%20%272Jours
%20Bonheur%27%20Satchel%20in%20Sandstorm
&SellerId=YOUR_SELLER_ID_HERE   
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2013-11-27T19%3A01%3A11Z
&Version=2013-01-01
&Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE

Alternate scenarios


Copyright © 2009-2017 Amazon.com, Inc. or its affiliates. Amazon and Amazon.com are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.