Settlement Batch Mechanics
TikTok Shop does not settle per-order. Orders accumulate into settlement batches. A batch closes after all constituent orders pass their return-window expiry (typically 15 days post-delivery). Batch release cadence:
| Region | Typical Cadence |
|---|---|
| US | Every 1–2 days after batch close |
| UK | Every 1–3 days after batch close |
| SE Asia | Every 2–3 days after batch close |
Batch boundaries are set at order creation time, not delivery time. An order placed on Day 0 belongs to the Day 0 batch regardless of when it ships.
Try it
Order Placed
Customer completes purchase
Shipped
Seller uploads tracking number
Delivered
Package delivered to customer
Confirmation
Auto-confirmed after 3 days (no dispute)
Settlement
TikTok processes payment batch
Payout
Funds arrive in seller bank account
From order placement to funds in your bank account. Actual timing varies by region and payment method.
Fee Deduction Pipeline
Three deductions apply sequentially before net settlement is computed:
Net Settlement = Order GMV − Platform Commission − Payment Processing Fee − Shipping Subsidy Clawback
| Deduction | Rate | Basis | Condition |
|---|---|---|---|
| Platform Commission | 2–8% | Order GMV | Always; rate set by product category + active promotional tier |
| Payment Processing Fee | 2.0% | Order GMV | Always; flat rate across all payment methods |
| Shipping Subsidy Clawback | Variable | Subsidy amount | Only when TikTok subsidized shipping and buyer returned item |
Commission rates vary by category and change during promotional periods (e.g., BFCM, flash sales). The rate applied to a given order is locked at order creation time, not at settlement time.
Rate cards published in Seller Center are nominal. Actual per-order commission rates diverge due to promotional overrides, bundle deals, and coupon subsidies. Do not use rate cards for profit calculation — use Finance API statement data only.
Settlement State Machine
Each settlement batch transitions through three states:
| State | Definition | Fee Visibility |
|---|---|---|
| Processing | Batch closed; TikTok computing deductions | Estimated only |
| Completed | Deductions finalized; payout queued | Actual, authoritative |
| Paid | Funds transferred to seller bank account | Actual, authoritative |
Profit reporting must filter to Completed or Paid states. Processing amounts are estimates and will change before finalization.
Dispute Hold Mechanics
A buyer dispute freezes the associated order’s settlement amount. The hold persists until:
- Dispute resolves in seller’s favor → amount releases to next batch
- Dispute resolves in buyer’s favor → amount is reversed; if already paid, a clawback deduction appears in a future settlement
- TikTok policy review → hold duration is indeterminate; no SLA applies
Held orders remain in Processing state. They do not appear in Completed batches until resolution. Clawback reversals appear as negative line items in the settlement batch where they are deducted.
Disputes resolved after payout generate clawback deductions in future batches, not amendments to the original batch. Reconciliation must account for this lag — a paid batch is not immutable.
Finance API as Authoritative Data Source
TikTok exposes three Finance API endpoints relevant to settlement data:
| Endpoint | Data Type | Fee Coverage |
|---|---|---|
GET /finance/202501/statements/{id}/statement_transactions | Settled transactions | Full 140+ field breakdown; authoritative |
GET /finance/202507/orders/unsettled | Unsettled estimates | Partial; commission and processing only |
GET /finance/202309/orders/{id}/statement_transactions | Per-order SKU detail | Full per-SKU fee attribution |
The /statements/{id}/statement_transactions endpoint is the single source of truth for profit. It returns actual settled amounts including all deduction categories, per-SKU attribution, and promotional adjustments that rate cards do not capture.
Order API data (GMV, status) contains no fee detail. Using order-level estimates to compute profit produces systematic error — the gap between estimated commission and actual deducted commission widens during promotional periods and for bundled products.
AxonRow syncs Finance API data on a 24-hour cadence. Unsettled periods display estimated amounts with a confidence indicator. Once a batch reaches Completed state, Finance API data replaces all estimates.
Settlement Data in AxonRow
Navigate to Finance → P&L to access settlement data. Available views:
- Batch-level: gross GMV, total deductions by category, net settlement, state
- Order-level: per-order deduction breakdown within a batch
- SKU-level: per-SKU fee attribution via
/orders/{id}/statement_transactions - Clawback tracking: dispute reversals matched to originating orders
Profit figures in all AxonRow analytics modules derive from this settlement data layer. No module uses estimated fee rates or order API data as a profit source.