创建加密货币充值订单
客户用 USDT 或 USDC 在链上付款,到账后记入你的 USDT 余额。每张订单有一个专属收款地址,返回平台收银台地址(页面上只有加密货币付款),也返回收款地址和应付数量,方便你自己做付款页。到账后平台回调通知你。
POST
/api/open/order/createCryptoDeposit完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。
需要:IP 白名单、开放接口已开通、加密货币充值已为你开通(找平台运营开通)、设置了入金回调地址(或本单传 callbackUrl)。
也可以继续用创建入金订单,传 paymentType = 101 / 102 / 103,效果和本接口一样。
支持的网络和币种
| network | 币种 | paymentType(入金接口用) |
|---|---|---|
TRC20(TRON) | USDT | 101 |
BEP20(BNB Smart Chain) | USDT | 102 |
BEP20(BNB Smart Chain) | USDC | 103 |
USDC 按 1:1 折成 USDT 入账。每笔折成 USDT 不低于 100(以查询收款方式返回的 minAmount 为准)。
请求参数
加密前的 JSON:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
merchantNo | string | 是 | 商户号,和请求外层的一样 |
merchantOrderNo | string | 强烈建议 | 你的商户订单号,最长 50 位,同一个商户不能重复(和入金订单一起查重,40007)。不传时平台随机生成 |
amount | number | 是 | 金额,大于 0、最多 6 位小数 |
currencyType | string | 是 | USDT / USDC:amount 就是要收的币数量;法币代码(如 CNY):按下单时的汇率折成币,汇率锁定在订单上 |
payCoin | string | 否 | 收哪种币:USDT / USDC。不传时:currencyType 是币就收这种币,是法币就收 USDT |
network | string | 是 | TRC20 或 BEP20 |
redirectUrl | string | 否 | 付款完成后收银台「返回商户」按钮的地址 |
callbackUrl | string | 否 | 本单的回调地址,不传用商户后台的入金回调地址 |
json
{
"merchantNo": "你的商户号",
"merchantOrderNo": "C20261021001",
"amount": 200,
"currencyType": "USDT",
"network": "TRC20",
"redirectUrl": "https://shop.example.com/pay/done"
}返回
| 字段 | 类型 | 说明 |
|---|---|---|
url | string | 收银台地址(只有加密货币付款),把客户带过去 |
orderNo | string | 平台订单号(CD 开头) |
merchantOrderNo | string | 你的商户订单号 |
payAddress | string | 本单专属收款地址,只用于这一单 |
payNetwork | string | TRC20 / BEP20 |
payCoin | string | USDT / USDC |
payAmount | number | 客户应付的币数量。按法币下单时是折算后向上取整到 2 位 |
expireAt | string | 付款截止时间,UTC+8,yyyy-MM-dd HH:mm:ss |
json
{
"code": 0,
"message": "success",
"data": {
"url": "https://收银台域名/crypto/?orderId=…&checkoutToken=…",
"orderNo": "CD20261021120000123456",
"merchantOrderNo": "C20261021001",
"payAddress": "T…(本单专属地址)",
"payNetwork": "TRC20",
"payCoin": "USDT",
"payAmount": 200,
"expireAt": "2026-10-21 13:00:00"
}
}收银台地址里带有这笔订单的访问凭证,只发给这位客户本人,不要公开。
自己做付款页时要提醒客户
- 只能转对应网络的对应币种,转错网络或币种的钱无法自动找回;
- 按
payAmount转账,手续费由客户的钱包另付,到账数量不要少于应付数量; - 收款地址只用于这一单,不要保存下来重复使用。
到账规则
| 情形 | 结果 |
|---|---|
| 到账 ≥ 应付 | 按实际到账入账,多付的照样入账(查单 overpaid = true) |
| 到账 < 应付,但这一笔折成 USDT ≥ 最低额 | 按实际到账入账(查单 underpaid = true) |
| 这一笔折成 USDT < 最低额 | 不自动入账,平台人工处理 |
| 分几次付 | 每一笔各自判断、各自入账、各自回调 |
| 付款截止后 24 小时内到账 | 照样自动入账并回调 |
| 超过 24 小时才到账、风控审核中 | 订单显示「待释放」,平台人工处理 |
入账要等区块确认:TRC20 19 个块(约 1 分钟),BEP20 15 个块(约 15 秒);单笔 ≥ 10000 USDT 的订单确认数加倍。
常见错误
| code | 原因 |
|---|---|
| 40016 | 加密货币充值没为你开通;network 不是 TRC20 / BEP20;payCoin 不是 USDT / USDC;这个网络暂不支持这种币(如 TRC20 + USDC) |
| 40019 | amount 不大于 0、超过 6 位小数,或折成 USDT 低于最低额 |
| 40010 | currencyType 是法币但这个法币不可用 / 没有汇率 |
| 40017 | 你没开通这个法币 |
| 40007 | 商户订单号重复 |
| 40000 | 商户订单号超过 50 位 |
其他通用错误(签名、IP 白名单等)见错误码。
订单状态
| orderState | 含义 |
|---|---|
| 1 | 待付款 |
| 2 | 待释放(链上已看到转账,在等区块确认;或到账在人工审核) |
| 6 | 已释放(已记入你的余额,会回调你) |
| 3 | 成功(这张单每一笔到账的回调你都回复了 success) |
| 4 | 已取消 |
| 5 | 已过期(截止前没有到账) |
用查询订单随时可以查到当前状态和链上明细。