跳到主要内容

查询收款单（USDT 渠道）

通过商户订单号查询单一 USDT 渠道代收订单。

请求资讯​

  • 请求 URL： /gateway/api/v2/payments/{payment_cl_id}
  • 请求方式： GET

请求头 (Headers)​

参数名类型说明
AuthorizationString{authorization} 系统分配给平台之授权识别

路径参数​

参数名必选类型说明
payment_cl_id是String商户订单号

返回示例​

成功返回​

{
  "error_code": "0000",
  "data": {
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260610001",
    "amount": 200,
    "real_amount": 200,
    "fee": 0,
    "status": 2,
    "create_time": 1749523200,
    "success_time": 1749523500
  }
}

错误返回示例​

{
  "error_code": "0050",
  "error_msg": "查无订单!"
}

返回参数说明​

参数名类型说明
error_codeString错误码，详见全局错误码
error_msgString错误讯息（error_code 不为 "0000" 时返回）
payment_idString平台订单号
payment_cl_idString商户订单号
amountInt提单金额（单位 0.01 USDT）
real_amountInt实际支付金额（单位 0.01 USDT）
feeInt手续费
statusInt订单状态，见下表
create_timeInt创建时间（Unix timestamp）
success_timeInt支付成功时间（Unix timestamp）

订单状态 (status)​

值说明
0待支付
2成功（已到账）
3失败 / 取消 / 超时
备注

USDT 渠道收款订单状态由系统轮询渠道结算结果后更新，商户应以本接口或收款结果通知返回的 status 为准（2 表示成功）。订单不含链上交易明细（哈希、地址等），链上信息由渠道侧管理。

备注​

  • authorization 为系统分配给平台之授权识别，如尚未取得请联系系统人员
  • 金额单位为 0.01 USDT（USDT 数量 ×100）