Tiktok Shop Integration

TikTok Shop Integration

Overview

TikTok Shop transforms TikTok from a discovery channel into a direct commerce platform where users purchase without leaving the app — via shoppable video posts, LIVE shopping events, product showcase tabs, and creator affiliate programs. For Shopify and WooCommerce, official TikTok integrations handle catalog sync, order management, and inventory updates automatically. The strategic work is applying to TikTok Seller Center, structuring your affiliate program, and running LIVE shopping events.

When to Use This Skill

• When launching TikTok as a native commerce channel (not just a traffic referral)
• When your products are suited to impulse purchase via short-form video
• When enabling creators to tag and earn commissions on your products
• When running LIVE shopping events for product launches or flash sales
• When needing to sync inventory and orders between TikTok Shop and your primary platform

Core Instructions

Step 1: Register on TikTok Shop Seller Center

Before any integration:

1. Go to seller.tiktokshop.com and create a seller account 2. Complete identity verification (government ID + business registration) 3. Connect your TikTok Business Account to the Seller Center 4. Wait for seller approval — typically 1–3 business days; some categories require additional documentation (food, supplements, electronics)

Note: TikTok Shop is currently available in the US, UK, Southeast Asia, and select other markets. Availability changes — check TikTok's current supported markets before starting.

Step 2: Connect your platform to TikTok Shop

---

Shopify

1. Go to Shopify Admin → Sales Channels → + → TikTok 2. Install TikTok for Shopify and connect your TikTok Seller Center account 3. Under Catalog Sync, Shopify syncs your product catalog to TikTok Shop automatically 4. Shopify also syncs TikTok Shop orders back to Shopify Admin so you manage fulfillment in one place 5. Go to TikTok → Products to review which products were approved and which have issues 6. Products that fail TikTok's content review (image quality, prohibited categories) appear in TikTok → Products → Rejected with the reason

---

WooCommerce

1. Install TikTok for WooCommerce from the WordPress plugin directory 2. Go to WooCommerce → TikTok → Seller Center and connect your TikTok Seller Center account 3. The plugin syncs your WooCommerce products to TikTok Shop and pulls TikTok orders back into WooCommerce 4. Go to WooCommerce → TikTok → Products to monitor sync status and resolve any rejected products

---

BigCommerce

1. Go to BigCommerce Admin → Channel Manager → Add a Channel → TikTok 2. Connect your TikTok Seller Center account 3. BigCommerce automatically syncs products and inventory to TikTok Shop 4. TikTok orders appear in BigCommerce → Orders for unified fulfillment management

---

Custom / Headless

Use the TikTok Shop API directly for custom catalog management and order handling:

const TIKTOK_SHOP_BASE = 'https://open-api.tiktokglobalshop.com';

async function syncProductToTikTokShop(product: Product) {
  // TikTok Shop API requires HMAC-SHA256 request signing
  const timestamp = Math.floor(Date.now() / 1000).toString();
  const body = {
    title: product.name.substring(0, 255),
    description: product.description.replace(/<[^>]*>/g, '').substring(0, 5000),
    category_id: product.tikTokCategoryId, // find IDs in TikTok Seller Center → Products → Categories
    images: product.images.map(img => ({ url: img.url })),
    skus: product.variants.map(v => ({
      sales_attributes: v.options.map(opt => ({ attribute_name: opt.name, value_name: opt.value })),
      stock_infos: [{ available_stock: v.stockQuantity, warehouse_id: process.env.TIKTOK_WAREHOUSE_ID }],
      seller_sku: v.sku,
      original_price: v.price.toFixed(2),
    })),
  };

  return tiktokShopRequest('/api/products', body);
}

// Handle TikTok Shop order webhooks
// POST /webhooks/tiktok-shop
export async function handleTikTokShopWebhook(req: Request, res: Response) {
  const { type, data } = req.body;

  if (type === 'ORDER_STATUS_CHANGE') {
    // Sync TikTok order to your OMS
    await syncTikTokOrder(data.order_id, data.order_status);
  }

  res.json({ code: 0 }); // TikTok requires this exact response format
}

Step 3: Set up product listings for TikTok Shop

After catalog sync, optimize each product for TikTok Shop:

Product images:

