---
title: "Refund a transaction"
method: POST
path: "/v1/clients/{clientId}/transactions/{transactionId}/refund"
---

# Refund a transaction

`POST /v1/clients/{clientId}/transactions/{transactionId}/refund`

Creates a refund for a transaction. Partial refunds are not allowed. The `amount` must equal the original transaction amount received.

## Path parameters

- `clientId` string, uuid, required
- `transactionId` string, uuid, required

## Request body

- RefundRequest
  - `amount` string — Refund amount (full refund only) — must be exactly equal to the original transaction amount received. Use two decimal places.
  - `description` string — Text with the refund reason

## Response `200`

Refund successfully created

- RefundResponse
  - `id` string, uuid
  - `bankId` string, uuid
  - `clientId` string, uuid
  - `externalReference` string
  - `trackingId` string
  - `description` string
  - `amount` string, decimal
  - `currency` string
  - `category` string
  - `subCategory` string
  - `transactionStatus` string
  - `audit` object
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `deletedAt` string, date-time, nullable
    - `blockedAt` string, date-time, nullable

---

[API](https://skmtc.dev/monato/apis/fincore-api.md) · [All operations](https://skmtc.dev/monato/apis/fincore-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monato/fincore-api/revisions/a8263ed74545/schema)