三方站对接说明（Token 自动续期）

适用：自有业务站 / 同源礼品站站长，对接发货猫视频号官方代发。本文说明改版后如何配置供货商与取票，日常无需再手工粘贴 AccessToken。

品牌站固定域名：https://fahuomao.com。拉单取号业务接口见路径 A / 路径 B；本文只讲授权与 Token。

1. 角色分工

事项谁负责
微信开放平台 ticket / 去使用 / 签发取票密钥 / Token 缓存发货猫品牌站
后台填供货商 ID、取票密钥；拉单 / 分配 / 取号三方站（贵站）
商家关联供货商、分配代发微信小店商家侧

2. 贵站必填配置

配置项是否必填说明
brand_core_base是固定 https://fahuomao.com；is_brand_core=false
供货商店铺名称是去使用成功页复制
供货商 ID（AppID）是去使用页复制；商家「关联供货商」也用此 ID
品牌取票密钥是去使用页「取票密钥」，形如 fhm_…；不是供货商 ID，也不是发货猫运维 cron_key
供货商 AccessToken否仅自动取票失败时作兜底；日常可空
禁止在贵站填写微信第三方 component AppID/Secret/Token/AESKey；禁止把开放平台事件 URL 指到贵站。

3. 开通步骤（站长）

  1. 服务市场订购发货猫供货商代发： https://store.weixin.qq.com/supplier/servicemarket/detail?serviceId=4598151485338828805
  2. 点「去使用」，打开： https://fahuomao.com/api/supplierauth
  3. 成功页复制并回填到贵站后台（设置 → API → 视频号官方）：
    • 供货商店铺名称
    • 供货商 ID
    • 取票密钥 → 填「品牌取票密钥」
  4. 保存。建议打开：拉单前自动分配、绑店自动审核、取号后自动发货（按业务需要）。
  5. 商家订购商家应用后去使用拿 BT1，在贵站完成绑店；商家在微信侧关联贵站供货商 ID，并分配代发后再拉单取号。

4. Token 怎么续期（贵站无需关心计划任务）

  1. 发货猫品牌站定时预热各已授权供货商的 AccessToken（运维自用，站长无感）。
  2. 贵站用票时（拉单 / 分配 / 取号）向品牌站拉取：
GET https://fahuomao.com/api/supplierauth/token/?appid={本站供货商ID}&key={取票密钥} 
curl -sS 'https://fahuomao.com/api/supplierauth/token/?appid=wx你的供货商AppID&key=fhm_去使用页密钥'

5. 成功返回示例

{
  "ok": true,
  "code": 0,
  "msg": "ok",
  "data": {
    "appid": "wx…………",
    "access_token": "……",
    "expires_in": 7200
  }
}

6. 常见失败与处理

现象处理
缺少取票密钥 / key 无效默认不强制 key（兼容旧站）。若运维开启了 require_token_pull_key，再核对「品牌取票密钥」与去使用页一致；勿填供货商 ID
尚未签发取票密钥供货商对本应用再点一次「去使用」
无 authorizer_refresh_token供货商未完成授权；去使用 + 联系发货猫同步 authorizers
HTTP 404 / 返回 HTML确认 URL 为 …/token/ 且 brand_core_base=https://fahuomao.com
AccessToken 过期报错确认已填取票密钥且能调通 token 接口；勿长期依赖粘贴的旧 Token
取票密钥泄露联系发货猫运维按该 appid 重置；或去使用 URL 加 rotate_pull_secret=1 后换新密钥并更新后台

7. 自测清单

8. API 对接 3502 取号站时的供货商选择

代理站若对接了发货猫 3502 的视频号快递，关联/分配代发必须用该快递带回的上游供货商 ID（list 接口的 wx_supplier_id），不能用代理站自己后台的自营供货商 ID。否则订单分给了代理站供货商，3502 取号时查不到代发单。
用户选的快递关联 / 分配目标
API 对接 3502 的快递3502（上游）供货商 AppID
代理站自营、非 API 快递代理站后台自己配置的供货商 AppID

同源礼品站已按快递自动解析；自研系统请：list 取对应快递的 wx_supplier_id → 商家关联并分配给该 ID → 再 buy 到 3502。

9. 相关链接

发货猫 · 视频号官方对接文档 · https://fahuomao.com/open/ · 云 API https://api.fahuomao.com