GeminiPOS

TikTok Shop Integration (Catalog, Stock & Fees)

Connect TikTok Shop to MyStore, import and match your catalog, switch on automatic stock to TikTok, and price with a TikTok fee markup calculator.

TikTok Shop Integration (Catalog, Stock & Fees)

Complete guide to connecting your physical retail store with TikTok Shop Seller Center using GeminiPOS Hub (MyStore). Import your catalog, match products, let GeminiPOS update TikTok Shop stock automatically after every sale, and protect net profit margins using the TikTok fee markup calculator.

Feature Overview

The GeminiPOS TikTok Shop integration unifies brick-and-mortar checkout counters and live social commerce into a single authoritative platform:

  • Secure Official TikTok Shop OAuth Connection: Zero manual API key pasting or insecure token handling.
  • Catalog Import & Smart SKU/Barcode Auto-Matching: Map existing TikTok products to POS product variations with a single click.
  • Automatic Stock to TikTok Shop: Switch on Update TikTok stock automatically and new quantities reach TikTok Shop within about a minute of a stock change in store. Sync Stock Now is still there to send at once. Only products that are matched and have stock sync on are updated.
  • Direct POS Product Form Visibility: Manage TikTok listing toggles and mapping directly inside the MyStore product creation and editing modal.
  • Automated Fee Calculator & Margin Protection: Offset marketplace platform commissions (~7%) with smart markup presets (+6% Base, +8% Standard, +10% Safe) and real-time net payout previews.

Step 1: Module Enablement & Store Selection

  • Log in to GeminiPOS Hub (MyStore) on your web browser.
  • From the left sidebar navigation, open Integration Modules (or click the top navigation tab: E-COMMERCE).
  • Ensure the desired store location is selected in the top-right store picker (e.g. izfreshmart pelain).
  • Locate the TikTok Shop module card. If the status is *Paused* or *Setup required*, turn the toggle switch to ON.
  • Click the MANAGE > button on the TikTok Shop card to open the connection dialog.

Step 2: Linking TikTok Shop Seller Account via OAuth

  • Inside the TikTok Shop Setup modal, review your current seller account connection status.
  • If your account is not connected yet, click CONNECT TIKTOK SHOP. You will be securely redirected to the official TikTok Shop Seller Center consent portal to authorize permissions for orders, catalog, and fulfillment.
  • Once authorized, the status badge updates to Connected alongside your official TikTok Seller Account ID.
  • The Current readiness checklist verifies end-to-end operational integrity:
  • ✓ Credentials stored securely in Supabase Vault.
  • ✓ Every order is recorded correctly and never double-counted.
  • ✓ Webhook signature verification active.
  • ✓ Price and inventory sync pipelines operational.

Step 3: Catalog Import & Stock Sync to TikTok Shop

Inside the same TikTok Shop modal, locate the TikTok Shop Catalog & Stock management card: This section provides 3 essential operational controls: 💡 Avoiding Overselling: After matching products, continue to the next step to switch on automatic stock. Without it, a counter sale reduces POS stock only and you have to press Sync Stock Now yourself.

  • [IMPORT KATALOG] — Pulls all active product listings from TikTok Shop Seller Center into GeminiPOS.
  • [AUTO-PADAN SKU] — Automatically matches imported TikTok listings to physical POS products by evaluating matching barcodes and seller SKUs.
  • [SYNC STOK SEGERA] — Sends current POS stock to TikTok Shop at once. Only products that are matched and have stock sync on are sent.

Step 3B: Switch On Automatic Stock

Stock is sent only for products that are matched and have stock sync on. There are two ways to turn it on: All products at once. In the TikTok Shop dialog, a yellow notice appears when matched products are not sending stock yet. Press Turn on stock sync for N products. One product. Go to E-Commerce → Catalog, press a TikTok product, choose Channel & Sync Settings, switch on Send GeminiPOS stock to TikTok for this product, then press SAVE. Finally, in the TikTok Shop dialog, switch on Update TikTok stock automatically:

  • Units to keep back from TikTok: units you do not want to sell on TikTok. Example: 20 in store, keep back 2, TikTok shows 18.
  • When stock changes in GeminiPOS (a sale, stock in, an adjustment), the new quantity reaches TikTok within about a minute.
  • Stock you change directly in TikTok Seller Center is replaced with the GeminiPOS quantity. Change stock in GeminiPOS only.
  • Pack products (for example 1 pack = 6 units) are worked out for you: 20 units in store become 3 packs on TikTok.

