multi-channel marketplace listing · field note

Confirm TikTok Shop's real webhook signature scheme

A working diagnosis of this problem and the sequence that actually resolves it, written from the operational side rather than the marketing side.

Reported context: `src/services/webhook-verify.ts` implements a placeholder HMAC-SHA256-over-raw-body check — it has **not** been validated against TikTok Shop's actual Partner Center signing scheme (header name, whether the signed string includes path/timestamp). Confirm the real scheme against current official TikTok Shop Partner Center docs before this gates real production traffic. Reference: `docs/SPEC.md` Open Question #1.

What is actually going on

Localisation failures come from machine-translating titles without adapting measurement units, tax labels, or cultural buying cues.

Cross-channel sync breaks when the source of truth is ambiguous — two systems both writing inventory produce oversells.

The sequence that works

  1. Pull the exact rejection reason code from the marketplace API rather than the dashboard summary, since the two frequently differ.
  2. Rebuild titles against the marketplace style guide: character limits, capitalisation rules, prohibited claims, and required attributes.
  3. Localise rather than translate: convert units, adapt the guarantee wording to local consumer law expectations, and rewrite the first three bullet points for local buying motivation.
  4. Establish a single inventory source of truth and make every other channel read-only against it.
  5. Set a daily reconciliation report that flags any SKU where channel quantities diverge by more than one unit.

Where people lose time

Verify before you trust it

Run the checks above against your own data instead of adopting them at face value. The failure modes are specific enough that a single afternoon of measurement will either confirm this diagnosis or rule it out — both outcomes are useful, and guessing is not.

TikTok Shop Hook Engine
A ready-to-use package for exactly this workflow — $27.55, delivered immediately.
Get TikTok Shop Hook Engine · $27.55
Sold via Gumroad, which acts as merchant of record and handles payment and applicable taxes. All sales are final; see the return policy before purchase.