Refund failed: missing item-level detail

Refund failed: missing item-level detail

Amazon requires every refund to be described at the item level — which SKU/product, how many units, and how much for each. If the refund the app submits is missing any of that detail, Amazon rejects the whole refund.

Why it happens

Shopify allows refunds that aren't tied to specific items — for example:

  • A flat-dollar refund (a "goodwill" $10 refund without picking specific SKUs/products).
  • A refund where line-item quantities or prices were left blank.
  • A refund covering items that no longer exist on the order (e.g., you removed a line in Shopify before refunding).

When Shopify sends the app a refund without item-level breakdown, the app can't construct a valid Amazon refund — Amazon needs SKU + quantity + amount per item, every time.

Fix it

On the Orders page, find the row with the Failed Refund status and click on Failed Refund. In the Failed Refund dialog:

  • Tick each SKU/product that's actually being refunded.
  • Set Refund Inventory (quantity) for each one.
  • Set the Refund Reason (Amazon) for each one.
  • Set the Refund Amount for each ticked SKU/product so the totals add up to what you intended to refund.

Click Confirm. The app sends Amazon a per-SKU refund with the detail it needs.

Avoid it next time

Issue refunds in Shopify by selecting the items and quantities rather than entering a flat dollar amount. That way each refund carries the per-SKU detail Amazon expects.

    • 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: 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 ...

    • 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: 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" ...