B402 是 Binance 为 x402
协议提供的 Facilitator。API 或数字服务可以通过标准 HTTP 402 Payment Required
流程收取稳定币：买方签署支付授权，B402 在链下验证授权，并由 B402 代付网络 Gas 发起结算交易。资金会直接转入商户配置的收款地址。
B402 提供的能力
- 在 BNB Smart Chain 上支持 x402 V2，并保留 V1 兼容能力。
- 商户交付受保护资源前进行链下验证。
- 由 Facilitator 代付 Gas 完成链上结算。
- 为支持的稳定币提供 EIP-3009 和 Permit2 授权方式。
- 结算接口具备幂等性，重复提交同一支付不会产生第二笔付款。
API 概览
| 操作 | 推荐接口 | 用途 |
|---|---|---|
| Supported | POST /api/v2/b402/supported | 获取实时网络、资产、支付方式和地址配置 |
| Verify | POST /api/v2/b402/verify | 在不广播交易的情况下验证买方支付授权 |
| Settle | POST /api/v2/b402/settle | 将已授权的支付提交到链上 |
| V1 兼容接口 | POST /api/v1/b402/{operation} | 供已有 V1 集成继续使用 |
生产环境 Base URL 为 https://web3.binance.com/build。例如 V2 Supported 的完整 URL 是
https://web3.binance.com/build/api/v2/b402/supported。
新接入请使用 V2。V1 仅用于兼容已有集成，其 payload 结构和地址字段与 V2 不同。
调用关系
B402 接口由商户服务端调用，买方通常只与商户交互：
- 买方请求受保护资源。
- 商户返回 HTTP
402，其中包含一个或多个支付要求。 - 买方选择支付要求并签名，然后携带 x402 payment payload 重试请求。
- 商户先调用 B402 Verify，验证通过后再调用 B402 Settle。
- 结算成功后，商户返回受保护资源。
开始之前
- 登录 Developer Portal。
- 创建或选择 Project，完成 B402 Payments 申请并确认收款地址。该 Project 的
payTo地址设置后不可修改。 - 在同一个 Project 下点击添加新密钥，并在 API 权限页面明确勾选 B402 Payments 后再创建 API Key。请安全保存只展示一次的 Secret Key。如果 API Key 配置了 IP 白名单，请加入商户服务端的公网出口 IP。
- 从商户服务端使用
{"body":{}}发起签名的POST /api/v2/b402/supported请求，确认成功后再开始接收支付。 - 阅读鉴权说明和接入指南。
Developer Portal 内的申请流程是交互式开通流程，不是面向商户服务端的 Public
API。运行时接入只调用本文档中的 /build/api/v2/b402/* 签名接口。
不要在浏览器代码、移动端代码、日志、源码或 402 响应中暴露 Secret Key。B402
只能由可信服务端调用。
网络和资产范围
B402 当前支持 BNB Smart Chain（eip155:56）及已配置的稳定币。支持的资产、合约地址、EIP-712
Domain 信息和 Facilitator 地址均由服务端动态配置。必须通过 POST /api/v2/b402/supported
获取，不要硬编码。
BSC Testnet（eip155:97）仅用于 QA 环境。不要混用测试网 payload、生产凭证或生产接口。
Last modified on