Step 4: Managing Sales Channels in the Online Store Tab

In strict adherence to the separation between in-store cashier operations and omnichannel e-commerce, TikTok Shop channel settings are cleanly located under the Online Store tab:

  • Navigate to Products & Stock → Products.
  • Click any product (e.g. manggis) to open the Edit Product modal.
  • Select the Online Store tab → Scroll to SECTION 3: SALES CHANNELS & PUBLISHING:
  • Branch Connection Status: Displays whether the item is connected to your active branch's TikTok Shop account.
  • Smart Branch Switcher: If your TikTok Shop account is connected to another store (e.g. Store B), a branch badge 📍 Store B with a direct "Switch to Store B" button appears, allowing seamless management without having to manually switch branches from the top navbar.
  • Publish Toggle: Quickly enable or disable TikTok visibility without affecting your in-store POS checkout.
  • Direct Actions: Click LINK or MANAGE LISTINGS to adjust channel pricing and map variations.

Step 5: Automated Fee Calculator & Markup Presets

Selling on TikTok Shop incurs marketplace commission (~3.5% to 4.5%) plus payment processing gateway fees (2.16% + SST). Selling at your exact in-store counter price erodes net profits. GeminiPOS includes an Automated Fee Calculator & Markup Engine:

  • Go to Products & Stock → SALES CHANNELS tab (or navigate to /products?view=channels).
  • Select the product you want to adjust (e.g. manggis).
  • Click the TikTok Shop channel row to open its settings panel.

Smart Markup Presets:

  • +6% (Base): Covers minimum platform commission and transaction gateway charges.
  • +8% (Standard): *(Recommended)* Covers full platform fees plus courier packaging and parcel bubble wrap costs.
  • +10% (Safe): Guarantees maximum net merchant cash flow.
  • Sama POS: Keeps TikTok price identical to physical in-store counter price (RM 3.00).

Real-time Financial Breakdown:

Selecting a preset (such as +8%) instantly computes the financial projection:

  • POS Counter Price: RM 3.00
  • TikTok Selling Price: RM 3.24
  • Estimated TikTok Fee (~7%): ~RM 0.23
  • Net Merchant Payout: ~RM 3.01
  • Margin Health Indicator: ✓ In-store profit margin preserved (Net payout matches / exceeds POS).
  • Ensure the Include in price sync toggle is active (blue).
  • Click SAVE. The updated selling price pushes directly to the TikTok Shop API.

Daily Operational Workflow

  • Customer buys at the physical counter — cashier scans the barcode on GeminiPOS Android Native POS, and POS stock decrements.
  • GeminiPOS sends the new stock to TikTok Shop by itself — within about a minute, for products with stock sync on.
  • TikTok orders arrive in Online Orders — claim, pack and print the AWB from the POS app at the counter.

Can I disable selling a product on TikTok Shop while keeping it active in my physical store?

Yes. Open the product in MyStore and toggle the TikTok Shop switch to OFF, or uncheck *Publish enabled* in Channel Settings. Physical checkout counters can continue ringing up sales uninterrupted.

Are TikTok Shop platform fees deducted from my bank account separately?

No. TikTok Shop automatically deducts marketplace commission and payment fees directly from gross customer payments before remitting the net payout to your bank account. The GeminiPOS markup calculator ensures your net payout never falls below your desired in-store profit.

What happens if our physical counter experiences a temporary internet outage?

GeminiPOS is engineered offline-first. In-store counter checkout continues seamlessly. When the connection returns, transactions sync to the server, and TikTok Shop stock is updated after that if automatic stock is on.