Needs Review + Return Processing Errors


If a return hits an error when processing, it will drop into the Needs Review tab within the Loop admin and will require your attention. Needs Review is a critical area of the admin for managing returns that are flagged for review either by a ruleset, a manual action, or an error that prevents a return from processing.

In this article you will learn about:

  • Needs Review State 
  • Out of Stock Items
  • Refund Errors
  • Other Needs Review Errors

Needs Review State

Needs Review errors generally fall into one of two categories –  out of stock or refund errors. International Lite returns will also appear in this section, unless Bypass Review is enabled on the return policy. To access returns that have encountered an error, follow these steps: 

  1. Navigate to the Loop admin
  2. Select Returns
  3. Select Needs review
  4. View the return order to understand what action is needed

Out of Stock Items

When a customer requests an exchange, Loop does not immediately notify Shopify. Instead, Loop will process the outcome for the customer based on your processing event. This delay between the customer requesting their exchange and the exchange order being created occasionally leads to an "Out of Stock" error.

Customer + Loop Admin Impact

When an exchange item goes out of stock and the return processing event is triggered:

Possible Solutions

If the product is coming back into stock soon:

  1. Notify the customer of the restock date
  2. When the Shopify inventory is replenished, use the Process Items button in the Return Details page to re-trigger the creation of the Exchange order

Note: Loop will only Process previously Out of Stock items, if other outcomes have already been provided, you are not at risk of them being issued again.  

If that product is not coming back into stock, or if the customer does not want to wait:

  1. Work with the customer to determine an acceptable new outcome (Refund or Gift Card for the value of the original return product)
  2. Manually process the exchange in the Return Details

Note: Visit Automate Out-of-Stock Exchanges for more detail

Refund Errors

Returns will not be able to process when the amount of money left on the Shopify order does not match the amount Loop is attempting to refund, which is defined as a 'refund error'.

This will most often occur when:

  • The merchant is using a third party billing system that Loop can’t leverage to directly issue refunds
  • A partial refund has been issued through Shopify prior to processing the return in Loop. This will create an imbalance in what Loop is trying to refund, and how much value is left on the original order.
  • Shopify rejects a return due to accounting, inventory mismatches or other technical issues.

Note: There are other reasons why this error may emerge. If you don't suspect that one of the above are the case, please reach out to

Customer + Loop Admin Impact

  • The return will move into the Needs Review tab in the admin, and the return detail will show an ⚠︎ Refund Error tag and a Return History Note.
  • No notification will be sent to the customer, the return will remain open until an admin intervenes


Use the Close button in the Return Details page to treat the return as complete in Loop and manually issue the outcome needed in Shopify.

Needs Review Browser Notifications

When Needs Review errors occur, merchants can enable a Mac browser notification to alert them of a return that requires attention in Loop. Currently, notifications can only be configured on Firefox and Chrome browsers.

To enable this setting:

  • Navigate to the top right hand side of Loop under the Loop admin name and click Preferences:

  • Toggle on Needs Review Notifications:

  • If this does not enable, a notification setting will appear on the address bar to unblock/allow browser notifications from Loop:
Click 'Allow for this site'
Click 'Allow for this site'

Note: This is a device-level setting, not user-level. If a device is subscribed to receive browser notifications from Loop, all users on that workstation will then receive these notifications.


Needs Review Error Types Defined:

  • Exchange Error - includes errors occurring during placing exchange orders
  • Gift Card Error - includes errors occurring when ordering a gift card
  • Instant Error - covers failed charges and returns after successful charges for instant exchanges and instant refund returns
  • Out of Stock - covers exchanges that go out of stock for merchants without automated OOS functionality or if there was an error in the automated process
  • Refund Error - includes refunds or returns that Shopify rejects due to accounting, inventory mismatches, or technical errors
  • Restock Error - includes errors occurring when restocking items
  • Shopify Error - error response received from Shopify
  • Other - other technical error
  • Return Policy - flagged via return policy (international)
  • Manual Review - flagged directly In admin
  • Warehouse - flagged via the API
  • Workflow - flagged via a configured Workflow rule
  • Delivery Error - includes returns for shipments where an error is present that may prevent the package from being delivered back to the merchant, such as the packing being lost

Outside of processing issues above, will any other returns be sent to Needs Review? Yes, by default any returns tied to secondary Return Policies, which includes International returns, will appear under Needs Review. You can bypass this by activating the Bypass Review switch within that policy.

Why are my Needs Review browser notifications not working? Please also confirm that your Mac system settings are configured to allow for browser notifications by navigating to: Mac System Settings > Notifications > Google Chrome or Firefox > Notifications (toggled on).

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.