Documentation

TikTok Shop Sync — Full Guide

Updated

TikTok Shop Sync — Full Guide (A–Z)

TikTok Shop Sync (tiktok-sync) connects your LiteShoper store to TikTok Shop seller APIs so you can manage catalog, inventory, orders, and fulfillment from one admin while selling on TikTok.

On this page

  1. Overview
  2. Prerequisites
  3. Apply / join TikTok Shop Partner Center
  4. Create a TikTok Shop app
  5. Copy App Key, App Secret & Service ID
  6. Set redirect URI & webhooks
  7. Scopes / API access
  8. Development (sandbox) vs live
  9. Install the plugin
  10. Enter credentials in LiteShoper
  11. Connect (authorize) your shop
  12. Products: import & export
  13. Link inventory
  14. Orders & shipping
  15. Cron
  16. URL reference
  17. Go-live checklist
  18. Troubleshooting

1. Overview

What this plugin does:

  • OAuth connect to TikTok Shop seller accounts (multi-region)
  • Import / export products and map categories
  • Link LiteShoper variations ↔ TikTok SKUs and sync stock
  • Pull orders via webhook + cron
  • Arrange shipment, print AWB / packing / pick lists

2. Prerequisites

  • Active LiteShoper store with HTTPS (required for OAuth + webhooks)
  • tiktok-sync subscription / license from LiteShoper
  • TikTok Shop seller account in your market (e.g. MY, SG, PH, …)
  • Access to TikTok Shop Partner Center to create an app (for your own store integration)

Partner Center is for developers/ISVs building apps. Seller Centre alone is not enough to create App Key / App Secret.

3. Apply / join TikTok Shop Partner Center

  1. Open TikTok Shop Partner Center (region for your market, e.g. global Partner Center). 
  2. Sign in with the account TikTok provides for partners (or register / apply as a developer/partner if prompted). Link register here
  3. Complete any verification TikTok requires (business info, contact, market).
  4. Wait until you can open Apps / My Apps and create a new app.

If you only sell (you are not building a public app for other sellers), you still create an app under Partner Center, then authorize your seller shop to that app.

4. Create a TikTok Shop app

  1. In Partner Center go to Apps → Create app (or Create service).
  2. Choose the app / service type that matches TikTok Shop Open API (seller APIs for products, orders, logistics).
  3. Fill in:
    • App name (e.g. LiteShoper Sync – YourStore)
    • Description (what the app does: sync products, stock, orders with your own store)
    • Contact email / support URL
  4. Save. You will get a Developing app first; production usually needs review / approval later.

5. Copy App Key, App Secret & Service ID

Inside your app details page, copy:

Field Where used
App Key LiteShoper → Integrations → TikTok → Settings
App Secret Same settings (kept encrypted). Also used to verify webhook signatures if no separate webhook secret
Service ID Required for seller authorization / connect flow

Developing tab credentials ≠ Live/Production credentials. Don’t mix them.

6. Set redirect URI & webhooks in Partner Center

OAuth redirect URI

Add exactly (replace with your store domain):

https://YOUR-STORE.com/tiktok/callback

Must be HTTPS and match character-for-character (no trailing slash mismatch).

Webhook callback URL

Use:

https://YOUR-STORE.com/tiktok/webhook

You can also register this from LiteShoper after connecting a shop (TikTok → Settings → Register webhooks).

TikTok signs payloads with HMAC-SHA256 (TikTok-Signature header: t=…,s=…). LiteShoper always verifies signatures.

7. Scopes / API access

  1. In your app, open permission / scope management.
  2. Enable seller APIs needed for:
    • Products / catalog
    • Inventory
    • Orders
    • Fulfillment / logistics
    • Webhooks
  3. If a scope is missing for your app type or region, contact TikTok Partner support to request access, then re-authorize the shop under TikTok → Shops.

