Skip to content
MSO CloudDocumentation

Connect a marketplace

On this page

Connect a TikTok Shop, Shopee or Lazada seller account so orders, inventory, settlements and creator data sync on a schedule.

Who can do this: an owner or admin who also administers the seller account itself.

Before you start#

  • The organization has at least one brand; every connection belongs to exactly one.
  • Have the credential for the marketplace to hand:
Marketplace Credential Streams
TikTok Shop App Key, App Secret, Shop ID; tokens arrive via Authorize orders, settlements, live, video, products, creators, affiliate
Shopee Partner ID, Partner Key, Shop ID, access and refresh token orders, inventory
Lazada App Key, App Secret, Country; tokens arrive via Authorize orders, products, inventory, settlements
Kết nối · Connectors/connectors+ Thêm kết nối1Topology: sources → platform → reportsMarketplacesAds & WebSpreadsheetsFilesOrders, inventory, creators, settlementsMarketplaces · 1st-partyTikTok Shop · Acme main shopBrand: Acme · last sync 08:15 · every 15 minutesStreams: orders, settlements, live, video, products, creatorsTestSyncEditShopee · Acme ShopeeTest failed: token expired · paste a fresh token over the old oneĐối soát dữ liệu · Data validation · /validationSynced total for the period vs the marketplace's own export file6Thêm kết nối mới · Add new connectorSàn thương mại điện tử · MarketplacesTikTok ShopShopeeLazada2Nhãn hiển thị · Display labelAcme main shopThương hiệu · BrandAcme3KHOÁ KẾT NỐI · CONNECTION KEYApp Key7a1f...App Secret••••••••••••••Service IDfor Authorize buttonShop ID7495185871651965830Access Tokenauto after AuthorizeRefresh Tokenauto after AuthorizeTần suất đồng bộ · Sync frequency15 phút · 15 minutes5Keys are encrypted on save and never shown again; the input stays empty on edit.AuthorizeTestCreate4
Left: Connectors ('Kết nối'). Right: the Add new connector wizard. Callout numbers match the steps.

Steps#

  1. Open Connectors ("Kết nối") and select Add connector ("Thêm kết nối").
  2. Pick the marketplace under Marketplaces ("Sàn thương mại điện tử").
  3. Enter a display label, choose the brand, and paste the credential. For TikTok Shop and Lazada select Authorize, or copy the customer link so the seller approves it themselves (valid 7 days).
  4. Select Test: a green result means the key reads, not that history has arrived.
  5. Set the sync frequency (15 minutes by default, up to daily, or manual only) and select Create.
  6. After the first sync, check the card shows a last-sync time, then reconcile at Data validation ("Đối soát dữ liệu") against one of the marketplace's own export files. Shopee live verification: status.

Keys are encrypted on save and never shown again; the input stays empty when you edit, which is not data loss.

If it fails#

Symptom Cause Fix
No marketplace group in the picker The organization's shape has no commerce plane A blueprint choice; see Organization types.
Test fails after pasting the key Token expired, or the wrong environment Get a fresh token and paste it over the old one, or re-authorize.
Recent days are missing The marketplace settles numbers late Wait: a 7-day re-pull runs nightly at 02:00 and fills the gap.
Older orders never arrive Outside the re-pull window On the card choose Sync then Re-pull a date range ("Nạp lại theo khoảng thời gian").