Skip to main content

​
USDT 充值

ZTProxy 支持通过 USDT TRC20 创建充值订单、查询链上支付状态、查看钱包信息和查询充值订单列表。所有接口都需要 Bearer Token。

​
获取收款钱包

curl -X GET "https://backend.ztproxy.net/api/usdt/wallet-info" \
  -H "Authorization: Bearer <token>"
响应包含收款地址、网络、币种、当前汇率和最低充值金额。

​
创建充值订单

curl -X POST "https://backend.ztproxy.net/api/usdt/create-order" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cny": 1000
  }'
字段说明：
字段类型必填说明
amount_cnynumber是充值人民币金额，必须大于 0，单笔不超过 50000。
成功响应： 
{
  "code": 0,
  "msg": "充值订单创建成功",
  "data": {
    "order_id": "USDT202605260001",
    "wallet_address": "Txxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "network": "TRC20",
    "currency": "USDT",
    "amount_usdt": "138.123456",
    "amount_cny": 1000,
    "usdt_rate": 7.24,
    "min_amount_usdt": 1,
    "wallet_explorer_url": "https://tronscan.org/#/address/...",
    "created_at": "2026-05-26 10:00:00"
  }
}
系统会生成唯一的 USDT 金额，避免多个待支付订单金额相同导致无法匹配。

​
查询充值状态

curl -X GET "https://backend.ztproxy.net/api/usdt/check-status?order_id=USDT202605260001" \
  -H "Authorization: Bearer <token>"
状态说明：
状态说明
pending等待支付确认。
confirmed已确认，系统已增加用户余额。
cancelled已取消。
查询状态时，系统会检查链上是否存在匹配转账；如果匹配成功，会确认订单并更新用户余额。

​
查询充值订单列表

curl -X GET "https://backend.ztproxy.net/api/usdt/orders?page=1&page_size=10&status=pending" \
  -H "Authorization: Bearer <token>"
查询参数：
参数说明
page页码，默认 1。
page_size每页数量，最大 500。
status订单状态筛选。
start_date开始日期，格式 YYYY-MM-DD。
end_date结束日期，格式 YYYY-MM-DD。
当前账号只能查看权限范围内的充值订单。

​
取消充值订单

curl -X POST "https://backend.ztproxy.net/api/usdt/cancel-order" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "USDT202605260001"
  }'
只有 pending 状态的订单可以取消。