Step-by-step setup for the Loop x TikTok Shop returns integration

This guide walks you through every step required to set up the Loop x TikTok Shop returns integration. It supplements the main TikTok Shop Integration for Returns help center article and is designed to give you everything you need to get live without the back-and-forth.

The integration is powered by Silk Commerce and connects TikTok Shop, Shopify, and Loop Returns. Once configured, returns approved in TikTok Shop are automatically created in Loop, shipping labels are generated and synced back to TikTok Shop, and return statuses stay in sync across all three systems.

We've tried to make this guide as thorough as possible, but if you get stuck at any point, please don't hesitate to reach out to your Loop MSM or to support@loopreturns.com. We want to make this as easy for you as possible.

Time estimate: The full process typically takes 30–60 minutes if you have all your account credentials ready.

• Shopify admin access – to install the Silk app and authorize store data access.

• Loop Returns admin access – to generate an API key, modify workflows, and update return policies.

• TikTok Shop Seller Center owner account access – to authorize the app and configure return settings.

• SKUs must match exactly between TikTok Shop and Shopify. The integration matches return items by SKU. Mismatched or missing SKUs will cause return creation to fail.

• TikTok Shop orders must sync to Shopify before returns can be processed. Confirm your connector (Silk, AfterShip, ShoppeDance, or native) is working properly.

• Only orders placed after setup will be processed. Historical orders are not retroactively synced.

If you use a connector to sync TikTok Shop orders to Shopify, disable any return or refund sync on that connector first. Running two return sync processes simultaneously causes data conflicts.

Disable exchanges and replacements

The integration does not currently support exchanges or replacements for TikTok Shop orders (a TikTok API limitation). To prevent customers from selecting an unsupported option:

1. In Seller Center, go to Orders > Return Settings > Exchanges and Replacements.

2. Toggle both Exchange and Replacement to OFF and click Save.

Note: Exchange support is expected in Q3 2026. We’ll update this guide when available.

Confirm your return window

TikTok Shop enforces a minimum 30-day return window. Note this — your Loop return window must match or exceed it (see Step 3).

This is the most commonly missed part of onboarding. Your Loop configuration must align with TikTok Shop’s return rules to prevent sync failures.

Return window

Your Loop return window must be at least 30 days for TikTok Shop orders. If your DTC window is shorter, you’ll create a workflow to extend it for TTS orders in Step 4.

Refund settings

• Refund to original payment method only. TikTok Shop does not support store credit, gift cards, or off-platform vouchers.

• No partial refund workflows for TTS orders. Partial refunds create reconciliation gaps between systems.

• No return shipping fees charged through Loop. TikTok Shop handles return shipping separately.

Shipping labels

To auto-generate return labels, confirm that Generate Labels is enabled in your Loop return policy (Return Policies > edit your policy). This is required for the Silk app to create and sync labels to TikTok Shop. Additionally, please make sure the “Auto Create Label” setting in the Silk app is also turned on.

Processing events

We recommend setting your processing event to On Delivery for TTS returns. Configure this under Return Outcomes in your return policy, or via a workflow (Step 4).

This step is critical. Most onboarding issues stem from existing Loop workflows designed for DTC orders that unintentionally block TikTok Shop returns. You need to review every active workflow and ensure TTS orders are not affected by DTC-specific rules.

Note: When a TikTok Shop customer initiates a return, the Silk integration creates that return in Loop via API. If your workflows require steps the API can’t fulfill — like uploading photos, answering pre-review questions, or meeting a minimum order value — the return creation will fail silently and the return won’t sync.

Common workflow conflicts

Any of the following elements being in your Loop Workflows will create errors

How to fix: Use a non-TTS order tag to scope your workflows

Loop’s workflows apply their rules when a condition is met. To ensure your existing DTC workflow rules only apply to DTC orders (and not TTS orders), you’ll add a condition based on an order tag that is present on your non-TTS orders.

1. Identify or create your non-TTS order tag

You need an order tag in Shopify that is applied to your DTC (non-TikTok) orders. Many merchants already have one — common examples include “DTC”, “Web”, or “Shopify”. If you don’t already have one, you can create a Shopify Flow automation to tag all non-TTS orders with a tag like “DTC”.

The key idea: TikTok Shop orders will not have this tag, so any workflow conditioned on it will automatically be skipped for TTS orders.

2. Add the tag condition to each existing workflow

For each workflow that could conflict with TTS returns:

1. In your Loop admin, go to Returns Management > Workflows.

2. Open the workflow you want to modify.

3. Add a new condition as the first step in the workflow.

4. Set the condition to: Shopify Order Tag > equals > [your non-TTS tag] (e.g., “DTC”).

5. On the “If True” branch (the order IS a DTC order): keep your existing workflow logic.

6. On the “If False” branch (the order is NOT a DTC order, i.e., it’s a TTS order): leave it empty — no action.