• Use square (1:1) or vertical (9:16) product images — landscape images underperform
• White or clean background for the main product image
• No text overlays, watermarks, or price callouts on images (TikTok rejects these)
• Minimum 500×500px; 1000×1000px recommended

Product titles:

• Include the primary keyword in the first 20 characters
• TikTok Shop displays titles in search and shopping feeds
• 255 character maximum

Shipping:

• Set up a warehouse in TikTok Seller Center → Settings → Logistics
• Link a TikTok-approved shipping carrier (UPS, USPS, FedEx for US sellers)
• TikTok buyers expect free shipping — set a free shipping threshold that makes economic sense (e.g., orders over $25)

Step 4: Enable the creator affiliate program

TikTok Shop's Open Collaboration model lets any creator discover your products and tag them in content for a commission — no prior relationship needed.

1. Go to TikTok Seller Center → Affiliate → Open Plan 2. Set a commission rate per product category (typically 10–20% for ecommerce) 3. Products with enabled affiliate commissions automatically appear in the TikTok Affiliate Marketplace where creators browse for products to promote 4. Review affiliate creator applications under Seller Center → Affiliate → Creators

For targeted partnerships: 1. Go to Seller Center → Affiliate → Targeted Collaboration 2. Browse creator profiles and send collaboration invites with a custom commission rate 3. You can provide product samples and set specific posting requirements in the invitation

Step 5: Run a LIVE Shopping event

LIVE Shopping events drive high-urgency sales with real-time product featuring:

Before going live: 1. In TikTok Seller Center, go to Products and ensure all products you plan to feature are "Active" status (product review takes 24–48 hours) 2. Go to TikTok LIVE Studio (download the app) or use the TikTok mobile app 3. Under Shopping, select the products to feature during the LIVE 4. Promote the LIVE 24–48 hours in advance via regular posts and Stories

During the LIVE: 1. Start the LIVE from TikTok app or LIVE Studio 2. Pin featured products using the shopping cart icon — viewers tap the pinned card to add to cart 3. Change the featured product in real time as you demo different items 4. Respond to comments about pricing, sizing, and availability to drive urgency

Best times for LIVE Shopping events: Tuesday, Wednesday, or Thursday evenings (7–9pm EST for US audience). Consistent scheduling builds a returning audience.

Step 6: Manage TikTok Shop orders

TikTok requires fulfillment within 2 business days of order confirmation. Late shipments damage your seller rating.

Fulfillment process: 1. TikTok Shop orders appear in your platform admin (Shopify/WooCommerce) automatically if using the native integration 2. Print shipping labels from your platform admin — TikTok accepts tracking numbers from all major carriers 3. Enter the tracking number in TikTok Seller Center → Orders within 2 days 4. TikTok automatically updates the buyer on shipping status

Returns:

