三个通道,一处
他们三个都住在 设置 → 在线商店 将页面显示为单个标签卡片。 Shopify 这是一个完全同步(产品+自动下单点)。亚马逊和TikTok商店是 verified-order 渠道:成员自行报告其订单 number 门户网站和平台会从授权卖家处获取权威订单。 API 在授予积分之前。买家个人身份信息绝不会被保存。
Shopify
连接您的Shopify商店,将产品数据导入您的营销活动,并将已完成的订单转化为忠诚度积分——无需编写代码,只需商店域名和管理员API访问令牌。
1. 在 Shopify 中创建管理员 API 访问令牌
在您的 Shopify 管理后台中,前往“设置”→“应用和销售渠道”→“开发应用”→创建一个应用,授予其 read_products 和 read_orders 权限(仅在需要时添加 write 权限),然后安装该应用以显示管理员 API 访问令牌 (shpat_…)。
2 · 连接 SocialHub 中的商店
在应用中,依次点击“设置”→“在线商店”→“在线商店”选项卡。输入您的商店域名(my-store.myshopify.com)和管理员访问令牌 API。该令牌在保存前会与您的商店进行验证,并以静态加密(AES-256-GCM)方式保存——绝不会被记录或再次显示。
3 · 同步并赚取
点击“立即同步”即可获取您的产品目录以用于营销活动。此后,已完成的订单将自动奖励忠诚度积分(与收据的计算公式相同),首次购买/重复购买将触发购买后自动化事件。
// What the platform exposes for the Online Shop connection:
POST /api/shopify/connect { "shopDomain": "my-store.myshopify.com", "accessToken": "shpat_…" }
GET /api/shopify/status // → { connected, shopDomain, status, lastSyncedAt, productCount, apiVersion }
POST /api/shopify/sync // pull products now
POST /api/shopify/disconnect // remove the connection + synced product data
//
// Orders: SocialHub receives Shopify order webhooks (order.fulfilled) and awards points
// keyed by the order id — idempotent, so a replayed webhook never double-awards.
// Connecting an Online Shop requires the Omnichannel plan.亚马逊
允许会员通过已验证的亚马逊订单赚取积分。您授权亚马逊服务提供商 (SP)API 在您的卖家中心账户中使用应用程序(通过亚马逊账户登录);平台使用这些凭证来获取每个自行报告的订单,并且仅在订单真实存在的情况下才授予积分。请在以下位置进行设置: 设置 → 在线商店 → 亚马逊 (团队管理员和系统管理员)
连接设置
密钥 (静态加密 · 只写)
保存并验证针对 SP-API 运行实时活跃度检查,并列出它可以看到的市场。 LWA 刷新令牌不会轮换 — 随时从连接行重新验证。
TikTok 商店
与亚马逊相同的验证-不信任模型,针对 TikTok 商店合作伙伴 API。您授权您商店中的 TikTok 商店合作伙伴应用程序获取应用程序密钥/应用程序密钥和刷新令牌。在设置 → 在线商店 → TikTok 商店(团队管理员和系统管理员)下进行设置。
连接设置
密钥 (静态加密 · 只写)
将“商店密码”留空——“保存并验证”功能会从您的授权商店中自动查找。TikTok 会在每次刷新时轮换刷新令牌;平台会将轮换结果序列化并持久化,因此并发作业之间不会相互干扰。
// Marketplace credentials (Amazon / TikTok Shop) are saved + liveness-checked here.
// Open to team admins (org_owner / org_admin) and system admins; tenant-isolated —
// an admin can only ever read/write their OWN team's channels.
POST /api/admin/channels { teamId, kind: "amazon" | "tiktok", name, config, secrets }
POST /api/admin/channels/{id}/ping // re-verify the connection (discovers shop refs / cipher)
//
// Secrets (refresh_token, client_secret, app_secret, …) are AES-GCM encrypted the
// instant they arrive — write-only, never returned, never logged.如何保证凭证的安全
静态时加密
所有密钥(访问令牌、刷新令牌、客户端/应用密钥)在到达时立即使用 AES-GCM 加密。密钥为只写模式——绝不会返回给浏览器,也绝不会写入日志或电子邮件。
租户隔离
渠道凭证绑定到单个团队。团队管理员(org_owner / org_admin)和系统管理员管理这些凭证,并且只能读取或写入自己团队的连接。
验证,不要相信
对于 Amazon & TikTok Shop,只有平台从卖家授权的 API 获取的订单才会获得积分。买家 PII 会先匹配后丢弃,并且不会保留在订单记录中。
幂等收益
Shopify订单网络钩子和市场订单号均以订单 ID 为键,因此重复提交或重发订单不会获得两次积分。
相关:REST API · POS · OMS · ERP · 会员门户嵌入