跳转至

查询退款资料

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

请求

GET https://api.mycactus.dev/custody/v1/api/projects/{b_id}/refund-information/{wallet_detail_id}

本接口按入账流水 ID 返回退款资料历史记录。每次查询还会同步文件状态,并刷新即将过期的上传或下载 URL。

参数

路径参数

字段类型描述
b_id
必填
String业务线 ID
wallet_detail_id
必填
Long入账流水 ID

响应

响应体

字段类型描述
codeInteger响应码,0 表示成功
messageString响应消息
successfulBoolean请求是否成功
dataArray<RefundInformation>退款资料记录数组;没有提交记录时为空数组

RefundInformation(对象)

字段类型描述
wallet_detail_idLong入账流水 ID
source_of_fundsString资金来源说明
purpose_of_transferString转账用途说明
refund_addressString退款地址
transaction_hashString原始入账交易哈希
amountDecimal金额
coin_nameString币种名称
third_party_detailsString第三方相关信息
proof_filesArray<ProofFile>凭证文件及预签名地址
emailString提交人邮箱
statusStringUNDER_REVIEW、WAITING_FILE_UPLOADED、APPROVED 或 REJECTED_AWAITING_RESUBMISSION
rejected_reasonString审核拒绝原因
create_timeString提交时间

ProofFile(对象)

字段类型描述
file_idString文件唯一标识
statusStringPENDING_UPLOAD、PENDING_SCAN、APPROVED、REJECTED 或 INVALID
upload_urlString预签名上传地址
upload_url_expires_atLong上传地址过期时刻,epoch 毫秒
download_urlString预签名下载地址;不可下载时为 null
download_url_expires_atLong下载地址过期时刻,epoch 毫秒;不可下载时为 null

REJECTED 或 INVALID 文件会获得新的上传地址。请以 status 判断文件阶段,并使用最近一次响应中的 URL。

响应示例

{
  "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"
    }
  ]
}