• Accept returns within 30 days of delivery (TikTok's default return window)
• Configure return logistics in Seller Center → Settings → Returns

Best Practices

• Keep inventory in sync within 5 minutes — overselling on TikTok damages your seller rating and can result in account suspension; use your platform's native TikTok integration for real-time sync
• Use Open Collaboration for discovery — set a 10–15% commission rate on all products to attract micro-creators who discover your brand organically without outreach
• Include dedicated TikTok Shop images — square or 9:16 product images outperform landscape images; prepare TikTok-specific creative assets separate from your Shopify product images
• Run LIVE events consistently — 2× per week builds a returning audience; ad-hoc live events get low attendance
• Monitor affiliate content for brand safety — creators in Open Collaboration post without prior approval; review tagged content regularly

Common Pitfalls

Related Skills

• @tiktok-ads-integration
• @ugc-campaign-management
• @influencer-marketplace-integration
• @social-commerce
• @video-commerce-integration

TikTok Shop Launch Playbook & Affiliate Setup

Problem/Feature Description

LuxeCandle Co. is preparing to launch its entire product range on TikTok Shop ahead of the holiday season. The head of e-commerce has asked for two things: (1) a TypeScript module that configures the affiliate creator program for the catalogue — both a broad "discovery" tier open to any creator and a VIP tier for a shortlist of hand-picked influencers — and (2) a concise operational playbook (PLAYBOOK.md) that the team can follow for the launch, covering inventory management, fulfilment targets, and content strategy.

The brand has had problems with overselling on other marketplaces in the past, especially during flash sales, and the CTO has specifically asked that the inventory architecture section of the playbook address how to prevent TikTok Shop from accepting orders it can't fulfil. The marketing director wants guidance on how to maximise reach for the new "Winter Collection" drop without spending heavily on paid ads, and needs specific advice on image assets to prepare to avoid products getting stuck in review.

Output Specification

Produce two files:

1. affiliate-setup.ts — TypeScript module with:

• A function to set an open-collaboration commission rate on a list of product IDs
• A function to invite a specific creator (by their unique ID) to a targeted affiliate campaign with a set of product IDs

2. PLAYBOOK.md — Operational launch playbook with sections covering:

• Inventory management and oversell prevention strategy
• Order fulfilment targets and consequences of missing them
• Content / go-to-market strategy for the new product launch
• Affiliate program management and brand safety guidelines
• Product image requirements to pass TikTok catalog review
• Shipping cost configuration guidance

TikTok Shop API Integration Module

Problem/Feature Description

Bloom & Thread is a UK-based home décor brand that sells through its own Shopify storefront. After strong performance on TikTok organic content, the team has decided to launch TikTok Shop as a direct commerce channel. The engineering lead has asked you to build a reusable TypeScript API client module that the rest of the backend can use to communicate with TikTok Shop's REST API, and an initial product sync function so the catalogue team can push product listings programmatically.

The brand's products have long marketing names (sometimes exceeding 300 characters), multiple colour/size variants, and each variant has an independent price and stock level. The CTO wants to make sure the integration handles authentication correctly and fails loudly (throws descriptive errors) when the API returns a non-success response, so problems are caught early.

Output Specification

Produce a TypeScript file tiktok-shop-client.ts that contains:

1. A generic tiktokShopRequest(path, body) function that handles authentication and makes POST requests to the TikTok Shop REST API. 2. A syncProduct(product) function that uses the generic client to create or update a product listing, mapping the fields defined in the input schema below. 3. An updateInventory(tikTokSkuId, newQuantity) function that updates stock for a single SKU.

Also produce a short INTEGRATION_NOTES.md explaining:

• What environment variables the module expects
• Any constraints or limits the calling code should be aware of (e.g. field length restrictions, numeric formatting)
• The recommended image format/dimensions for product images submitted to TikTok Shop

Input Files (optional)

The following files are provided as inputs. Extract them before beginning.

=============== FILE: inputs/product-schema.ts =============== export interface ProductVariant { sku: string; price: number; // e.g. 29.99 stockQuantity: number; options: Array<{ name: string; value: string }>; images?: Array<{ url: string }>; }

export interface Product { name: string; // marketing name, may be very long description: string; tikTokCategoryId: string; tikTokBrandId?: string; images: Array<{ url: string }>; weightKg: number; heightCm: number; lengthCm: number; widthCm: number; variants: ProductVariant[]; }

TikTok Shop Webhook Handler

Problem/Feature Description

NovaSport is a sports equipment retailer that recently launched TikTok Shop. Their backend runs on Node.js/Express, and the team needs to receive and process real-time events from TikTok Shop — including order updates, product approval notifications, and payment settlements — so the platform keeps its internal order management system (OMS) up to date without polling the TikTok API.

The backend engineer has been asked to build the webhook endpoint. The ops team was burned previously by a third-party integration that accepted spoofed callbacks, so security is a priority: the endpoint must reject any request that cannot be verified as genuinely coming from TikTok. The team also wants to make sure that TikTok's delivery system doesn't interpret successful processing as an error and keep retrying events.

When an order status changes, the handler should fetch the full order detail from TikTok and store it in the OMS. The OMS's db.orders.upsert function accepts a lookup key as the first argument and the data to write as the second; the team wants a consistent strategy for identifying TikTok orders so there are no duplicates even if the same event fires twice.

Output Specification

Produce a TypeScript file tiktok-webhook-handler.ts containing an Express route handler function handleTikTokShopWebhook that:

1. Validates incoming webhook requests 2. Routes each event type to an appropriate handler 3. Responds correctly to TikTok's delivery system

Also produce a short WEBHOOK_SETUP.md that describes the steps needed to configure the webhook in TikTok Seller Center, including any requirements for the endpoint URL itself.

Stub out any external dependencies (database, tiktokShopRequest) with comments indicating what they would do — the grader only needs to assess the handler's structure and logic, not run it.