OAuth and order scope
Authorize with platform: "tiktok_shop". Your TikTok Partner app must publish Order Information scopes. If orders stay empty after connect, re-authorize after publishing scopes (refresh alone is not enough).
Sync and webhooks
TikTok may push order updates to your configured webhook URL on the Railway host. Console Sync orders pulls recent orders when the token has order scope.
Field notes
shipping_address.country uses TikTok recipient_address.region_code. City, state, and postal code use district_info and postal_code when TikTok sends them. totals.discount is seller_discount plus platform_discount.
Write APIs
Ship, shipping labels, warehouses, and inventory use the shared /v1 write routes documented in Orders and events. Mock connections succeed. Live TikTok Shop calls fulfillment, document, warehouse, and inventory APIs. Missing scopes return capability_unsupported until the seller re-authorizes.