Create Refund Order¶
Unreleased: This endpoint is available only in the test environment for early integration. Production is not yet available.
Request¶
Call this endpoint only when the deposit status is frozen_refund_waiting_address. Identical requests are idempotent and do not create duplicate refund orders.
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 |
| order_no Required | String | API order ID, up to 50 characters |
| same_way Optional | Boolean | Return to the original sender. Defaults to false. When true, the destination must be an original sender address. |
| dest_address Required | String | Refund destination address; it must not be a Cactus internal address |
| desc Optional | String | Order description |
| memo_type Optional | String | Memo type for chains that require it |
| memo Optional | String | Memo value |
Request Example¶
{
"wallet_detail_id": 1000123456,
"order_no": "RF202609220001",
"same_way": true,
"dest_address": "0xabc...",
"desc": "KYT refund"
}
ETH/TRON cold-contract token wallets do not currently support refund orders. Address review depends on the deposit status; a successful response does not mean the refund has arrived.
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 order information |
data (object)
| Field | Type | Description |
|---|---|---|
| OrderNo | String | Refund order ID |