B BuffPayment
OpenAPI JSON商户 Console

MERCHANT API · V1

用一个接口接入
CEX 支付。

首期支持 Binance Pay 与 USDT。商户订单号天然幂等，Secret 只在创建时展示一次。

01

鉴权

每个请求都必须携带商户自己的 API Key 与 Secret。凭证只能由服务端保存和调用，不得放入网页或 App 客户端。

x-api-key: bp_live_...x-api-secret: bps_...
02
POST

/api/v1/payments

创建 USDT 支付订单。同一商户重复提交相同 merchantOrderNo 不会重复向渠道下单。

REQUEST
curl --request POST https://api.buffpayment.com/api/v1/payments \
  --header "content-type: application/json" \
  --header "x-api-key: bp_live_your_key" \
  --header "x-api-secret: bps_your_secret" \
  --data '{
    "merchantOrderNo": "ORDER202608170001",
    "amount": 25.17,
    "currency": "USDT",
    "description": "Example order",
    "terminalType": "WEB"
  }'
201 RESPONSE
{
  "id": "cm_example_payment_id",
  "merchantOrderNo": "ORDER202608170001",
  "amount": "25.17000000",
  "currency": "USDT",
  "status": "PENDING",
  "checkoutUrl": "https://pay.example/checkout",
  "expiresAt": "2026-08-17T04:00:00.000Z"
}
03
GET

/api/v1/payments/{id}

查询当前商户自己的订单。服务端不会返回其他商户的交易记录。

04

订单状态

CREATED内部订单已建立，尚未完成渠道创建
PENDING等待付款
PAID渠道回调已通过验签、金额和订单匹配
EXPIRED订单已过期
FAILED渠道创建或处理失败
CLOSED订单已关闭
REFUNDED订单已退款
05

支付确认

浏览器跳转结果不是付款凭证。BuffPayment 只有在 Binance Webhook 通过 RSA 验签，并完成渠道订单号、商户订单号、金额和币种匹配后，才会把订单更新为 PAID。

本地 PAYMENT_MODE=mock 只模拟创建待支付订单，不会伪造真实 Binance 付款成功。