Skip to content

Get Refund Information

Unreleased: This endpoint is available only in the test environment for early integration. Production is not yet available.

Request

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

This endpoint returns refund-information history for a deposit transaction detail ID. Each query also synchronizes file status and refreshes upload or download URLs that are about to expire.

Parameters

Path Parameters

FieldTypeDescription
b_id
Required
StringBusiness line ID
wallet_detail_id
Required
LongDeposit transaction detail ID

Response

Response Body

FieldTypeDescription
codeIntegerResponse code; 0 indicates success
messageStringResponse message
successfulBooleanWhether the request was successful
dataArray<RefundInformation>Refund-information records; an empty array is returned when no record exists

RefundInformation (object)

FieldTypeDescription
wallet_detail_idLongDeposit transaction detail ID
source_of_fundsStringSource of funds
purpose_of_transferStringPurpose of transfer
refund_addressStringRefund address
transaction_hashStringOriginal deposit transaction hash
amountDecimalAmount
coin_nameStringAsset name
third_party_detailsStringThird-party information
proof_filesArray<ProofFile>Proof files and presigned URLs
emailStringSubmitter email
statusStringUNDER_REVIEW, WAITING_FILE_UPLOADED, APPROVED, or REJECTED_AWAITING_RESUBMISSION
rejected_reasonStringReason for rejection
create_timeStringSubmission time

ProofFile (object)

FieldTypeDescription
file_idStringUnique file ID
statusStringPENDING_UPLOAD, PENDING_SCAN, APPROVED, REJECTED, or INVALID
upload_urlStringPresigned upload URL
upload_url_expires_atLongUpload URL expiration time in epoch milliseconds
download_urlStringPresigned download URL, or null when unavailable
download_url_expires_atLongDownload URL expiration time in epoch milliseconds, or null

Files in REJECTED or INVALID state receive a new upload URL. Use status to determine the file stage and always use URLs from the latest response.

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