同源礼品站接入 Demo

适用：已部署与发货猫配套的礼品站同源程序的站长。目标是在本站自己取号、自己扣会员款，订购与授权仍走发货猫品牌站。

1. 角色分工（先看清）

微信服务市场
      │
      ▼
fahuomao.com（品牌核心）
  · 去使用 / BT1 / 供货商 Token / ticket
      │
      ▼
https://你的礼品站域名（消费端）
  · 回填供货商名称 + ID + 取票密钥（AccessToken 非必填）
  · 用票时向品牌站拉取 Token（自动续期）
  · 绑店入库、拉单、取号、代发
  · 会员下单扣款

2. 配置要求（必查）

配置文件或后台「视频号官方」相关项：

'is_brand_core'   => false,                 // 必须 false
'brand_core_base' => 'https://fahuomao.com', // 只填发货猫
// component_app_id / secret / token / aes_key 全部留空，不要填

3. 后台开通演示步骤

1. 登录礼品站后台 → 设置 → API → 视频号官方 → 开通。
2. 点击订购服务（供货商代发），在微信服务市场完成订购。
   订购链接见 订购与授权。
3. 点击去使用，打开： https://fahuomao.com/api/supplierauth
4. 在去使用成功页复制并回填到本站：
   • 供货商店铺名称（必填）
   • 供货商 ID（必填）
   • 取票密钥 → 填「品牌取票密钥」（去使用页复制，形如 fhm_…）
   • 供货商 AccessToken（非必填）
5. 保存。可按需打开：
   • 拉单前自动分配代发
   • 绑店自动审核关联
   • 取号后自动代发发货
6. 到 快递编辑 → 视频号，为要用的快递配置取号参数（如 shop_id / ewaybill_acct_id 等，以后台字段为准）。

4. 商家绑店演示

1. 商家订购发货猫商家应用后，打开： https://fahuomao.com/api/shopauth
2. 复制绑店凭证 BT1....（约 15 分钟有效、一次性）。
3. 在礼品站前台/发货助手中提交该凭证完成绑店（本站会请求发货猫校验 BT1）。

品牌校验接口（本站程序已封装，一般无需手工调）：

POST https://fahuomao.com/api/bind_ticket/consume
ticket=BT1.xxxx.xxxx

5. 本站自检

浏览器打开（把域名换成贵站）：

消费端期望类似：

{
  "msg": "consumer_site",
  "data": {
    "is_brand_core": false,
    "brand_core_base": "https://fahuomao.com"
  }
}
# 本站没有 has_ticket 是正常的；有 ticket 的是发货猫品牌站

品牌站诊断（对照用）：

6. 业务验收（按顺序）

• 配置 is_brand_core=false，brand_core_base=https://fahuomao.com
• 本站 ticket_status 显示消费端
• 后台已回填供货商名称 / ID / 取票密钥（品牌取票密钥）；AccessToken 可空
• 商家去使用拿到 BT1，本站绑店成功
• 微信侧：商家已关联该供货商并审核通过（可开自动审核）
• 测试订单已分配代发
• 快递侧视频号取号参数已配置
• 能拉单并取到官方面单；可选验证取号后自动发货

微信侧细节见 微信侧准备；若还要给下游开放 HTTP，见 路径 B · 云 API。

7. 常见问题（同源站）

8. 和「云 API」的区别