Last updated: Nov 18, 2026 at 11:12AM
When a customer starts a return on a marketplace, Osello pulls it in, walks it through acceptance, receipt, and refund, and records the outcome in your Shopify store so your books stay straight.
Where returns show up
Osello checks your marketplaces for new and updated returns about every 15 minutes. A return appears in the Returns card on its order's page, and the order carries a Return in progress badge while the return is open. Click the return to open its own page with the returned items, quantities, refund amount, and current status.
Walking a return through
The return's actions menu offers each step as it becomes relevant:
- Accept — agree to take the return. The marketplace is told you'll process the refund, and the customer sends the items back.
- Mark as received — confirm the returned items have physically arrived at your warehouse. The marketplace is notified, and if you restock returns in Shopify, the items go back into stock. This stays available after the marketplace reports its own receipt, and even after a refund, because only your confirmation puts items back on your shelf.
- Refuse — decline the return on the marketplace. The customer is not refunded.
- Refund — the final step: issue the refund and close the return on the marketplace.
- Cancel return — close out a return that's no longer going ahead.
Some marketplaces handle parts of this on their side — accepting the return themselves, or confirming receipt at their own facility. Osello picks those changes up on its regular checks and moves the return's status forward automatically, so you only act on the steps that are actually yours. The return's Details panel shows who reported each step: the marketplace, your Shopify store, or the person on your team who did it in Osello. A receipt at a marketplace's own store location is recorded as the marketplace's, and your warehouse's receipt as yours.
You can also do these steps in Shopify. Marking returned items as received or restocked on the Shopify return tells Osello you have them, and closing the return in Shopify closes it on the marketplace as well. Reopening a return in Shopify only reopens it there: marketplaces cannot take a return back once it is closed and a refund cannot be reversed, so Osello keeps the return as the marketplace has it and flags a sync issue on it to say so.
A few marketplaces pay the customer back before they finish closing the return on their end. When Osello sees that the marketplace has already refunded every item on a return, it marks the return Refunded and records the refund in Shopify right away, rather than waiting for the marketplace to catch up. A return can jump straight to Refunded this way, skipping the steps in between — the money has already moved, so there's nothing left for you to do. If only some of the items have been refunded, Osello waits until the rest are, so your Shopify order never shows a partial refund that doesn't match what the customer actually received.
How refunds are recorded
The marketplace collected the customer's payment, so the marketplace is the one that pays the customer back. Osello's job is to keep your records straight: when a return is refunded, Osello records the return and its refund on the matching order in your Shopify store.
If you've turned on the restock option in your Shopify integration settings, Osello also restocks the returned items in Shopify, but only once you have confirmed receipt or the return is closed. A refund on its own is not proof the goods are back: some marketplaces pay the customer before anything has shipped, so the refund is recorded in Shopify right away and the restock follows later. A marketplace saying it received the items does not count either, since that can mean the parcel reached one of the marketplace's own store locations rather than your warehouse.
When the marketplace reports tracking for the customer's return shipment, Osello adds the tracking number and link to the return in Shopify, where it shows as the return's shipment. This works for marketplaces that share return tracking: Target+, and Macy's, Nordstrom, Bloomingdale's and other Mirakl-based marketplaces. If tracking arrives or changes later, Osello updates the Shopify return while it is still open. Your customer is not emailed by Shopify about it, and a return shipment you added in Shopify yourself is left as it is.
When the marketplace closes the return, Osello closes the matching return in Shopify too, so Shopify shows it as returned rather than leaving it open.
On the order's page, refunded money shows up in the Details panel as a Refunded amount alongside the Net Total, and the order's status moves to Refunded (or Partially Refunded when only some items were refunded). The Net Total is the order total including tax, minus what was refunded. When the marketplace doesn't report how much it refunded, Osello estimates it from what the customer paid for the returned items, tax included.
A refund with no return behind it shows the same way, such as one you make on Macy's for an order you couldn't ship. Osello marks the refunded items and the order Refunded and records the amount the marketplace paid back.
Refunds and returns you make in Shopify
A refund or return you make on a marketplace order in Shopify stays in Shopify. The marketplace took the customer's payment, so only the marketplace can pay it back: the customer gets no money, and the marketplace still shows the item as shipped. Osello does not refund or return anything on the marketplace for you. It keeps the order as the marketplace has it and puts a Refunded in Shopify but not on marketplace error on the order page, naming the items. The order also counts as out of sync on your dashboard and Orders list.
Contact the marketplace right away and ask them to cancel, refund or return the item. A customer who is still waiting may leave a bad review for an order that never arrived before they ask the marketplace for a refund. Then choose Mark as resolved on the error. Osello resolves it for you once the marketplace shows those items refunded or a return for them.
An item that already has a marketplace return raises no error: that return pays the customer back. Neither does a refund Osello recorded in Shopify for a marketplace return.
On the order's page, each refunded item says under its status who initiated the refund: the marketplace, or Shopify when you refunded it there first.
Refunding an item that hasn't shipped yet is different: that cancels the item on the marketplace.
Tax on refunds
The refund Osello records in Shopify matches what that Shopify order charged, which is not always what the marketplace refunded.
Most marketplaces report an order's sales tax only once the order ships, and that is after Osello has already created the order in Shopify. Osello does not go back and rewrite an order you may have already reconciled, so those orders stay in Shopify without tax. When a return comes in, the marketplace's refund covers the item plus the tax it collected, but Shopify only ever charged for the item. Refunding the tax too would take money off an order that never collected it, so Osello records the item amount and leaves the tax out.
The same goes for every order when Include Tax in Pushed Orders is turned off in your Shopify integration settings. Those orders reach Shopify without tax, so their refunds leave the tax out too. New Shopify connections start with this setting off.
Where the Shopify order does carry tax on the returned items, the refund includes the tax, matching the marketplace.
When tax doesn't divide evenly across units, for example 6.37 of tax on two units, the marketplace and Shopify can each put the odd cent on a different unit. Osello records the marketplace's amount, so once every item is refunded the Shopify order is refunded in full.
Either way the customer gets their full refund from the marketplace. The amount in Shopify reflects what Shopify charged, and Osello's own order page always shows the marketplace's full refund.
Target+ returns
Target+ runs returns itself. It takes the item back at a store or by mail, refunds the customer and charges you for the return, so there is nothing for you to accept, refuse or refund. Osello records what Target+ did:
- Each returned item is its own return in Osello and in Shopify. A customer who brings back three items shows as three returns on the order.
- A return shows as Accepted as soon as Target+ lists it, and as Refunded once Target+ has processed it. That is usually within a day of a store return, or within a day of the carrier picking up a mailed one. When Target+ lets the customer keep the item, the return is refunded right away.
- Target+ doesn't report refund amounts, so Osello estimates the refund from what the customer paid for the item.
- When nothing is coming back to you (Target+ destroyed the item, the customer kept it, or Target+ closed the return), Osello closes the return in Shopify and restocks nothing.
- When Target+ ships the item back to you, or the customer mails it to you directly, Osello adds that parcel's tracking number to the return in Shopify. Target+ gives a tracking number and no tracking link. The customer's parcel to Target+'s own return center is not shown, since it is not coming to you.
- When the item is on its way back to you, the return stays open. Use Mark as received once it arrives, or receive it on the Shopify return. That is the only step that restocks a Target+ return, and only if the restock option is on in your Shopify integration settings.
A small share of store returns are listed by Target+ and never processed. Those stay at Accepted with no refund recorded. If Target+ later closes one without processing it, Osello marks it Canceled.
Osello brings in Target+ returns made from the day it first checked your Target+ channel for returns. Earlier returns are not imported. Contact us if you want them brought in.
Return statuses at a glance
A typical return moves Pending Acceptance → Accepted → Received → Refunded. Returns you decline show Refused, and abandoned ones show Canceled. The status badge updates live while Osello is syncing a step, so you can watch a refund land without refreshing.
