创建入金订单(自建收银台)
适合自己做付款页面的商户。下单后平台直接返回分配到的收款账户,由你展示给客户。之后:
到账后平台照常回调。
POST
/api/open/order/createBuyOrder2完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。
请求参数
和创建入金订单(收银台)完全一样(redirectUrl、hideUsdt 用不到)。
paymentType 传 101 / 102 / 103 时建的是加密货币充值订单,返回字段和创建加密货币充值订单一样(payAddress、payAmount 等),不分配收款账户,也不用调标记已付款:链上到账后平台自动处理。
返回
| 字段 | 类型 | 说明 |
|---|---|---|
order.orderNo | string | 平台订单号 |
order.merchantOrderNo | string | 你的商户订单号 |
order.totalAmount | number | 法币金额 |
order.usdt | number | 折合 USDT 数量(扣手续费前) |
order.currency | string | 法币代码 |
order.orderTime | string | 下单时间 |
cards[] | array | 分配给这笔订单的收款账户,客户付款到其中一个。可能有多个,而且可能属于不同的收款人,见展示收款账户 |
cards[].cardId | int | 收款账户编号,标记已付款时要传 |
cards[].paymentType | int | 收款方式编号 |
cards[].realName | string | 这个账户的收款人姓名(每个账户各自的,不一定相同) |
cards[].bankName | string | 银行名称 |
cards[].bankBranch | string | 支行 |
cards[].cardNo | string | 银行卡号 |
cards[].payAccount | string | 收款账号:支付宝、微信账号,以及 MoMo、TrueMoney、PIX 等电子钱包账号(这类方式卡号为空) |
cards[].payQrCode | string | 收款码图片地址或付款链接(部分收款方式才有,可能为空;为空时请展示 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。