ParcelPilot
Help

TikTok Shop (Standalone)

This guide covers what ParcelPilot needs to connect to TikTok Shop via a direct (standalone) TikTok integration, where to find it in TikTok Shop tooling, and where to enter it in ParcelPilot.

Note: This is separate from TikTok orders that flow into ParcelPilot indirectly via another channel (e.g. TikTok → Shopify). Use this page for the direct TikTok Shop integration.

What ParcelPilot needs

  1. Environment: Production or Sandbox
  2. App Key
  3. App Secret
  4. Optional Service ID / App ID if TikTok shows it separately in Partner Center
  5. OAuth authorization from the seller shop
  6. Optional:
    • Shop cipher / shop ID (if you already have it)
    • API base URL (advanced; usually leave blank)
    • API version (advanced; usually leave blank)

Where to find it in TikTok

The exact menu names vary by region and TikTok program access, but the common flow is:

  1. TikTok Shop Seller Center → Developer / Open Platform.
  2. Create or open your app.
  3. Copy the App Key and App Secret. If TikTok shows a separate Service ID, copy that too.
  4. Register ParcelPilot's public callback URL in TikTok as the app Redirect URL.
  5. In ParcelPilot, save the integration and click Connect TikTok (OAuth).
  6. Approve the seller authorization flow. ParcelPilot will store the Access Token and Refresh Token automatically.

Notes:

  • Use Production credentials/tokens for live shops.
  • Use Sandbox only for sandbox testing.

Where to enter it in ParcelPilot

ParcelPilot Admin → Integrations → Client Integrations → create/edit an integration with Platform = TikTok Shop (Standalone).

Fill these fields:

  • Environment → credentials.tiktok.environment
  • Shop cipher / shop ID (optional) → credentials.tiktok.shop_cipher
  • API base URL (optional override) → credentials.tiktok.base_url
  • API version (optional override) → credentials.tiktok.version
  • App Key → credentials.tiktok.app_key
  • App Secret → credentials.tiktok.app_secret
  • Service ID / App ID (OAuth) → credentials.tiktok.service_id
  • Access Token → credentials.tiktok.access_token
  • Refresh Token → credentials.tiktok.refresh_token

OAuth callback URL:

  • Register ParcelPilot's public TikTok callback URL at /tiktok/auth/callback as the Redirect URL in TikTok Partner Center.

Operational settings:

  • Enable stock sync / Stock master (if inventory sync is required) → E-commerce settings
  • Push shipment confirmations (tracking) to channel (if tracking push is required) → E-commerce settings

Troubleshooting

401 / 403 errors

  • Confirm the correct environment (Production vs Sandbox).
  • Confirm the app has the required permissions/scopes for the actions you’re attempting.
  • Re-authorize the app and refresh tokens if needed.

Token issues

  • ParcelPilot refreshes the access token automatically before expiry and stores the newly issued refresh token each time.
  • TikTok's docs indicate the shop must be re-authorized after 365 days even if refreshes have continued to roll forward.
  • If tokens were revoked in TikTok tooling, reconnect the integration via Connect TikTok (OAuth).

Missing orders?

If orders are missing in ParcelPilot, you can manually backfill using Pull Orders on the integration:

Security notes

  • Treat App Secret and tokens as sensitive credentials.
  • Rotate secrets/tokens if they’re exposed.