查询退款资料¶
尚未发布:当前仅可在测试环境提前联调,生产环境暂不可用。
请求¶
本接口按入账流水 ID 返回退款资料历史记录。每次查询还会同步文件状态,并刷新即将过期的上传或下载 URL。
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| b_id 必填 | String | 业务线 ID |
| wallet_detail_id 必填 | Long | 入账流水 ID |
响应¶
响应体¶
| 字段 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应码,0 表示成功 |
| message | String | 响应消息 |
| successful | Boolean | 请求是否成功 |
| data | Array<RefundInformation> | 退款资料记录数组;没有提交记录时为空数组 |
RefundInformation(对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| wallet_detail_id | Long | 入账流水 ID |
| source_of_funds | String | 资金来源说明 |
| purpose_of_transfer | String | 转账用途说明 |
| refund_address | String | 退款地址 |
| transaction_hash | String | 原始入账交易哈希 |
| amount | Decimal | 金额 |
| coin_name | String | 币种名称 |
| third_party_details | String | 第三方相关信息 |
| proof_files | Array<ProofFile> | 凭证文件及预签名地址 |
| String | 提交人邮箱 | |
| status | String | UNDER_REVIEW、WAITING_FILE_UPLOADED、APPROVED 或 REJECTED_AWAITING_RESUBMISSION |
| rejected_reason | String | 审核拒绝原因 |
| create_time | String | 提交时间 |
ProofFile(对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| file_id | String | 文件唯一标识 |
| status | String | PENDING_UPLOAD、PENDING_SCAN、APPROVED、REJECTED 或 INVALID |
| upload_url | String | 预签名上传地址 |
| upload_url_expires_at | Long | 上传地址过期时刻,epoch 毫秒 |
| download_url | String | 预签名下载地址;不可下载时为 null |
| download_url_expires_at | Long | 下载地址过期时刻,epoch 毫秒;不可下载时为 null |
REJECTED 或 INVALID 文件会获得新的上传地址。请以 status 判断文件阶段,并使用最近一次响应中的 URL。
响应示例¶
{
"code": 0,
"message": "Success",
"successful": true,
"data": [
{
"wallet_detail_id": 1000123456,
"source_of_funds": "Own funds",
"purpose_of_transfer": "Internal treasury transfer",
"refund_address": "0xabc...",
"transaction_hash": "0xdef...",
"amount": 1000.5,
"coin_name": "USDT",
"third_party_details": "",
"proof_files": [
{
"file_id": "f1",
"status": "APPROVED",
"upload_url": null,
"upload_url_expires_at": null,
"download_url": "https://...",
"download_url_expires_at": 1785657600000
}
],
"email": "ops@yourcompany.com",
"status": "APPROVED",
"rejected_reason": null,
"create_time": "2026-07-31 16:00:00"
}
]
}