8. Development (sandbox) vs live

  • Development: Use Developing App Key / Secret / Service ID + a Development Shop from Partner Center → Development Kits → Development Shops → Authorize App. In LiteShoper, enable Sandbox / Development mode.
  • Live: Use production credentials, authorize your real seller shop, turn Sandbox / Development mode OFF.

TikTok uses the same API hosts for both (auth.tiktok-shops.com, open-api.tiktokglobalshop.com); what changes is credentials + which shop you authorize.

9. Install the plugin

  1. On LiteShoper → TikTok Shop Sync, subscribe / buy license.
  2. Install tiktok-sync on your store and activate.
  3. Open admin: Integrations → TikTok Shop (TikTok menu).

10. Enter credentials in LiteShoper

Go to TikTok → Settings and fill:

  1. App Key
  2. App Secret
  3. Service ID
  4. Default region (e.g. MY, SG, PH)
  5. Optional: Sandbox / Development mode
  6. Optional: Order sync window (days) for manual Sync TikTok Orders
  7. Optional: Webhook secret (leave blank to verify with App Secret)
  8. Select webhook event types to subscribe
  9. Click Save settings

Copy the shown Webhook URL if you need to paste it manually in Partner Center.

11. Connect (authorize) your shop

  1. Go to TikTok → Shops.
  2. Click Connect / authorize.
  3. Log in as the TikTok Shop seller and approve the app.
  4. You return to /tiktok/callback; the shop appears as active.
  5. Then open TikTok → Settings → Register webhooks so order/shop events hit your store in real time.

12. Products: import & export

  • Import from TikTok — pull existing TikTok listings into LiteShoper tooling.
  • Export to TikTok — push LiteShoper products (batch modal supported).
  • Use category recommendation / set TikTok category manually if empty.
  • Fix titles if export reports title errors (follow on-page title_fix hints).

13. Link inventory

  1. Open TikTok → Link Inventory.
  2. Map LiteShoper variations to TikTok product / SKU IDs.
  3. Enable inventory sync per shop.

14. Orders & shipping

  • Orders sync via webhook + cron poll.
  • View under TikTok → Orders or Orders → TikTok tab.
  • Arrange shipment (pickup / drop-off options as TikTok provides).
  • Print AWB, packing list, pick list from the plugin tools.

15. Cron

Hit every 5–15 minutes (secret from TikTok → Settings):

GET https://YOUR-STORE.com/cron/tiktok-sync?token=YOUR_CRON_SECRET

Use system cron, hosting cron, or an uptime monitor.

16. URL reference

Path Purpose
/tiktok/callback OAuth redirect after seller authorize
/tiktok/webhook Order / catalog / shop events (signed)
/cron/tiktok-sync Background worker (token required)

17. Go-live checklist

  1. Partner app approved / production credentials ready
  2. Redirect URI + webhook URL registered and HTTPS works
  3. Scopes granted; shop re-authorized after scope changes
  4. Sandbox mode OFF for live shop
  5. Webhooks registered and events received
  6. Cron running every 5–15 minutes
  7. Test: 1 product export, 1 stock change, 1 order sync, 1 arrange shipment

18. Troubleshooting

  • Webhook 401 — signature mismatch; check App Secret / webhook secret; re-register webhooks.
  • OAuth redirect error — redirect URI must match exactly https://YOUR-STORE.com/tiktok/callback.
  • Missing Service ID — set it under TikTok → Settings before Connect Shop.
  • Scope missing — request access in Partner Center, then reconnect shop.
  • Export title errors — fix titles using export page hints.
  • Arrange shipment errors — ensure shop_id and order id are present.
  • Empty category — run category recommend or set category manually.
  • Dev vs live mismatch — Developing credentials only work with Development Shops.

← All docs · Plugin page: tiktok-sync

← All docs

LiteShoper Help Answers from plugins, docs & FAQs

Hi! Ask me about LiteShoper plugins, licenses, or documentation.