跳转至

提交退款资料

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

请求

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

仅在收到 FROZEN_PENDING_DOCUMENT 通知时调用。若已有一条审核中的资料记录,不允许重复提交。

参数

路径参数

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

请求体参数

字段类型描述
wallet_detail_id
必填
Long入账流水 ID
source_of_funds
必填
String资金来源说明
purpose_of_transfer
必填
String转账用途说明
refund_address
必填
String期望的退款到账地址
transaction_hash
必填
String原始入账交易哈希
amount
必填
Decimal金额
coin_name
必填
String币种名称
third_party_details
可选
String第三方相关信息
proof_file_count
可选
Integer凭证文件数量,最大为 10;省略或传 0 表示无文件

请求示例

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

声明凭证文件后,请直接向响应中的 upload_url 执行 PUT 上传,并始终使用最近一次查询返回的 URL。

响应

响应体

字段类型描述
codeInteger响应码,0 表示成功
messageString响应消息
successfulBoolean请求是否成功
dataObject退款资料详情

data(对象)

字段类型描述
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

响应示例

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