Documentation & Help

🚀 Setup from Scratch

Complete these 8 steps to go from zero to a fully automated multi-platform sync. Each step takes 1–2 minutes and links to the exact page in the app.

1

Register your account

Go to https://tiktokshop.rajangupta.com/register and create your account. Enter your name, email address, and a password, then click Create Account. Check your inbox for a verification email and click the confirmation link.

2

Verify email and sign in

Click the link in the verification email, then sign in at https://tiktokshop.rajangupta.com/login with your email and password. You will land on the Dashboard.

3

Connect TikTok Shop (onboarding wizard)

The onboarding wizard launches automatically on first login. When prompted to connect TikTok Shop, navigate to Settings → Connections → TikTok Shop → Add. You need four credentials from TikTok Shop Partner Center → Apps → API Keys: App Key, App Secret, Access Token, and Shop Name/ID. Fill in all four fields and click Save Connection.

💡 Tip: The app handles the OAuth flow automatically once you enter your App Key and App Secret — you do not need to manually generate the Access Token URL.
4

Connect your store (WooCommerce or Shopify)

Still in the wizard, connect your ecommerce store. For WooCommerce: navigate to Settings → Connections → WooCommerce → Add — you need your Store URL (with https://), Consumer Key (ck_…), and Consumer Secret (cs_…) from WooCommerce → Settings → Advanced → REST API. For Shopify: navigate to Settings → Connections → Shopify → Add — you need your store URL (yourstore.myshopify.com, no https://) and an Access Token (shpat_…) from Shopify Admin → Apps → Develop apps. See the full connection guides in this documentation for step-by-step instructions.

5

Run your first product sync

Go to Dashboard and click the Sync Products button. A progress modal shows the sync running in real time. When it completes, click Products in the sidebar to see your imported catalogue. Check the product count and look for any red error rows in the sync log.

6

Set a price rule

Navigate to Pricing → Price Rules → Add Rule. Select a source platform (e.g. TikTok Shop), a target platform (e.g. WooCommerce), and a rule type such as % Markup with a value of 10 to keep your WooCommerce prices 10% above TikTok. Click Save Rule. Rules run every 30 minutes and whenever a product is synced.

7

Create a low-stock alert

Navigate to Alerts → Rules → New Rule. Set the alert type to low_stock, enter a threshold (e.g. 10 units), apply it to All Products or a specific SKU, and set the notification channel (email, in-app, or Slack). Click Save Rule. You will now be notified whenever stock drops below your threshold.

8

Optionally invite your team

Navigate to Team → Invite Member. Enter your colleague's email address, select their role (admin, manager, or viewer), and click Send Invite. They will receive an email with a link to join your workspace.

🔑 Account & Login

Manage your credentials, review login history, and configure notification preferences from the Settings area.

📍 Navigate to: Settings → Account

Changing your password

Go to Settings → Account and click Change Password. Enter your current password, then enter and confirm your new password. Click Update Password. You will be logged out of all other active sessions immediately.

Login history

Go to Account → Login History to see a full log of every login to your account. Each row shows the IP address, browser and operating system, and the exact timestamp of the login. If you see a login you do not recognise, change your password immediately and enable Two-Factor Authentication.

Notification preferences

Go to Account → Notifications to choose which events trigger email or in-app notifications. Toggle each event type on or off individually. Changes take effect immediately — no save button required.

🗺️ Quick Tour

A feature map of every section in TikSync Pro — where to find it and what it does.

FeatureWhere to findWhat it does
DashboardSidebar → DashboardShows live KPI cards (Revenue, Orders, Products Synced, Sync Health), a 7-day revenue trend chart, recent sync log, and quick-action sync buttons.
ProductsSidebar → ProductsLists all synced products with their current stock, price, and sync status. Push products to stores from here.
OrdersSidebar → OrdersAll imported TikTok, WooCommerce, and Shopify orders. Filter by platform, status, and date. Expand any row for full order details.
PricingSidebar → PricingCreate and manage Price Rules (% Discount, % Markup, Fixed Discount, Fixed Markup, Match) and track competitor prices.
AnalyticsSidebar → AnalyticsCross-platform revenue bars, order counts, average order value, and profit margin calculator. Date range: 7d / 30d / 90d.
AlertsSidebar → AlertsCreate alert rules for low_stock, out_of_stock, sync_failed, order_spike, price_drop, slow_moving, listing_paused, and high_returns events.
TeamSidebar → TeamInvite team members with admin, manager, or viewer roles. View and revoke active members.
BillingSidebar → BillingView your current plan (Starter Free, Pro, or Business), upgrade or downgrade, and download invoices.
SettingsSidebar → SettingsManage all connections (TikTok Shop, WooCommerce, Shopify), account details, two-factor auth, and cron configuration.

🎵 Connect TikTok Shop

TikTok Shop is the master data source — all product info, stock levels, and orders originate here and flow to your other stores.

📍 Navigate to: Settings → Connections → TikTok Shop → Add
1

Open TikTok Shop Partner Center

Go to https://partner.tiktokshop.com and log in with your TikTok Shop seller account. This is the Partner Center, not the regular TikTok app.

2

Find your API Keys

In the Partner Center, go to Apps → [your app name] → API Keys. You will see your App Key and App Secret listed on this page. If you have not created an app yet, click Create App, give it a name (e.g. "TikSync Pro"), and save — your credentials are then shown on the app detail page.

3

Get your Access Token via OAuth

The Access Token is obtained via the OAuth 2.0 flow. In TikSync Pro, once you enter your App Key and App Secret and click Authorise, the app handles the OAuth flow automatically — it opens the TikTok authorisation page, you approve access, and the Access Token is captured and saved for you. You do not need to copy the token manually.

4

Fill in the connection form

In TikSync Pro, go to Settings → Connections → TikTok Shop → Add and fill in all four fields. Click Save Connection. A green dot and Live status badge in the sidebar confirm the connection is working.

Fields to fill in

Field labelWhat to enterWhere to find it
App KeyYour TikTok developer app key (e.g. 6abc123def456)TikTok Shop Partner Center → Apps → API Keys
App SecretYour TikTok developer app secret (long alphanumeric string)TikTok Shop Partner Center → Apps → API Keys
Access TokenOAuth access token — auto-populated after authorisation flowGenerated automatically by TikSync Pro OAuth flow
Shop Name/IDYour TikTok shop name or numeric shop IDTikTok Shop Partner Center → Shop Info
⚠️ Warning: TikTok access tokens expire every 30 days. TikSync Pro will display a "Token Expiring Soon" alert 3 days before expiry. When a token expires, syncs will fail with error code 40004 or 40005. Re-authorise via Settings → Connections → TikTok Shop → Edit to generate a new token.
⚠️ Warning: Never share your App Secret publicly — it gives full API access to your TikTok Shop.

🛍️ Connect WooCommerce

Connect your WooCommerce store using a REST API key with Read/Write permissions so TikSync Pro can sync stock, prices, and orders.

📍 Navigate to: Settings → Connections → WooCommerce → Add
1

Open the WooCommerce REST API settings

Log in to your WordPress admin dashboard. Navigate to WooCommerce → Settings → Advanced → REST API.

2

Click "Add key"

On the REST API page, click the Add key button.

3

Fill in the key details

Set Description to something like "TikSync Pro". Set User to an admin WordPress user. Set Permissions to Read/Write — this is required for TikSync to both read products and update stock.

4

Click "Generate API key"

Click the Generate API key button. WooCommerce will display your Consumer Key and Consumer Secret on the next screen.

5

Copy both keys immediately

Copy both the Consumer Key (starts with ck_) and Consumer Secret (starts with cs_) now. Paste them into a secure location such as a password manager.

⚠️ Warning: The Consumer Secret is only shown once. If you close this WooCommerce page without copying it, you must delete the key and generate a new one — there is no way to retrieve the secret again.
6

Add the connection in TikSync Pro

Go to Settings → Connections → WooCommerce → Add and fill in all four fields. Click Save Connection.

7

Verify the connection

Click the ⚡ Test button next to the WooCommerce connection. A green result confirms credentials are correct and the API is reachable.

Fields to fill in

Field labelWhat to enterWhere to find it
Store URLYour WooCommerce store URL including https:// (e.g. https://yourstore.com). No trailing slash.Your WordPress site URL
Consumer KeyStarts with ck_ followed by 40 charactersWooCommerce → Settings → Advanced → REST API → Generate
Consumer SecretStarts with cs_ followed by 40 charactersWooCommerce → Settings → Advanced → REST API → Generate (shown once)
Store LabelA friendly name to identify this store in TikSync Pro (e.g. "My WooCommerce Store")You choose this — it is for your reference only

🟢 Connect Shopify

Connect your Shopify store by creating a custom app with Admin API scopes, then copying the access token into TikSync Pro.

📍 Navigate to: Settings → Connections → Shopify → Add
1

Log in to Shopify Admin

Go to https://admin.shopify.com and log in to your store.

2

Go to Apps → Develop apps

In Shopify Admin, go to Settings → Apps and sales channels → Develop apps. If prompted with "Allow custom app development", click that button to enable it.

3

Create a new app

Click Create an app. Enter a name such as TikSync Pro and click Create app.

4

Configure Admin API scopes

Click Configure Admin API scopes. Check the following scopes:

  • read_products
  • write_products
  • read_inventory
  • write_inventory
  • read_orders
  • write_orders

Click Save.

5

Install the app and copy the access token

Click Install app. On the API credentials tab, click Reveal token once next to Admin API access token and copy it immediately. It starts with shpat_.

⚠️ Warning: Copy the access token immediately — Shopify only shows it once. If you miss it, you must uninstall and reinstall the app to generate a new token.
6

Add the connection in TikSync Pro

Go to Settings → Connections → Shopify → Add. Fill in the Store URL and paste the Access Token. Click Save Connection.

Fields to fill in

Field labelWhat to enterWhere to find it
Store URLYour Shopify subdomain only — yourstore.myshopify.com. Do NOT include https://.Your Shopify admin URL
Access TokenStarts with shpat_ — the Admin API access token from the custom app you createdShopify Admin → Apps → Develop apps → [your app] → API credentials
API KeyOptional. The API key shown on the credentials tab (not the same as the access token)Shopify Admin → Apps → Develop apps → [your app] → API credentials
API SecretOptional. The API secret key shown on the credentials tabShopify Admin → Apps → Develop apps → [your app] → API credentials

⚡ Test Your Connection

After saving any connection, always run the built-in test to confirm credentials are valid before relying on the connection for sync.

📍 Navigate to: Settings → Connections → click the ⚡ Test button next to any connection

How to run the test

On the Connections page, each saved connection has a ⚡ Test button in its action row. Click it. TikSync Pro sends a live read request to the platform API and returns the result within a few seconds.

What the result means

  • Green result ("Connection OK") — The API credentials are valid, the endpoint is reachable, and TikSync Pro has the permissions it needs. You are ready to sync.
  • Red result (error message) — The connection failed. The error message tells you exactly what went wrong (e.g. "401 Unauthorized" means wrong credentials; "403 Forbidden" means insufficient permissions; "cURL error 60" means SSL certificate problem).

If the test fails

  • For TikTok Shop — re-check your App Key and App Secret in Partner Center → Apps → API Keys, and re-run the OAuth flow to get a fresh Access Token.
  • For WooCommerce — verify the Consumer Key starts with ck_ and Consumer Secret starts with cs_, and that the key has Read/Write permission in WooCommerce → Settings → Advanced → REST API.
  • For Shopify — confirm the Store URL does not include https:// and the Access Token starts with shpat_.
💡 Tip: The test only validates credentials — it does not push or pull any product or order data.

🔄 How Sync Works

TikSync Pro offers three sync types — each serving a different purpose — and syncs bidirectionally so stock changes on any connected platform stay consistent.

The three sync types

Sync typeWhat it updatesTypical use
ProductsProduct name, price, stock quantity, and images for every product in your catalogueInitial setup; after bulk product changes on TikTok
Inventory onlyStock count updates only — no price or name changes. Runs every 15 minutes when configured.High-volume stores where only stock levels need to stay current
Full syncEverything — products, inventory, orders, price rules, and listing statuses all updated in one passPeriodic full reconciliation; after a long offline period

Bidirectional sync explained

TikTok Shop is the master for product information. Product names, prices (before rules), and images always come from TikTok. WooCommerce and Shopify stock changes (e.g. from a direct WooCommerce sale) flow back to TikTok automatically — TikSync reads the stock level on WooCommerce/Shopify and updates TikTok to match, preventing overselling.

Where to see the sync log

Every sync action is recorded. Go to Dashboard → Recent Sync Activity to see the last 20 sync events with their status (Success / Warning / Failed), the number of products and orders processed, and the timestamp. Click any row to see the full detail.

▶️ Running Your First Sync

Run your first product sync after connecting at least one store to import your TikTok catalogue into TikSync Pro.

📍 Navigate to: Dashboard → Sync Products button
1

Click "Sync Products" on the Dashboard

From the Dashboard, locate the quick-action buttons and click Sync Products. A progress modal opens and shows the sync running in real time.

2

Watch the progress modal

The modal shows how many products have been processed and how many remain. For catalogues under 500 products this typically takes 30–60 seconds. For larger catalogues it may take a few minutes.

3

Review your catalogue in Products

When the modal shows "Sync Complete", click Close and navigate to Products in the sidebar. Check:

  • Product count — does it match your TikTok Shop catalogue?
  • Stock levels — are the quantities accurate?
  • Red error rows in the sync log — any products that failed to sync will appear here with their error reason.
💡 Tip: If some products show errors, check the error message. The most common cause is a missing required field on TikTok (e.g. no SKU). Fix the product in TikTok Seller Center and run the sync again.

📤 Push Products to Another Store

Push a TikTok product to your WooCommerce or Shopify store — TikSync Pro creates the product listing automatically with all available data.

📍 Navigate to: Products → find product → click "Push" button
1

Find the product on the Products page

Navigate to Products in the sidebar. Use the search bar or filters to find the product you want to push.

2

Click the "Push" button

Click the Push button in the product row. A modal opens asking you to select the target platform.

3

Select the target platform and confirm

Select Shopify or WooCommerce from the dropdown and click Confirm Push. TikSync Pro creates the product on the target platform and reports success or any errors.

What gets pushed

  • Product name — exact name from TikTok
  • Description — product description from TikTok
  • Price — TikTok price with any applicable price rule applied
  • Stock quantity — current TikTok stock level
  • Images — all product images from TikTok
  • SKU — used for matching on future syncs
⚠️ Warning: Variants with custom metafields do not push automatically. Single-variant products push fully; multi-variant products push the base product only — you must configure variant options manually in your store after pushing.

📦 Bundle & Kit Management

Bundles are virtual SKUs that map to multiple source products. When a bundle order is placed, TikSync Pro automatically deducts stock from each component product.

📍 Navigate to: Inventory → Bundles → Create Bundle
1

Open Inventory → Bundles → Create Bundle

Navigate to Inventory → Bundles and click Create Bundle.

2

Enter the bundle name and SKU

Enter a Bundle Name (e.g. "Starter Kit") and a unique Bundle SKU (e.g. STARTER-KIT-001).

3

Add components

Use the Add Component search to find each source product. Set the qty multiplier for each component — this is how many units of that product are consumed per bundle sold (e.g. 2 means each bundle sale deducts 2 units of that product).

4

Save the bundle

Click Save Bundle. TikSync Pro calculates the bundle's available stock automatically.

How bundle stock is calculated

Bundle stock = the minimum of (each component's current stock ÷ that component's qty multiplier), rounded down. For example: Component A has 30 units (multiplier 1) and Component B has 10 units (multiplier 2) → bundle stock = min(30/1, 10/2) = min(30, 5) = 5 bundles available.

⚠️ Warning: If any component goes out of stock, the bundle becomes unavailable immediately — even if all other components have plenty of stock.

📋 Stock History

Every stock movement for every product is logged with a full audit trail so you can trace exactly why a stock level changed.

📍 Navigate to: Products → click any product → Stock History tab

Reading the stock history

On the Stock History tab for any product, each row shows:

  • Timestamp — the exact date and time of the stock movement
  • Source — what caused the change: TikTok sync, WooCommerce sync, manual adjustment, or order
  • Quantity change — the delta (e.g. −5 if 5 units were sold, +20 if stock was replenished)
  • Resulting stock level — the stock level after this movement was applied
💡 Tip: Use the stock history to diagnose unexpected stock drops. If stock dropped during a TikTok sync, check the sync log for that timestamp to see the TikTok-reported quantity at the time.

🛒 Order Sync

TikSync Pro imports orders from all connected platforms every 15 minutes, or on demand via the Sync Orders button.

📍 Navigate to: Orders

Order status meanings

StatusMeaning
PendingOrder has been placed but not yet processed
ProcessingOrder is being prepared for dispatch
ShippedTracking number has been added and the shipment has been sent
DeliveredConfirmed receipt by the customer
CancelledOrder was cancelled by the customer or seller
RefundedA refund has been issued for this order

Filtering orders

Use the filter bar at the top of the Orders page to filter by:

  • Platform — TikTok, WooCommerce, or Shopify
  • Status — any of the statuses listed above
  • Date range — a custom from/to date picker

Viewing full order details

Click any order row to expand it and see the full order detail, including: all line items with quantities and unit prices, customer name and shipping address, payment method, and a timeline of status changes.

📬 Bulk Fulfilment

Mark multiple orders as shipped in one action — TikSync Pro pushes the fulfilment status back to TikTok API automatically.

📍 Navigate to: Orders → select multiple rows → Bulk Actions → Mark as Shipped
1

Filter to Processing orders

On the Orders page, use the Status filter to show only Processing orders — these are the orders ready to ship.

2

Select the orders

Tick the header checkbox to select all visible orders, or tick individual checkboxes to select specific orders.

3

Click Bulk Actions → Mark as Shipped

Click the Bulk Actions dropdown and select Mark as Shipped.

4

Enter courier and tracking details

In the confirmation modal, enter a courier name (e.g. Royal Mail) and a tracking number. You can leave these blank to skip tracking for now — the status will still update to Shipped.

5

Confirm

Click Confirm. TikSync Pro pushes the fulfilment status to the TikTok API for all selected orders simultaneously. Orders update to Shipped status in TikSync and on TikTok.

💡 Tip: For mass upload, use Orders → Batch Fulfil page to import a CSV file with columns: order_id, courier_name, tracking_number.

🚚 Adding Tracking Numbers

Add or update a tracking number on any order — TikSync Pro pushes it to TikTok Shop automatically so the buyer can see their shipment status.

📍 Navigate to: Orders → click order row → Add Tracking

Adding tracking to a single order

Go to Orders, click the order row to expand it, then click Add Tracking. Enter the courier name and tracking number, then click Save. TikSync Pro immediately pushes this information to TikTok Shop — the buyer's order page updates within a few minutes.

Bulk tracking update

To update tracking numbers on multiple orders at once, go to Orders, select the orders using their checkboxes, click Bulk Actions → Update Tracking, and enter the tracking details. Useful when all orders in a batch use the same courier.

💡 Tip: Tracking is pushed to TikTok Shop as soon as you save — the buyer receives a notification from TikTok immediately.

💰 Price Rules

Price Rules automatically calculate prices on your connected stores based on TikTok pricing, applying markups, discounts, or exact matches.

📍 Navigate to: Pricing → Price Rules → Add Rule

The five rule types

Rule type (exact name)How it worksExample
% DiscountReduces the source price by the specified percentageValue 10 → target price is 10% less than TikTok price
% MarkupIncreases the source price by the specified percentageValue 20 → target price is 20% more than TikTok price
Fixed DiscountReduces the source price by a fixed currency amountValue 2.00 → target price is £2.00 less than TikTok price
Fixed MarkupIncreases the source price by a fixed currency amountValue 5.00 → target price is £5.00 more than TikTok price
MatchCopies the exact source platform price with no changeTarget price = TikTok price exactly

Creating a price rule

Navigate to Pricing → Price Rules → Add Rule. Set:

  • Source platform — where the base price comes from (e.g. TikTok Shop)
  • Target platform — where the calculated price is applied (e.g. WooCommerce or Shopify)
  • Rule type — one of the five types listed above
  • Value — the percentage or fixed amount (not required for Match)
  • Apply to — All products, a specific product category, or a specific SKU

Click Save Rule. Rules run every 30 minutes and whenever a product is synced.

Rule priority and order

Rule order matters — when multiple rules match the same product, the rule with the highest priority (lowest position number in the list) wins. More specific rules (targeting a specific SKU) override broader rules (applying to all products). Drag rules in the list to reorder them.

🔍 Competitor Price Tracking

Monitor competitors' prices for specific products daily, see your price versus theirs, and get alerted when they undercut you.

📍 Navigate to: Pricing → Competitor Prices

Adding a competitor product to track

Navigate to Pricing → Competitor Prices and click Add Competitor. Enter their store URL and the specific product URL you want to monitor. TikSync Pro fetches the price daily and stores the history.

The competitor price table

For each tracked competitor product, the table shows: your current price, their current price, the price delta percentage, and the last-checked timestamp.

Price drop alerts

Enable Price Drop Alert on any tracked competitor product. When their price drops below yours, TikSync Pro sends a notification via your configured channels (email, in-app, or Slack).

🤖 Auto Price-Match

Auto Price-Match is an advanced feature that automatically adjusts your prices to stay a set percentage above or below a tracked competitor's price.

⚠️ Warning: Auto Price-Match is an advanced feature. Set a floor price rule first to prevent prices dropping below your cost price. Without a floor, prices can drop to zero in a competitive pricing war.

How to configure Auto Price-Match

First, create a price rule (a % Markup or % Discount rule) at Pricing → Price Rules → Add Rule. This rule defines the margin you want to maintain relative to the competitor.

Then, on the Pricing → Competitor Prices page, find the competitor product you want to match and enable the Auto-Match toggle. Select the price rule to use as the adjustment formula. When TikSync Pro detects a competitor price change, it recalculates and applies your price automatically.

Setting a floor price

Create a Fixed Markup rule with a value equal to your minimum acceptable margin and set it as the floor. In the Auto-Match settings, configure the floor price field to prevent the automated pricing from ever going below your cost price.

📊 Dashboard Overview

The Dashboard is your real-time control centre showing the health of your sync, key business metrics, and quick-action buttons.

📍 Navigate to: Dashboard

KPI cards

CardWhat it shows
Total RevenueSum of all paid orders this month across all connected platforms
OrdersCount of orders received this month across all connected platforms
Products SyncedNumber of products successfully synced in the most recent sync run
Sync HealthPercentage of sync attempts in the last 24 hours that completed without errors

Charts

The 7-day revenue trend chart shows daily revenue for the past 7 days as a bar chart, with a line overlay showing order volume. Below it, the Recent Sync Activity log shows the last 20 sync events with status indicators (green = success, amber = warnings, red = failed).

Quick action buttons

  • Sync Products — triggers a product sync (name, price, stock, images) immediately
  • Sync Inventory — triggers a stock-only sync immediately
  • Sync Orders — imports new orders from all connected platforms immediately
  • Full Sync — triggers a complete sync of all products, inventory, and orders

📈 Cross-Platform Analytics

Compare your performance across TikTok Shop, WooCommerce, and Shopify side by side to identify which platform drives the most revenue and where to focus inventory.

📍 Navigate to: Analytics → Cross-Platform

Selecting a date range

Use the date range selector in the top-right corner of the page to switch between 7d (7 days), 30d (30 days), and 90d (90 days) views. The charts and tables update instantly.

What the analytics show

  • Per-platform revenue bars — side-by-side bar chart comparing revenue on TikTok, WooCommerce, and Shopify for the selected period
  • Order counts — total orders per platform
  • AOV (average order value) — average order value per platform
  • Winner column — highlights the best-performing platform for each metric in the selected period
💡 Tip: Use the Winner column to decide where to allocate more inventory. If TikTok consistently wins on AOV but WooCommerce wins on volume, consider stocking more on the platform with your highest-margin products.

💵 Profit & Margin Calculator

Enter your cost prices and platform fee percentages to get an accurate net profit and margin calculation for every product you sell.

📍 Navigate to: Analytics → Profit

Setting up cost data

On the Analytics → Profit page, for each product enter:

  • COGS (cost price) — what you pay to source or manufacture the product
  • Platform fee % — the percentage fee charged by the selling platform (e.g. TikTok Shop's commission rate)
  • Shipping cost — your average outbound shipping cost per unit

How profit is calculated

TikSync Pro calculates profit as: Revenue − COGS − Platform fees − Shipping = Net profit. Profit margin % is calculated as: Net profit ÷ Revenue × 100.

Exporting profit data

Click the Export button on the Analytics → Profit page to download a CSV file containing all product profit calculations for the selected date range.

🤝 Affiliate & Referral Programme

Track affiliate referral links, monitor click-through rates, signups, and commission earned per affiliate from within TikSync Pro.

📍 Navigate to: Growth → Affiliates

How affiliates work

Each affiliate is assigned a unique referral link when you add them in TikSync Pro. Share this link with the affiliate. When a customer uses it, TikSync Pro tracks the click, any signup, and any resulting order against that affiliate's record.

What you can track per affiliate

  • Clicks — how many times their referral link was clicked
  • Signups — new accounts created via their link
  • Orders — orders placed by customers referred by them
  • Commission earned — total commission accrued based on the configured rate

Setting commission rates

Set a global commission rate (% of sale) that applies to all affiliates, or override it per affiliate with an individual rate. Commission rates are set in the affiliate's profile on the Growth → Affiliates page.

Marking payouts as paid

Payouts are tracked manually in TikSync Pro. When you process a commission payment outside the system, go to the affiliate's record and click Mark as Paid to log the payment and reset their outstanding balance.

🔴 Live Shopping Sessions

Monitor your TikTok live shopping sessions in real time — watch orders come in, track stock depletion, and react instantly to avoid overselling.

📍 Navigate to: Orders → Live

Using the Live view during a TikTok live

Open Orders → Live before starting your TikTok live. This view shows incoming orders in real time with a live counter updating as orders arrive. Monitor stock levels for the products you are featuring — the live counter shows current available stock for each product.

Preventing overselling during a live

Before going live, set up low-stock alerts at Alerts → Rules → New Rule with alert type low_stock so you are notified the moment a featured product approaches zero stock. Run a Full Sync from the Dashboard immediately before going live to ensure stock levels are accurate across all platforms.

💡 Tip: Keep the Live view open on a second screen during your TikTok live stream. If a product appears to be selling out fast, you can manually adjust stock in TikTok Seller Center and trigger a Sync Inventory from the Dashboard to push the updated figure to all connected stores immediately.

🔔 Notifications Setup

Configure which events trigger notifications and how you receive them — in-app, email, or Slack.

📍 Navigate to: Account → Notifications

Available event types

Toggle each event type on or off individually on the Account → Notifications page:

  • Sync complete — notified whenever a sync finishes successfully
  • Sync failed — notified whenever a sync encounters an error
  • Low stock — notified when a product stock level drops below your configured threshold
  • Order received — notified on each new order
  • Price change — notified when a price rule updates a product price
  • Team member joined — notified when a new team member accepts their invite

Delivery channels

  • In-app (bell icon) — always on. Notifications appear in the bell icon in the top navigation bar.
  • Email — toggle on per event type on the Account → Notifications page.
  • Slack — enter your Slack Incoming Webhook URL in the field provided. To get a webhook URL: open Slack → go to your workspace's App Directory → search for Incoming Webhooks → click Add to Slack → choose a channel → copy the Webhook URL → paste it into TikSync Pro.

👥 Team Members & Roles

Invite colleagues to your TikSync Pro workspace with role-based permissions to control exactly what each person can see and do.

📍 Navigate to: Team → Invite Member

Inviting a team member

Navigate to Team → Invite Member. Enter the colleague's email address, select their role from the dropdown, and click Send Invite. The invitee receives an email with a link to join. They click the link, create an account (or sign in if they already have one), and are added to your workspace automatically.

The three roles

  • admin — Full access including billing, settings, connections, and all features. Can manage other team members.
  • manager — Access to all features except billing and the admin panel. Cannot add connections or manage team members.
  • viewer — Read-only access. Can see all data but cannot make any changes, trigger syncs, or fulfil orders.

Role permissions table

Permissionadminmanagerviewer
DashboardYesYesYes
Products (view)YesYesYes
Products (edit/sync)YesYesNo
Orders (view)YesYesYes
Orders (fulfil/update)YesYesNo
Price RulesYesYesNo
AlertsYesYesNo
Team ManagementYesNoNo
BillingYesNoNo
Settings/ConnectionsYesNoNo
Admin PanelYesNoNo

Revoking access

Navigate to Team, find the member in the list, and click Revoke. Their access is removed immediately and they can no longer sign in to your workspace.

🔐 Two-Factor Authentication (2FA)

Protect your account with a time-based one-time password (TOTP). Strongly recommended for all admin accounts.

📍 Navigate to: Account → Two-Factor Auth
1

Click "Enable 2FA"

Go to Account → Two-Factor Auth and click the Enable 2FA button. A QR code is displayed on screen.

2

Scan the QR code

Open Google Authenticator, Authy, or 1Password on your phone and scan the QR code. The app adds a TikSync Pro entry and starts generating 6-digit codes every 30 seconds.

3

Enter the 6-digit code to confirm

Type the current 6-digit code from your authenticator app into the confirmation field and click Verify.

4

Save your 8 backup codes

TikSync Pro displays 8 one-time backup codes. Copy all 8 and store them somewhere safe — a password manager or printed in a secure location. These codes are shown only once.

⚠️ Warning: If you lose your phone and do not have your backup codes, you will be locked out of your account. Contact support@tiktokpro.com for recovery assistance.
5

2FA is now active

From the next login, after entering your email and password you will be asked for your 6-digit authenticator code before gaining access.

Disabling 2FA

Go to Account → Two-Factor Auth and click Disable 2FA. Enter your current 6-digit authenticator code to confirm the disable action.

💳 Billing & Plans

TikSync Pro has three plans. Upgrades take effect immediately; downgrades take effect at the end of your current billing period.

📍 Navigate to: Billing → Upgrade Plan

Plan comparison

FeatureStarter (Free)ProBusiness
Products50500Unlimited
Orders/mo1001,000Unlimited
Team seats13Unlimited
Price RulesNoYesYes
AlertsNoYesYes
AnalyticsBasicFullFull
AI ToolsNoNoYes
SupportEmailPriorityPriority + SLA

Upgrading your plan

Navigate to Billing → Upgrade Plan, select your desired plan, and click Confirm Upgrade. The upgrade takes effect immediately and your usage limits update at once.

Downgrading your plan

Downgrades take effect at the end of your current billing period. Your existing plan features remain active until then. Usage resets on the 1st of each month.

💡 Tip: If you are approaching your product or order limit, you will see a warning banner in the Dashboard. Upgrade before you hit the limit to avoid sync interruptions.

🆘 Common Errors

A complete reference of errors you may encounter in TikSync Pro, their exact causes, and how to fix them.

ErrorCauseFix
Sync failed: 401 TikTok access token expired Go to Settings → Connections → TikTok Shop → Edit → re-enter Access Token by re-running the OAuth flow
Sync failed: 403 App Key or App Secret is incorrect, or the TikTok app is not approved for Shop API access Verify App Key and App Secret in TikTok Shop Partner Center → Apps. Check app approval status.
Products not updating Sync job not running — the cron job may not be configured or may have stopped Check cron is set up at Tools → Cron in the app. Verify the last run time is recent (within the last 15 minutes).
WooCommerce: 401 Unauthorized Consumer Key or Consumer Secret is wrong Regenerate the API key in WooCommerce → Settings → Advanced → REST API and update Settings → Connections → WooCommerce
WooCommerce: 403 Forbidden API key exists but does not have Read/Write permission — it is set to Read Only Edit the WooCommerce API key in WooCommerce → Settings → Advanced → REST API and set Permissions to Read/Write
WooCommerce: cURL error 60 The SSL certificate on your WooCommerce store is invalid, self-signed, or expired Install a valid SSL certificate on your WooCommerce server. Let's Encrypt is free and widely supported.
Shopify: 401 Unauthorized Shopify access token is invalid or has been revoked Regenerate a new token: Shopify Admin → Apps → Develop apps → [your app] → uninstall and reinstall to get a fresh shpat_ token
Shopify: 422 Unprocessable Product is missing a required field for Shopify (title or variant price) Ensure the product on TikTok has a title and at least one variant with a price set before pushing
Stock not updating Inventory Sync is not enabled for the connection Go to Settings → Connections → edit the connection → enable the Inventory Sync toggle → save
Orders showing as pending forever Order status is not being updated from TikTok — the order sync may not have run Run a manual sync: Dashboard → Sync Orders button
Cron not running The CRON_SECRET token is not set in cron.php or the URL in your server cron job is wrong Edit cron.php line 12 — change CHANGE_THIS_TO_A_RANDOM_SECRET to a real secret string. Update your server cron URL to: https://tiktokshop.rajangupta.com/cron.php?token=YOUR_SECRET
Cannot connect: SSL error Mixed HTTP/HTTPS in the store URL — WooCommerce URL must start with https:// In Settings → Connections → WooCommerce, ensure the Store URL starts with https:// not http://
Price rule not applying The rule is configured with the wrong source or target platform direction In Pricing → Price Rules, edit the rule and check the source_platform and target_platform fields are set correctly
Team member can't see orders The team member has the viewer role, which is read-only and can view data but cannot take actions Change their role to manager: go to Team → find the member → click Edit Role → select manager → save

🔧 WooCommerce Troubleshooting

WooCommerce has several common configuration issues that can prevent TikSync Pro from connecting or syncing. This section covers each one in detail.

1. Permalinks must be set to "Pretty Permalinks"

The WooCommerce REST API requires Pretty Permalinks to be enabled. If your REST API returns 404 errors, this is the most common cause. Fix it by going to WP Admin → Settings → Permalinks, selecting the Post name option, and clicking Save Changes. This rewrites the .htaccess file and enables REST API routing.

2. Firewall or WAF blocking REST API requests

Some hosting providers or security plugins (e.g. Wordfence, Sucuri) have Web Application Firewalls that may block REST API calls from external IP ranges. If TikSync Pro can see your site is up (ping works) but REST API calls fail with connection refused or 403, check your firewall settings. Add TikSync Pro's server IP ranges to your WAF allowlist, or temporarily disable aggressive request blocking to test.

3. Application Passwords or Basic Auth plugin

Some WooCommerce installations (particularly those with certain caching or security setups) require the WordPress Application Passwords feature (built-in since WordPress 5.6) or the legacy WooCommerce REST API — Basic Auth plugin to authenticate REST API requests. If Consumer Key/Secret authentication is failing despite correct credentials, try enabling Application Passwords in Users → Profile → Application Passwords.

4. WordPress Multisite

If your site runs WordPress Multisite, the REST API endpoint URL is different from a standard installation. The WooCommerce REST API is available at https://yoursite.com/wp-json/wc/v3/ for the main site. Sub-sites in a Multisite network may have different URL structures. Ensure the Store URL you enter in TikSync Pro points to the correct site URL, not a subdirectory or subdomain of the network.

5. WooCommerce version must be 3.0 or higher

The REST API v3 that TikSync Pro uses requires WooCommerce 3.0 or higher. If you are running an older version, the REST API endpoints TikSync Pro calls will not exist. Update WooCommerce to the latest version via WP Admin → Plugins → WooCommerce → Update.

💡 Tip: After making any of the changes above, always click the ⚡ Test button on your WooCommerce connection in Settings → Connections to confirm the fix worked before running a sync.

⚠️ TikTok API Error Codes

When TikSync Pro communicates with the TikTok Shop API, errors are returned as numeric codes. This reference explains each code and how to resolve it.

ℹ️ Note: TikTok access tokens expire every 30 days. TikSync Pro will show a "Token Expiring Soon" alert 3 days before expiry. Renew the token in Settings → Connections → TikTok Shop → Edit before it expires to avoid sync interruptions.
CodeMessageFix
40001 Invalid parameter Check that your App Key and Shop Name/ID are correct. These are set in Settings → Connections → TikTok Shop → Edit.
40002 Missing required parameter Ensure all four fields are filled in: App Key, App Secret, Access Token, and Shop Name/ID. None can be blank.
40004 Invalid access token The Access Token has expired or been revoked. Re-run the OAuth flow: Settings → Connections → TikTok Shop → Edit → Authorise.
40005 Token expired Re-generate the Access Token from TikTok Shop Partner Center → OAuth and update it in Settings → Connections → TikTok Shop → Edit.
40006 No permission Your TikTok developer app does not have Shop API access approved. Submit your app for approval in TikTok Shop Partner Center → Apps → [your app] → Submit for Review.
50001 System error The TikTok Shop API is temporarily unavailable. Wait 30 minutes and retry. Check the TikTok Shop status page if the issue persists.
50002 Rate limit exceeded TikSync Pro automatically handles rate limiting with built-in retry logic. If you see this error persistently, reduce sync frequency in Settings. Wait at least 1 hour before retrying manually.

Where to find detailed error information

Every TikTok API error is logged with the full raw API response. Go to Dashboard → Recent Sync Activity and click any failed sync entry to see the exact error code and message returned by TikTok. This is the fastest way to diagnose connection issues.

💡 Tip: If you cannot resolve an error using this guide, email the full error details to support@tiktokpro.com. Include the error code, the timestamp of the failed sync, and your App Key (never your App Secret).
© 2026 TikSync Pro
Start Free Trial → Sign In Home Support