创建入金订单（收银台）

创建一笔入金订单，返回平台收银台地址。把客户带到这个地址，客户按页面上的收款账户付款。到账后平台回调通知你。

POST/api/open/order/createBuyOrder

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

需要：IP 白名单、开放接口已开通、设置了入金回调地址（或本单传 callbackUrl）。

请求参数

加密前的 JSON：

参数	类型	必填	说明
`merchantNo`	string	是	商户号，和请求外层的一样
`merchantOrderNo`	string	强烈建议	你的商户订单号，同一个商户不能重复（40007）。不传时平台随机生成，你将无法用它查询
`amount`	number	是	法币金额，大于 0、最多两位小数
`currencyType`	string	是	法币代码，如 `CNY`、`THB`、`VND`。必须是你已开通的法币
`customerName`	string	是	付款人真实姓名。客户必须用这个名字的账户付款；也用于黑名单检查
`customerIdCardNumber`	string	否	付款人证件号（用于黑名单检查）
`customerPhoneNumber`	string	否	付款人电话
`customerCountry`	string	否	付款人国籍
`paymentType`	int	否	指定收款方式，指定后客户只能用这种方式付款。人民币：`1` 银行卡、`2` 微信、`3` 支付宝；其他法币用查询收款方式返回的编号
`redirectUrl`	string	否	付款完成后收银台跳回的地址
`hideUsdt`	bool	否	收银台是否隐藏 USDT 数量
`callbackUrl`	string	否	本单的回调地址，不传用商户后台的入金回调地址

json

{
  "merchantNo": "你的商户号",
  "merchantOrderNo": "A20261013001",
  "amount": 100,
  "currencyType": "CNY",
  "customerName": "张三",
  "redirectUrl": "https://shop.example.com/pay/done"
}

字段	类型	说明
`url`	string	收银台地址，把客户带过去

json

{
  "code": 0,
  "message": "success",
  "data": { "url": "https://收银台域名/#/step1?orderId=…&checkoutToken=…&hideUsdt=&redirectUrl=…" }
}

收银台地址里带有这笔订单的访问凭证，只发给这位客户本人，不要公开。

常见错误

40004、40005、40007、40010、40011、40012、40013、40015、40016、40017、40019，见错误码。

订单状态

orderState	含义
1	待付款
2	待释放（客户已付款，等交易员确认收款）
6	已释放（平台确认收到钱，USDT 已记入你的余额，会回调你）
3	成功（你已回复回调 `success`）
4	已取消
5	已过期（客户没在规定时间内付款）
7	已冲正

用查询订单随时可以查到当前状态。

创建入金订单（收银台） ​

请求参数 ​

返回 ​

常见错误 ​

订单状态 ​

创建入金订单（收银台）

请求参数

返回

常见错误

订单状态