提交退款资料¶
尚未发布:当前仅可在测试环境提前联调,生产环境暂不可用。
请求¶
仅在收到 FROZEN_PENDING_DOCUMENT 通知时调用。若已有一条审核中的资料记录,不允许重复提交。
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| b_id 必填 | String | 业务线 ID |
请求体参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| 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_file_count 可选 | Integer | 凭证文件数量,最大为 10;省略或传 0 表示无文件 |
请求示例¶
{
"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_file_count": 1
}
声明凭证文件后,请直接向响应中的 upload_url 执行 PUT 上传,并始终使用最近一次查询返回的 URL。
响应¶
响应体¶
| 字段 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应码,0 表示成功 |
| message | String | 响应消息 |
| successful | Boolean | 请求是否成功 |
| data | Object | 退款资料详情 |
data(对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| 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 |
响应示例¶
{
"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": "PENDING_UPLOAD",
"upload_url": "https://...",
"upload_url_expires_at": 1785657600000,
"download_url": null,
"download_url_expires_at": null
}
],
"email": "ops@yourcompany.com",
"status": "WAITING_FILE_UPLOADED",
"rejected_reason": null,
"create_time": "2026-07-31 16:00:00"
}
}