连接 Shopee 店铺（开放平台 · 自研应用）

用你自己在 Shopee 开放平台创建的「Seller In House System（卖家自研系统）」应用，在 SellerTiger 里授权 Shopee 店铺。SellerTiger 只读取，不会改价、不会给买家发消息。

说明（2026-10-17 核对）： Shopee 店铺授权现在可以完成，测试连接 会读出店名；但 Shopee 直连订单还没有上线。授权后，这家店的订单继续来自 Shopee 导出文件 或 BigSeller，数据中心显示「已授权 · 等直连接口」，导入不会被锁。直连上线后自动切换，订单不会重复。

能拿到什么#

开始之前#

• 谁来做： SellerTiger 里有「设置」4 级权限的人（默认是创始人）。Shopee 那边要用店铺的 卖家主账号（子账号一般不能注册开发者）。
• 品牌与渠道： 这个品牌已在 设置 → 品牌与渠道 加了 Shopee 销售渠道。没有渠道时「添加店铺」是灰的。
• 套餐： 每家「已授权」的店占一个店铺名额（手动 / BigSeller 店不占）。名额满了可以升级，或在 设置 → 订阅套餐 加购（每家 ฿290 / 月，不含 7% VAT）。
• 时间： Shopee 要审核开发者和应用（Go Live），预留几天。

不想做开发者注册？ 可以只把店铺登记为 手动 / BigSeller 同步，订单用 BigSeller 或 Shopee 导出文件进来，见 连接 BigSeller 和 数据中心。

第 1 步 · 凭证：在 Shopee 开放平台拿到 Partner ID 和 Partner Key#

1. 用卖家主账号登录 open.shopee.com，右上角 Console，按提示注册为开发者，类型选 Seller In House System，提交公司资料，等审核通过。
2. App List → Create App，App Category 选 Seller In House System，填应用名（例如 SellerTiger）和用途。
3. 应用详情页先显示 Test Partner ID / Test Partner Key（只能用于沙箱）。点 Go Live 提交上线，Shopee 批准后同一页面出现 Live Partner ID 和 Live Partner Key（点眼睛图标显示 Key）。
4. 在应用设置里填 Redirect URL Domain（测试和正式各一栏）：填 SellerTiger 地址的域名，例如 app.sellertiger.com（见第 4 步，回调地址在 SellerTiger 弹窗里可复制）。

要复制的：Live Partner ID（纯数字）和 Live Partner Key。Partner Key 等同密码，不要发到群里或邮件里。

第 2 步 · 加密 / Webhook：不需要#

SellerTiger 不使用 Shopee 推送，不需要在 Shopee 配置 Webhook 或加密。

第 3 步 · 权限：用 Seller In House System 默认权限#

Seller In House System 应用默认可读取自己店铺的店铺、订单、商品、物流和结算数据。聊天和评价需要 Shopee 额外开通，SellerTiger 目前不用。

第 4 步 · 回调：在 SellerTiger 添加店铺并复制回调地址#

1. SellerTiger → 设置 → 连接与授权 → 「销售渠道」里点 Shopee。
2. 在「要绑定的店铺（来自「品牌与渠道」）」里，在对应店铺旁点 添加并绑定（或上方 添加店铺）。
3. 填写：名称（例如 FG Shopee）、品牌、站点 Region（TH）、环境（正式；只有用 Test 密钥时选 沙箱测试）。Shop ID / Seller ID 可以不填。
4. 授权方式 选 自研应用（自己的 App Key），先点 保存（新店铺要先保存才能填凭证）。
5. 在 应用凭证 填 Partner ID、Partner Key（Live），Shop ID（可选） 留空即可，点 保存（显示「已加密保存」）。
6. 复制下方 回调地址 Redirect URL：https://app.sellertiger.com/api/stores/oauth/shopee/callback。确认它的域名 app.sellertiger.com 已填在 Shopee 应用的 Redirect URL Domain 里。

第 5 步 · 授权：去 Shopee 同意#

1. 在同一窗口点 去平台授权，Shopee 授权页在新标签页打开。
2. 用 这家店的卖家账号 登录，确认授权。
3. 自动回到 SellerTiger，提示「店铺授权成功」，店铺显示 已授权 和「令牌有效至 …」。

请在点「去平台授权」后 30 分钟内完成；Shopee 自己的登录页只有几分钟有效，打开后尽快登录。

第 6 步 · 开启同步：检查并让数据进来#

1. 在店铺行点 测试连接，提示「连接成功」并显示店铺名 = 成功。
2. 打开 数据中心 → 电商平台 → Shopee：店铺显示 已授权 · 等直连接口（直连上线后变为 直连中）。
3. 在直连上线前，按 数据中心 第 10 步导入 Shopee 导出文件（My Orders → Export；My Income → Released → Income report），或用 BigSeller。

令牌与续期#

• access token 约 4 小时，SellerTiger 自动续期；店铺授权本身有效 365 天，到期前在店铺上点 重新授权。
• 修改 Partner ID 或 Partner Key 后，旧令牌会被清除，需要重新授权。
• 解除授权：撤销令牌，之后不再通过 API 读取这家店，名额释放，随时可以重新授权。

常见问题#

SellerTiger 服务商一键授权#

SellerTiger 正在申请 Shopee 服务商资格。批准前「SellerTiger 服务商授权（审批中）」不能用；批准后无需注册开发者，点授权即可。