Skip to content

创建加密货币充值订单 ​

客户用 USDT 或 USDC 在链上付款,到账后记入你的 USDT 余额。每张订单有一个专属收款地址,返回平台收银台地址(页面上只有加密货币付款),也返回收款地址和应付数量,方便你自己做付款页。到账后平台回调通知你。

POST/api/open/order/createCryptoDeposit

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

需要:IP 白名单、开放接口已开通、加密货币充值已为你开通(找平台运营开通)、设置了入金回调地址(或本单传 callbackUrl)。

也可以继续用创建入金订单,传 paymentType = 101 / 102 / 103,效果和本接口一样。

支持的网络和币种 ​

network币种paymentType(入金接口用)
TRC20(TRON)USDT101
BEP20(BNB Smart Chain)USDT102
BEP20(BNB Smart Chain)USDC103

USDC 按 1:1 折成 USDT 入账。每笔折成 USDT 不低于 100(以查询收款方式返回的 minAmount 为准)。

请求参数 ​

加密前的 JSON:

参数类型必填说明
merchantNostring是商户号,和请求外层的一样
merchantOrderNostring强烈建议你的商户订单号,最长 50 位,同一个商户不能重复(和入金订单一起查重,40007)。不传时平台随机生成
amountnumber是金额,大于 0、最多 6 位小数
currencyTypestring是USDT / USDC:amount 就是要收的币数量;法币代码(如 CNY):按下单时的汇率折成币,汇率锁定在订单上
payCoinstring否收哪种币:USDT / USDC。不传时:currencyType 是币就收这种币,是法币就收 USDT
networkstring是TRC20 或 BEP20
redirectUrlstring否付款完成后收银台「返回商户」按钮的地址
callbackUrlstring否本单的回调地址,不传用商户后台的入金回调地址
json
{
  "merchantNo": "你的商户号",
  "merchantOrderNo": "C20261021001",
  "amount": 200,
  "currencyType": "USDT",
  "network": "TRC20",
  "redirectUrl": "https://shop.example.com/pay/done"
}

返回 ​

字段类型说明
urlstring收银台地址(只有加密货币付款),把客户带过去
orderNostring平台订单号(CD 开头)
merchantOrderNostring你的商户订单号
payAddressstring本单专属收款地址,只用于这一单
payNetworkstringTRC20 / BEP20
payCoinstringUSDT / USDC
payAmountnumber客户应付的币数量。按法币下单时是折算后向上取整到 2 位
expireAtstring付款截止时间,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)
40019amount 不大于 0、超过 6 位小数,或折成 USDT 低于最低额
40010currencyType 是法币但这个法币不可用 / 没有汇率
40017你没开通这个法币
40007商户订单号重复
40000商户订单号超过 50 位

其他通用错误(签名、IP 白名单等)见错误码。

订单状态 ​

orderState含义
1待付款
2待释放(链上已看到转账,在等区块确认;或到账在人工审核)
6已释放(已记入你的余额,会回调你)
3成功(这张单每一笔到账的回调你都回复了 success)
4已取消
5已过期(截止前没有到账)

用查询订单随时可以查到当前状态和链上明细。