查询出款单（渠道型加密货币）
通过商户订单号查询单一渠道型加密货币代付订单。
请求资讯
- 请求 URL：
/gateway/api/v2/payouts/{payout_cl_id} - 请求方式：
GET
请求头 (Headers)
| 参数名 | 类型 | 说明 |
|---|---|---|
| Authorization | String | {authorization} 系统分配给平台之授权识别 |
路径参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| payout_cl_id | 是 | String | 商户订单号 |
返回示例
成功返回
{
"error_code": "0000",
"data": {
"payout_id": "DEMOPO0123456",
"payout_cl_id": "payout_20260610001",
"amount": 200,
"fee": 0,
"currency": "usdt",
"target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
"status": 3,
"create_time": 1749523200,
"success_time": 1749523500
}
}
错误返回示例
{
"error_code": "0050",
"error_msg": "查无订单!"
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | String | 错误码，详见全局错误码 |
| error_msg | String | 错误讯息（error_code 不为 "0000" 时返回） |
| payout_id | String | 平台订单号 |
| payout_cl_id | String | 商户订单号 |
| amount | Int | 提单金额（单位 0.01） |
| fee | Int | 手续费 |
| currency | String | 币种（usdt / jpyc） |
| target_address | String | 收款链上地址 |
| status | Int | 订单状态，见下表 |
| create_time | Int | 创建时间（Unix timestamp） |
| success_time | Int | 打款成功时间（Unix timestamp） |
订单状态 (status)
| 值 | 说明 |
|---|---|
| 0 | 排程中 |
| 1 | 待处理 |
| 2 | 处理中（链上打款进行中） |
| 3 | 成功（已打款） |
| 4 | 已取消 |
| 5 | 失败（已退款） |
| 6 | 审核中 |
备注
渠道型加密货币代付订单状态由系统轮询上游渠道结果后更新，商户应以本接口或出款结果通知返回的 status 为准（3 表示打款成功、5 表示失败已退款）。订单不含完整链上交易明细（交易哈希等），链上信息由渠道侧管理。
备注
authorization为系统分配给平台之授权识别，如尚未取得请联系系统人员- 金额单位为 0.01（币量 ×100）