← Back to EcomCentral
TIKTOK SHOP OPEN PLATFORM

TikTok Shop Setup Guide

Connect your TikTok Shop seller account to EcomCentral using the Open Platform API with HMAC-SHA256 signed requests.

Prerequisites

ℹ️ Every request is signed with HMAC-SHA256 using your app_secret. EcomCentral handles signing automatically — you only supply the credential set below.

Getting Your API Credentials

  1. Go to TikTok Open Platform (developer.tiktok.com) and create or open your app
  2. Under My Apps → App info, copy your App Key and App Secret
  3. Complete the OAuth 2.0 authorization for your seller account to receive an access_token
  4. Find your Shop ID: it is returned in the /api/shop/get_authorized_shop response, or visible in TikTok Seller Center under Account → Shop info
  5. In EcomCentral, add a new TikTok Shop connection and fill in all five fields
  6. Click ⚡ Test to verify signing and connectivity
⚠️ Access tokens expire. When your token expires, re-authorize via TikTok's OAuth flow and update the access_token credential in EcomCentral (use Rotate Keys on the connection detail page).

Credentials Reference

KeyRequiredDescriptionExample
app_key Required App Key from TikTok Open Platform abc123xyz
app_secret Required App Secret — used to HMAC-sign every request s3cr3t…
access_token Required OAuth 2.0 access token for your seller account TKT_…
shop_id Required Your TikTok Shop ID 7123456789
base_url Optional API host — defaults to the global endpoint https://open-api.tiktokglobalshop.com
✅ Alternative key names accepted: appKey for App Key; appSecret for App Secret; accessToken for access token; shopId for Shop ID; baseUrl for base URL.

Order Statuses

TikTok Shop uses these canonical order status values:

UNPAID ON_HOLD AWAITING_SHIPMENT AWAITING_COLLECTION IN_TRANSIT DELIVERED COMPLETED CANCELLED

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/api/shop/get_authorized_shop
List ordersGET/api/orders/search
Order detailGET/api/orders/detail/query
Upload trackingPOST/api/fulfillment/tracking_number/upload
Confirm deliveryPOST/api/fulfillment/order/update_shipping_info
List productsGET/api/products/search
Product detailGET/api/products/details
ℹ️ Orders use cursor-based pagination (not page numbers). EcomCentral maps page 1 → cursor 0 as a best-effort approximation. For full cursor tracking, use the TikTok Seller Center directly.

Supported Features

FeatureSupportedNotes
View orders (paginated)✅Cursor-based; best-effort page mapping
View order detail✅Address, line items, tracking, timestamps
Upload tracking number✅Tracking number + optional shipping provider ID
Confirm delivery✅Triggers CONFIRM_DELIVERY action
View products (paginated)✅SKU, name, price, stock across variants
View product detail✅Images, SKU variants, per-warehouse stock
Update stock quantity❌Not available — no per-SKU stock write in TikTok Shop API
Test connection✅Shop authorization check + HMAC validation

Troubleshooting

✕ Signature error / code ≠ 0

TikTok returns a non-zero code when the HMAC signature is invalid. The signature covers the path, sorted query params, and scalar body fields — all keyed by app_secret. Verify the app_key + app_secret pair is correct and that your server clock is accurate (requests include a timestamp).

✕ Access token expired

TikTok access tokens have a limited lifetime. Re-run the OAuth authorization flow and update the access_token credential via Rotate Keys on the connection detail page.

✕ Wrong shop_id

The shop_id must match the shop your access token is authorized for. Click ⚡ Test — a successful response shows the authorized shop name and ID you can cross-check.

✕ Stock update not available

The TikTok Shop Open Platform API does not expose a per-SKU inventory write endpoint at this time. Manage stock levels directly in TikTok Seller Center.