7. Save the workflow.

Repeat for every active workflow that could affect TikTok Shop returns.

Create a dedicated TTS workflow (recommended)

We strongly recommend creating a separate, simplified workflow specifically for TikTok Shop returns. This workflow should:

• Limit outcomes to refund only – condition on a TTS-specific order tag (e.g., “TikTok”) and restrict to Refund to Original Payment Method.

• Extend the return window to at least 30 days – TikTok may extend to 45 or 90 days during holidays, so plan accordingly.

• Skip all pre-review questions and image uploads – keep the TTS workflow clean and simple.

• Set processing to On Delivery – improves your After-Sale Handling Time score.

• Remove handling fees or set a fixed flat rate – no percentage-based fees.

Create your Silk account

1. Go to the Silk Loop Returns Integration App and click Sign Up.

2. In the Channel field, select your Shopify-TikTok connector (e.g.TikTok Shop for Shopify, AfterShip, ShoppeDance, SKU IQ).

3. Agree to the Terms of Service and click Register.

Note: If your team already uses the Silk Connector for order syncing, register with a different email address. The standalone return app uses a separate account system.

Subscribe

The subscription is $14/month (paid to Silk Commerce, not Loop) and includes unlimited return requests, automatic TikTok Shop sync, custom return reason mapping, and priority support.

Authorize the three platforms

Authorization happens in order: Shopify → Loop Returns → TikTok Shop.

A. Connect Shopify

1. Click the button to go to the Shopify App Store, log in to your Shopify admin account if prompted, and click Install App.

B. Connect Loop Returns

1. In your Loop admin, go to Returns Management > Tools & Integrations > Developer Tools > API Keys.

2. Click Generate New API Key.

3. Select permissions: Cart, Return, Order, Developer Tools, Create Returns (read & write),Destinations(read),Happy Return Shipments(read).

NOTE: if you don’t see those scopes, reach out to your Loop MSM or to 

support@loopreturns.com and request that “Draft Returns” be enabled for your 

account.)

4. Name the key (e.g., “Silk TTS Integration”), click Generate, and copy it into the Silk app’s Loop API Key field.

C. Connect TikTok Shop

1. Click “Authorize TikTok Shop” in the Silk app, then log in to your TikTok Shop owner account to complete the authorization. In TikTok Shop Seller Center, confirm the shop, set partner access duration, and click Authorize.

2. After the success message, click Done and return to the Silk app.

In your Silk dashboard, go to Settings > General Settings and configure:

• Return reason mapping: Map each TikTok Shop return reason to a corresponding Loop reason (parent + child). Reason names are case-sensitive and must match your Loop configuration exactly. No defaults are pre-configured.

• Reject reason: Set the reason synced to TikTok Shop when you reject a return in Loop.

• Auto-create shipping label: Enable this toggle if you want labels auto-generated for TTS returns. Requires Generate Labels to be on in your Loop return policy (Step 3).

Before going fully live, test with at least one return:

1. Have a test customer place a small order on TikTok Shop and wait for it to sync to Shopify.

2. Initiate a return in TikTok Shop.

3. Verify the return appears in Loop within a few minutes.

4. Confirm a shipping label was generated (if auto-create is on) and synced back to TikTok Shop.

5. Process the return in Loop and verify the status syncs back to TikTok Shop.

Note: TikTok Shop does not offer a staging environment. Testing happens in production, so use a low-value order.

What if my DTC return window is shorter than 30 days?

Create a workflow that extends the return window for TikTok Shop orders. If a TTS return falls outside your Loop window, return creation will fail.

What happens if I don’t update my workflows?

Any workflow that blocks or adds requirements to TTS orders will cause return creation failures. The return will be approved in TikTok Shop but won’t sync to Loop.

Can I process TikTok Shop returns the same way I process DTC returns?

Yes. Once the return is created in Loop, you process it exactly the same way. Loop automatically syncs the status back to TikTok Shop.

Do I need to keep using TikTok Shop Seller Center?

Mostly no. The main exception is if a return requires manual approval in TikTok Shop before it can sync to Loop — this happens in roughly 5% of cases based on TikTok’s policies.

What are “refund-only cases” in TikTok Shop?

When TikTok refunds the buyer without requiring a physical return. These appear in Loop as “Keep Item Returns” for record-keeping and cannot be rejected.

What if I’m not using Silk Commerce as my Shopify-TikTok connector?

The app supports Silk Commerce, AfterShip, ShoppeDance, SKU IQ and TikTok’s native connector. Setup steps are the same — just select your connector during registration and disable return/refund sync on it first.

We know there’s a lot to get through here, and every merchant’s setup is a little different. If anything is unclear or you run into an issue we haven’t covered, reach out to your Loop MSM or email support@loopreturns.com and we’ll help you get sorted. We want this to be as smooth as possible for you.