This guide shows how to use Loop as the returns platform for your TikTok Shop orders, with Pipe17 acting as the bridge between TikTok Shop and Shopify.
Loop reads orders and writes refunds in Shopify. TikTok Shop doesn't integrate with Loop directly, and TikTok Shop's own Shopify connector cannot satisfy Loop's lookup requirements. Pipe17 closes the gap by pulling orders from TikTok Shop, writing them into Shopify in a format Loop can find, and propagating refunds back to TikTok Shop.
Things to know up front:
- TikTok Shop's H5 Redirect feature is required. It is a whitelisted, non-public feature. Your TikTok Shop Account Manager must request approval before this integration will work.
- Shopify is required. Loop does not yet support multi-channel lookups, so the merchant must have a Shopify account. Pipe17 uses Shopify as the order-of-record so Loop can find orders.
- Customers must use the shipping address zip code, not their email. TikTok Shop does not share the buyer's email, so Loop cannot match returns by email.
How the integration works
Order flow:
- A buyer places an order on TikTok Shop.
- Pipe17 pulls the order from TikTok Shop.
- Pipe17 writes the order into Shopify in a way that lets Loop look it up.
- Pipe17 pulls fulfillment data from Shopify and pushes it back to TikTok Shop.
Return flow:
- The buyer clicks the return link in TikTok Shop and is redirected (via H5 Redirect) to the merchant's Loop return portal.
- The buyer enters the TikTok Shop order number and the shipping address zip code.
- Loop creates the refund in Shopify.
- Pipe17 pulls the refund from Shopify and pushes it to TikTok Shop.
Before you begin
- An active TikTok Shop account and a Shopify store connected to the same Pipe17 account.
- A Loop Returns account connected to your Shopify store.
- Approval from TikTok Shop for the H5 Redirect feature (see Step 1).
- Your TikTok Shop Account Manager contact.
- Your Loop return portal URL.
Step 1: Get H5 Redirect approved by TikTok Shop
H5 Redirect is the feature that allows TikTok Shop to send buyers to your Loop return portal instead of TikTok's default return flow.
- Contact your TikTok Shop Account Manager.
- Request an exception to TikTok Shop's default platform return process and ask for approval for the H5 Redirect feature.
- Wait for written confirmation from TikTok Shop before continuing. Subsequent steps depend on this approval.
Step 2: Configure TikTok Shop in Pipe17
- If TikTok Shop isn't connected yet, connect it as described in Connect TikTok to Pipe17.
- On the TikTok integration's Settings tab, turn on the following settings:
- Pull orders from Tiktok
- Push fulfillments information to Tiktok
- Push refunds to Tiktok
Step 3: Configure Shopify in Pipe17
Shopify is configured as a downstream fulfillment destination for TikTok Shop orders, not as a parallel sales channel. The merchant's existing Shopify sales continue to work normally - Pipe17 simply routes TikTok Shop orders into Shopify so Loop can find them.
- If Shopify isn't connected yet, connect the Shopify V3 integration as described in Connect Shopify to Pipe17.
- On the Shopify integration's Settings tab, set the following:
- Process orders information: Push orders to Shopify, or Push and pull orders if you also pull your Shopify store's own orders into Pipe17.
- Process fulfillment information: Pull fulfillments from Shopify, or Push and pull fulfillments if you also push fulfillments to Shopify.
- Process refunds: Pull refunds from Shopify to Pipe17.
- Configure Shopify as a fulfillment destination, not a sales channel. This is done in the Outbound Orders Matching section of the Shopify settings:
- Add or edit the rule that targets TikTok Shop orders (for example, with Apply rules below only to orders with matching Pipe17 order sources).
- Set the rule's Order Flow to Matched orders should be pushed to Shopify for fulfillment process. The default is Matched orders should be pushed to Shopify for order tracking.
- Save.
- Optional: if you also pull returns from Shopify (Process returns), add Loop to Pull returns not created with following Shopify Apps. This stops Pipe17 from pulling returns that Loop created in Shopify as duplicate return records. This setting filters returns only; it doesn't filter refunds.
Run a test TikTok Shop order at this point and confirm it appears in Shopify with the expected structure before continuing.
Step 4: Install the TikTok Shop Return Proxy App
- Open the TikTok Shop Return Proxy App authorization URL:
https://services.us.tiktokshop.com/open/authorize?service_id=7252639977727674154 - Authorize the app against your TikTok Shop account.
- In Seller Return Portal Settings, under Select return portal partner, select Loop (Pipe17).
- Under Confirm the return portal URL, enter:
https://{RETURN PORTAL URL}/?order=[TT_ORDER_NUM]&zip=[TTS_ZIP_CODE]Replace{RETURN PORTAL URL}with your Loop return portal URL. Leave the[TT_ORDER_NUM]and[TTS_ZIP_CODE]placeholders as-is - TikTok Shop substitutes them at runtime. - Click Update.
Step 5: Update your Loop return portal
TikTok Shop buyers will look up their returns by TikTok Shop order number and shipping address zip code. Email lookup will not work because TikTok Shop does not share buyer email addresses.
- Log in to the Loop dashboard.
- Open the return portal settings.
- Update the portal instructions to clearly tell customers:
- Enter the TikTok Shop order number.
- Enter the shipping address zip code (not email).
- Make the instructions prominent on the portal landing screen.
- Save your changes.
Step 6: Test the return flow end-to-end
- Place a test order on TikTok Shop.
- Confirm the order syncs to Shopify through Pipe17.
- Initiate a return on the TikTok Shop side and confirm the buyer is redirected to your Loop return portal via H5 Redirect.
- Complete the return in Loop using the TikTok Shop order number and zip code.
- Confirm the refund is created in Shopify.
- Confirm Pipe17 pulls the refund from Shopify and pushes it to TikTok Shop.
- Verify the refund appears against the original TikTok Shop order.
Limitations
- Shopify is required. Loop currently does not support multi-channel lookups. This requirement will be removed when Loop adds multi-channel support.
- Email lookup is not supported. Customers must use the shipping address zip code, because TikTok Shop does not share buyer emails.
- TikTok Shop's default Shopify connector cannot be used in place of Pipe17. It does not write orders into Shopify in the format Loop needs.
Troubleshooting
- H5 Redirect isn't redirecting buyers to my Loop portal
Confirm TikTok Shop has approved H5 Redirect for your account in writing. Without approval, the redirect does not activate. Also re-check the return URL configured in Step 4 - the[TT_ORDER_NUM]and[TTS_ZIP_CODE]placeholders must remain exactly as given. - Loop cannot find a TikTok Shop order
Confirm the order has been written into Shopify by Pipe17. Open the order in Shopify and check that the structure matches what Loop expects for lookup. If the order is missing from Shopify, verify Process orders information pushes orders to Shopify and that the Outbound Orders Matching rule is set correctly (see Step 3). - TikTok Shop orders are appearing in Shopify as direct sales rather than fulfillment records
The Outbound Orders Matching rule for TikTok Shop orders is not set to the fulfillment-destination option. Open the rule, set Order Flow to Matched orders should be pushed to Shopify for fulfillment process, and save. - A refund processed in Loop isn't appearing in TikTok Shop
Trace the refund through the chain:- Confirm Process refunds is set to Pull refunds from Shopify to Pipe17 on the Shopify integration. The refund should appear in Pipe17 once Loop creates it in Shopify.
- Confirm Push refunds to Tiktok is turned on for the TikTok integration.
- If both are set correctly and the refund is still missing, contact Pipe17 support.
- Returns or refunds are appearing twice on TikTok Shop orders
If returns are duplicated and you pull returns from Shopify, add Loop to Pull returns not created with following Shopify Apps on the Shopify integration. That setting doesn't filter refunds, so if refunds are duplicated, contact Pipe17 support with the order number. - Customers say they can't find their order using their email
Expected. TikTok Shop does not share buyer emails. Update your Loop return portal instructions (Step 5) to make clear that customers must use the shipping address zip code. - Fulfillment status isn't flowing back to TikTok Shop
Confirm Process fulfillment information pulls fulfillments from Shopify on the Shopify integration and Push fulfillments information to Tiktok is turned on for the TikTok integration.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We’re here to help you succeed with your operations.
Comments
0 comments