Submit Refund Information¶
Unreleased: This endpoint is available only in the test environment for early integration. Production is not yet available.
Request¶
Call this endpoint only after receiving FROZEN_PENDING_DOCUMENT. A new submission is rejected while an existing record is under review.
Parameters¶
Path Parameters¶
| Field | Type | Description |
|---|---|---|
| b_id Required | String | Business line ID |
Request Body¶
| Field | Type | Description |
|---|---|---|
| wallet_detail_id Required | Long | Deposit transaction detail ID |
| source_of_funds Required | String | Source of funds |
| purpose_of_transfer Required | String | Purpose of transfer |
| refund_address Required | String | Requested refund destination address |
| transaction_hash Required | String | Original deposit transaction hash |
| amount Required | Decimal | Amount |
| coin_name Required | String | Asset name |
| third_party_details Optional | String | Third-party information |
| proof_file_count Optional | Integer | Number of proof files, maximum 10; omit or use 0 when no files are required |
Request Example¶
{
"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
}
When proof files are requested, upload each file by sending its content with PUT to the returned upload_url. Always use the URL from the latest query.
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 | Object | Refund information |
data (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 |
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": "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"
}
}