Settings
Open Add-ons > Manage add-ons > TikTok Shop Connector > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs and webhooks of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. Secrets are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Sync interval (minutes) | 15 | How often stock and price are pushed, orders imported and shipments reported. |
| Status of imported orders | O | |
| Payment method ID for imported orders | empty | Empty = the first active payment method. |
Connection
Section titled “Connection”Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave a secret field empty to keep the saved value.
| Field | Description |
|---|---|
| Mode | Test uses the test app and development shop you saved; Live uses the live app. Both modes call the same TikTok Shop API (open-api.tiktokglobalshop.com); there is no separate sandbox address. |
| App key / App secret | From your app in Partner Center. The secret is stored encrypted and also signs every API call and verifies webhooks. |
| Service ID | Optional. Builds the authorization link on the Connection page. |
| Shop ID or code | Optional. Which authorized shop to use when the seller authorized several. Empty = the first. |
| Handover method | Drop-off or pick-up for packages of orders that TikTok Shop ships (used by “Arrange TikTok Shop shipping”). |
| Weight unit | Unit of the weight field of your CS-Cart products (kilogram, pound or gram); sent as the package weight. |
| Category tree | Automatic: v2 for US, EU and South-East Asia shops, v1 for others. |
Tokens (access token, refresh token) and the authorized shops are stored sealed with the account after you authorize; they are never shown.
Rules, categories and mapping
Section titled “Rules, categories and mapping”- Categories: map each CS-Cart category to a TikTok Shop leaf category (the tree is read live from your shop) and optionally a default brand ID. Attributes of a category (the required ones are marked) are filled from a CS-Cart product feature or a fixed value; a value that is not allowed for an attribute is reported on the product.
- Rules: markup and rounding, stock buffer and minimum, default brand, exchange rate (see below), default package weight, order status mapping, Arrange TikTok Shop shipping (off by default) and I ship orders myself.
- Currency: prices are sent in the currency of the shop region (USD, GBP, EUR, …). If your store currency differs, enter the exchange rate on the Rules page (channel currency per 1 unit of your primary currency).
- The seller SKU of each mapped product is its mapping SKU: it must be unique in your TikTok Shop and is how the add-on finds the TikTok product again for stock and price updates and for imported order lines.
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_tiktok_shop.cronhttps://your-store.example/index.php?dispatch=kv_tiktok_shop.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call, job and webhook with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.
Multi-Vendor
Section titled “Multi-Vendor”In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own account.