为多商户接Binance Pay:授权、隔离与停用

 / 
2

多商户接 Binance Pay 时,最容易搞混的是"谁在收款"和"谁有权限操作"。Binance Pay 的商户体系里,子商户(Sub-Merchant)是虚拟账户,不能登录,它的作用是让渠道伙伴(Channel Partner)在同一套主账户下管理多个商户的订单归属。收款授权则分两层:渠道伙伴用自己的 API Key 创建订单时传入 subMerchantId,钱进入对应商户的结算链路;如果涉及技术商代商户调用接口,还需要走一套独立的授权请求流程,由商户在币安侧批准后才能获得 token 代为操作。

Binance币安
全球交易量最大的加密货币交易所,安全性与流动性行业领先
新手福利:注册立享20%手续费折扣优惠!

标题里的"停用",在币安官方文档中没有对应的"删除子商户"或"停用子商户"按钮。能确认的操作是修改子商户信息(通过 API 或商户后台)。如果你的目标是停止某个子商户继续收款,实际手段是在业务侧不再为该 subMerchantId 创建新订单,以及在授权层面让商户撤销对技术商的授权。下面按授权、隔离、停用三条线说清楚。

子商户隔离靠的是 subMerchantId,不是独立登录

创建子商户时,必填信息包括子商户名称、门店类型(线上/线下/兼有)、MCC 商户类别码、商业注册号、注册国家,线上门店还要站点 URL,线下要有地址。创建成功后拿到一个 subMerchantId,这个 ID 必须存进你的数据库。

隔离的关键动作:每次代某个子商户创建订单时,在 Create Order 请求里带上对应的 subMerchantId。订单归属就靠这个字段区分。如果你漏传或传错,订单会落在主商户或错误的子商户名下,后续对账和结算都会乱。

子商户账户本身不能用于登录,也没有独立的密码或后台入口。所谓"多商户隔离",隔离的是订单归属和报表维度,不是登录权限。商户后台(Merchant Dashboard)里可以按子商户查看订单和导出交易报告。

子商户创建有两条路:API 调 POST /binancepay/openapi/submerchant/add,或者在商户管理门户(MMP)的 [Partner Feature] 标签下点 [Add New Sub Merchant] 手动填。品牌 Logo 是可选项。修改信息同样两条路:API 的 submerchant/modify,或后台找到该子商户点 Edit 修改后确认保存。

技术商代调接口需要商户逐户授权,不能拿一个 token 通吃

如果你不是渠道伙伴、而是作为技术商(Technical Service Provider)帮多个商户接 Binance Pay,资金不经过你,直接结算到商户的币安账户。这种模式下,你需要在商户后台配置 webhook,然后为每一个商户创建授权请求。

授权流程是:先调 Query Scopes 查你的技术商账户被允许哪些权限范围(比如 CHECKOUT、PAYOUT、REFUND 等)。然后调 POST /binancepay/openapi/service/provider/create,带上目标商户的 merchantId 和需要的 scopes,响应里会返回一个 redirectUrl。把商户引导到这个 URL,商户在币安侧批准或拒绝。批准后,你的 webhook 会收到包含 authorizationToken 的回调,这个 token 是每个商户唯一的,存下来,后续代该商户调 API 时用它。

这里有一个容易出错的判断:你不能用一个商户的 token 去操作另一个商户。多商户接入时,token 管理必须按商户维度隔离。授权请求的 bizStatus 是 SUBMIT_AUTH_AGREE 或拒绝状态,收到后应该按状态分支处理,而不是默认通过。

"停用"没有一键开关,实际控制点在业务侧和授权侧

币安公开文档中能查到的子商户管理操作只有创建和修改信息,没有删除或停用子商户的官方接口或按钮。这意味着:

如果你想停止某个子商户继续产生新订单,实际做法是停止在你的系统中为该 subMerchantId 创建新的 Checkout 请求。已经创建的订单不受影响,该结算的继续结算。

如果你想撤销技术商对某个商户的授权,需要商户在币安侧操作(具体撤销入口未在公开文档中详细描述,以商户后台实际界面为准)。技术商侧能做的只是停止使用该 token。

如果子商户信息填错了,走修改流程,不是停用重建。修改后 subMerchantId 不变,已有的订单归属不受影响。

一个编辑判断:多商户接入时,先确定你是渠道伙伴还是技术商,这决定了你走哪条授权路径。渠道伙伴用自己的 API Key + subMerchantId 直接创建订单;技术商需要逐商户拿 authorizationToken。两者不能混用。如果你只是给自己公司接支付、没有"代其他商户收款"的需求,不需要创建子商户,直接用 Direct Merchant 模式即可。

Binance币安
全球交易量最大的加密货币交易所,安全性与流动性行业领先
新手福利:注册立享20%手续费折扣优惠!

参考资料

  1. Binance·How to Amend Binance Pay Sub-Merchant Information?,核查日期:2026-10-22
  2. Binance·Create SubMerchant API,核查日期:2026-10-22
  3. Binance·Technical Service Provider,核查日期:2026-10-22