---
title: "Create a blockchain refund"
method: POST
path: "/open-api/v3/cryptoconnect/refunds"
tags: ["Blockchain Refund"]
---

# Create a blockchain refund

`POST /open-api/v3/cryptoconnect/refunds`

When the blockchain transfer status is "ONHOLD", you should use this endpoint to submit a refund request.
<br />
Note: This endpoint performs a KYA (Know Your Address) check on the submitted address.

## Headers

- `Idempotency-Key` string

## Request body

- CreationBlockchainRefundRequest
  - `referenceId` string, uuid, required
  - `accountId` string, uuid, required
  - `transferId` string, uuid, required
  - `address` string, required — An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address.

## Response `200`

The request has succeeded.

- object
  - `code` string, required — Code
  - `message` string, required — Message
  - `data` BlockchainRefund, required
    - `id` string, required — Unique ID generated for the entity.
    - `accountId` string, uuid, required
    - `referenceId` string, uuid, required
    - `transferId` string, uuid, required
    - `destination` BlockchainLocation, required — Blockchain wallet address
      - `type` 'BLOCKCHAIN', required
      - `chain` 'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'BTC' | 'ETH' | 'MATIC' | 'OP' | 'SOL' | 'TON' | 'TRX', required
      - `address` string, required — An alphanumeric string which indicates the wallet address used to receive the transfer. Will only be set when the transfer source is a blockchain address.
    - `amount` Money, required
      - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'WUSD', required
      - `amount` string, number, required — The transaction amount.
    - `fees` RefundFee[], required — An array of fees applied to a transaction.
      - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'WUSD', required
      - `amount` string, number, required — The transaction amount.
      - `type` 'GAS', required
    - `status` 'PENDING' | 'COMPLETE' | 'FAILED', required
    - `transactionHash` string — A hash that uniquely identifies an on-chain transaction.
    - `createTime` string, timestamp, required — Timestamp.
    - `completeTime` string, timestamp, required — Timestamp.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `403` — Access is forbidden.
- `409` — The request conflicts with the current state of the server.

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)