跳转至

创建退款订单

尚未发布:当前仅可在测试环境提前联调,生产环境暂不可用。

请求

POST https://api.mycactus.dev/custody/v1/api/projects/{b_id}/refund-order/create

仅当流水处于 frozen_refund_waiting_address 时调用。相同请求内容具备幂等性,不会重复创建退款订单。

参数

路径参数

字段类型描述
b_id
必填
String业务线 ID

请求体参数

字段类型描述
wallet_detail_id
必填
Long入账流水 ID
order_no
必填
StringAPI订单号,最长 50 个字符
same_way
可选
Boolean是否原路退回,默认 false;为 true 时目标地址必须是原始打款地址
dest_address
必填
String退款收款地址,不得为 Cactus 内部地址
desc
可选
String订单描述
memo_type
可选
String部分链使用的 memo 类型
memo
可选
Stringmemo 内容

请求示例

{
  "wallet_detail_id": 1000123456,
  "order_no": "RF202609220001",
  "same_way": true,
  "dest_address": "0xabc...",
  "desc": "KYT refund"
}

ETH/TRON 冷合约代币钱包暂不支持创建退款订单。是否需要人工审核退款地址取决于该笔入账的处理状态;调用成功不表示退款已到账。

响应

响应体

字段类型描述
codeInteger响应码,0 表示成功
messageString响应消息
successfulBoolean请求是否成功
dataObject退款订单信息

data(对象)

字段类型描述
OrderNoString退款订单号

响应示例

{
  "code": 0,
  "message": "Success",
  "successful": true,
  "data": {
    "OrderNo": "PO202607310001"
  }
}