Binance Pay 是币安提供的加密货币支付方案集成技能,基于币安交易所生态,用于发送、接收和受理加密支付。
用途:面向需要接受加密付款或向币安用户转账的场景。
主要能力:C2C 转账(0 手续费)、商户支付收款、退款处理、订单管理(跟踪支付状态),并可触达币安生态用户。API 基础地址为 https://bpay.binanceapi.com 。
必要配置:需设置环境变量 BINANCE_PAY_API_KEY(商户 API Key)、BINANCE_PAY_SECRET(API Secret)、BINANCE_PAY_MERCHANT_ID(商户 ID),三项均为必需。
使用方式:请求需带 BinancePay-Timestamp、BinancePay-Nonce、BinancePay-Certificate-SN 和 BinancePay-Signature 头;签名串为 TIMESTAMP、NONCE、payload 三段以换行拼接,用 openssl dgst -sha512 -hmac 生成并转大写。创建订单 POST 到 /binancepay/openapi/v2/order,查询用 /binancepay/openapi/v2/order/query,关闭订单用 /binancepay/openapi/v2/order/close,退款用 /binancepay/openapi/v2/order/refund。
订单状态包括 INITIAL、PENDING、PAID、CANCELED、REFUNDING、REFUNDED、EXPIRED;Webhook 事件有 PAY、REFUND、CANCEL,需用相同签名方式验证。支持币种含 USDT、BUSD、USDC、BTC、ETH、BNB 等。
限制与安全:务必验证 Webhook 签名,不得泄露 API Secret,使用幂等的 merchantTradeNo,履约前检查订单状态。完整字段与最新接口细节以官方文档为准。