Skip to content

创建入金订单(自建收银台) ​

适合自己做付款页面的商户。下单后平台直接返回分配到的收款账户,由你展示给客户。之后:

到账后平台照常回调。

POST/api/open/order/createBuyOrder2

完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。

请求参数 ​

和创建入金订单(收银台)完全一样(redirectUrl、hideUsdt 用不到)。

paymentType 传 101 / 102 / 103 时建的是加密货币充值订单,返回字段和创建加密货币充值订单一样(payAddress、payAmount 等),不分配收款账户,也不用调标记已付款:链上到账后平台自动处理。

返回 ​

字段类型说明
order.orderNostring平台订单号
order.merchantOrderNostring你的商户订单号
order.totalAmountnumber法币金额
order.usdtnumber折合 USDT 数量(扣手续费前)
order.currencystring法币代码
order.orderTimestring下单时间
cards[]array分配给这笔订单的收款账户,客户付款到其中一个。可能有多个,而且可能属于不同的收款人,见展示收款账户
cards[].cardIdint收款账户编号,标记已付款时要传
cards[].paymentTypeint收款方式编号
cards[].realNamestring这个账户的收款人姓名(每个账户各自的,不一定相同)
cards[].bankNamestring银行名称
cards[].bankBranchstring支行
cards[].cardNostring银行卡号
cards[].payAccountstring收款账号:支付宝、微信账号,以及 MoMo、TrueMoney、PIX 等电子钱包账号(这类方式卡号为空)
cards[].payQrCodestring收款码图片地址或付款链接(部分收款方式才有,可能为空;为空时请展示 realName + payAccount 让客户按账号转账)
json
{
  "code": 0,
  "message": "success",
  "data": {
    "order": {
      "orderTime": "2026-10-13 12:00:00",
      "orderNo": "PI1845290017342758912",
      "totalAmount": 100,
      "usdt": 13.7,
      "merchantOrderNo": "A20261013001",
      "currency": "CNY"
    },
    "cards": [
      { "cardId": 1024, "paymentType": 1, "payQrCode": "", "payAccount": "", "realName": "李四", "bankName": "中国工商银行", "bankBranch": "北京海淀支行", "cardNo": "6222000000000000" },
      { "cardId": 2048, "paymentType": 3, "payQrCode": "", "payAccount": "wangwu@example.com", "realName": "王五", "bankName": "", "bankBranch": "", "cardNo": "" }
    ]
  }
}

WARNING

收款账户信息只展示给这笔订单的客户本人。请提醒客户用下单时的 customerName 本人账户付款、金额要和订单完全一致。

展示收款账户 ​

没有传 paymentType 时,平台会尽量把这个金额能用的收款方式都给出来(例如银行卡、支付宝、微信),这些账户可能属于不同的收款人。请这样展示:

  • cards 里有几个就展示几个,每个账户按它自己的 realName 显示收款人,不要把第一个账户的收款人当成整笔订单的收款人;
  • 同一种收款方式(同一个 paymentType)也可能有不止一个账户,请全部展示或让客户选一个;
  • 每笔订单的收款账户都可能不同,不要缓存或复用之前订单的账户;
  • 客户付款后调用标记已付款,cardId 传客户实际转账到的那个账户。

传了 paymentType 的订单只返回这一种方式的账户。

不同收款人的汇率可能略有不同,实际到账的 USDT 可能和下单返回的 usdt 有小幅差异,以回调和查询订单为准。

常见错误 ​

除了收银台下单的错误外,收款通道请求失败时返回 400。