Get Refund Information¶
Unreleased: This endpoint is available only in the test environment for early integration. Production is not yet available.
Request¶
This endpoint returns refund-information history for a deposit transaction detail ID. Each query also synchronizes file status and refreshes upload or download URLs that are about to expire.
Parameters¶
Path Parameters¶
| Field | Type | Description |
|---|---|---|
| b_id Required | String | Business line ID |
| wallet_detail_id Required | Long | Deposit transaction detail ID |
Response¶
Response Body¶
| Field | Type | Description |
|---|---|---|
| code | Integer | Response code; 0 indicates success |
| message | String | Response message |
| successful | Boolean | Whether the request was successful |
| data | Array<RefundInformation> | Refund-information records; an empty array is returned when no record exists |
RefundInformation (object)
| Field | Type | Description |
|---|---|---|
| wallet_detail_id | Long | Deposit transaction detail ID |
| source_of_funds | String | Source of funds |
| purpose_of_transfer | String | Purpose of transfer |
| refund_address | String | Refund address |
| transaction_hash | String | Original deposit transaction hash |
| amount | Decimal | Amount |
| coin_name | String | Asset name |
| third_party_details | String | Third-party information |
| proof_files | Array<ProofFile> | Proof files and presigned URLs |
| String | Submitter email | |
| status | String | UNDER_REVIEW, WAITING_FILE_UPLOADED, APPROVED, or REJECTED_AWAITING_RESUBMISSION |
| rejected_reason | String | Reason for rejection |
| create_time | String | Submission time |
ProofFile (object)
| Field | Type | Description |
|---|---|---|
| file_id | String | Unique file ID |
| status | String | PENDING_UPLOAD, PENDING_SCAN, APPROVED, REJECTED, or INVALID |
| upload_url | String | Presigned upload URL |
| upload_url_expires_at | Long | Upload URL expiration time in epoch milliseconds |
| download_url | String | Presigned download URL, or null when unavailable |
| download_url_expires_at | Long | Download URL expiration time in epoch milliseconds, or null |
Files in REJECTED or INVALID state receive a new upload URL. Use status to determine the file stage and always use URLs from the latest response.
Response Example¶
{
"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"
}
]
}