Overview

If you use Happy Returns to manage your Shopify returns, you can also use it to manage your TikTok Shop order returns through AfterShip Feed.

With this integration, AfterShip Feed connects Happy Returns and TikTok Shop, allowing your team to continue managing return requests and refunds from the Happy Returns portal while keeping Shopify and TikTok Shop synchronized.

How the Happy Returns integration works

Buyer journey

Return request flow

In Happy Returns, the seller can configure which return methods to offer buyers — Mail return, Return Bar, or both. The following sections explain how a return request moves from the buyer to the refund.

Scenario A: Mail return (Shipping label)

In this scenario, the buyer receives a shipping label with a tracking number. The seller can trigger the refund from the Happy Returns portal at any time after the return merchandise authorization (RMA) is created.

Scenario B: Return Bar (QR code drop-off)

In this scenario, the buyer receives a QR code and drops off the package at a Happy Returns Return Bar. Happy Returns manages all shipping and inspection, and then sends a webhook to AfterShip Feed to trigger the refund.

AfterShip Feed triggers the TikTok Shop refund only after Happy Returns accepts the returned items.

Setup Checklist

Before enabling Return & Refund Sync, make sure the following requirements are met:

This is a whitelist feature. Contact AfterShip Support to check your eligibility and get your store enabled.
If you want to offer Return Bar drop-off, you also need a Happy Returns retailer ID for the Headless API, and refund_on_dropoff must be configured in your Happy Returns account settings.
Enable Auto-link product SKUs and Order sync in AfterShip Feed.
Your TikTok Shipping Method is configured as Seller Shipping. TikTok Shipping is also supported if the buyer's address is not encrypted.

Enable Return & Refund Sync

In AfterShip Feed, go to Settings > Return and refund sync.
Turn on the Return sync toggle.
Select Manage using a returns app.
Connect a Return app (Happy Returns).
Click Save.

Limitations

When a buyer uses Speedy Refund, AfterShip Feed cannot reject the refund if the returned item fails the Happy Returns inspection or if the seller rejects the return in the Happy Returns portal.

In this case, the seller must submit a post-refund appeal in TikTok Shop Seller Center (Manage Returns/Refunds) to request compensation.
Speedy Refund is a TikTok Shop program that refunds buyers immediately after they drop off their return package with the carrier, before the seller inspects the returned item.
When Speedy Refund is used with Happy Returns, the refund is issued regardless of the inspection result.

For more information about Speedy Refund, refer to the following TikTok Shop documentation:

Key takeaways

Use Happy Returns to manage returns for both Shopify and TikTok Shop orders through AfterShip Feed.
Continue handling return requests and refunds in the Happy Returns portal, while AfterShip Feed keeps Shopify and TikTok Shop synchronized.
The integration supports both mail returns (shipping label) and Return Bar (QR code drop-off) workflows.
Before enabling the integration, ensure your store meets all setup requirements, including the required whitelists, Happy Returns configuration, and AfterShip Feed settings.
Buyers using Speedy Refund may receive refunds before the returned item is inspected. If an item fails inspection, you'll need to submit a post-refund appeal in TikTok Shop Seller Center.