Refund failed: Amazon API throttle limit

Refund failed: Amazon API throttle limit

Amazon throttles how many API calls can be made in a short window. If too many refunds are submitted in a short period — across all your orders combined — Amazon temporarily refuses additional refund calls and returns an "API throttle limit exceeded" error.

Why it happens

This is most likely if you:

  • Issue many refunds in quick succession (e.g., bulk-refunding a batch of orders).
  • Run other refund-heavy actions on the Amazon account at the same time.
  • Have multiple users or stores hitting Amazon's refund API at once on the same seller account.

The throttle is temporary — Amazon resets the window after a short delay.

Fix it

Wait a few minutes and then retry. On the Orders page:

  1. Find the row with the Failed Refund status and click on Failed Refund.
  2. In the Failed Refund dialog, leave Refund Inventory, Refund Reason (Amazon), and Refund Amount as they are (they're already set from the previous attempt).
  3. Click Confirm.

    • Related Articles

    • Refund failed: partial refund on a multi-product order

      Amazon and Shopify don't handle partial refunds on multi-product orders the same way. If your Amazon order has more than one SKU/product, a partial refund issued in Shopify can be rejected by Amazon when it doesn't include enough information for ...

    • Refund failed: tax or shipping already refunded on Amazon

      Amazon treats tax and shipping as separate, one-time refundable buckets on every order. If those amounts have already been refunded on Amazon, any new refund that includes tax or shipping again is rejected. Why it happens Tax and shipping on an ...

    • Refund failed: refund reason is blank, invalid, or not mapped

      Amazon strictly validates the reason on every refund. If the reason isn't valid, the refund is rejected. There are three ways this commonly goes wrong. 1. The refund reason is blank Shopify lets you issue a refund without typing a reason. Amazon does ...

    • Refund failed: refund amount or scope is wrong

      A refund will be rejected by Amazon when the amount or scope of the refund doesn't match what the original Amazon order can support. These are the three most common amount-related rejections. 1. The refund amount is more than the original order If ...

    • How to resolve "Failed Refund" error?

      The "Failed Refund" error usually happens when the refund reason in Shopify doesn’t match Amazon’s required format or predefined requirements. Check whether the refund meets Amazon’s policies and retry the process. Since Amazon only accepts specific, ...