Connecting your TikTok Shop

Problem

You want to connect your TikTok Shop directly so Peanelle syncs orders automatically, instead of uploading CSVs manually every time.

Cause

Peanelle uses TikTok's OAuth flow to get read access to your orders. No passwords — you authorize Peanelle through TikTok's official screen, and TikTok hands Peanelle a scoped access token stored encrypted at rest.

Resolution

Connecting

Go to Import → Connect TikTok Shop (or Settings → Connected Shops).
Click Connect TikTok Shop.
TikTok's authorization screen asks you to confirm the permissions Peanelle requests:
- Read your shop's orders, products, and settlements
- Read your shop's financial reports
- No write access — Peanelle can't create orders, refund buyers, or modify your listings. Read-only by design.
Click Authorize. TikTok redirects you back to Peanelle.
Your first sync starts within a minute. Dashboard will show "Syncing…" until complete.
After that, Peanelle syncs daily at 6 AM UTC via Vercel Cron. You can also click Sync Now on your dashboard for an on-demand pull.

If the connection fails

"Permission denied" or "State mismatch" — usually a stale redirect URL. Go back to Import, try Connect TikTok Shop again from scratch.
"Shop not found" — your Partner Center account might not have the shop linked yet. In TikTok Partner Center, confirm the shop appears under "Authorized Shops." If it doesn't, complete TikTok's shop onboarding first.
"Token expired" — Peanelle proactively refreshes tokens with a 1-hour buffer before expiry. If you see this, the refresh flow failed. Clicking Reconnect from your dashboard banner re-runs the OAuth flow.

Disconnecting

Settings → Connected Shops → your shop → Disconnect. This:

Removes encrypted access and refresh tokens from Peanelle's database
Stops daily syncs for that shop
Preserves already-synced historical orders (won't delete your data)