---
title: "Process a reversal"
method: POST
path: "/transactions/{transaction_id}/reversal"
tags: ["Transactions"]
---

# Process a reversal

`POST /transactions/{transaction_id}/reversal`

Automatically determines whether a payment should be voided or refunded based on settlement status and acquiring bank rules. Supports both full and partial reversals.

## Path parameters

- `transaction_id` string, uuid, required

## Request body

- object
  - `amount` number, float — The amount to reverse. If omitted, a full reversal is assumed.
  - `reference` string — Unique reference for the reversal **(Optional).**
  - `webhook_url` string, uri — Webhook URL for receiving async status updates **(Optional)**.

## Response `200`

Reversal successfully processed

- object
  - `transaction_id` string, uuid — Unique identifier assigned by Acquired.com for the transaction.
  - `status` 'success' | 'declined' | 'blocked' | 'pending'
  - `links` object[]
    - `rel` 'self'
    - `href` string — Link to the resource which should be appended to base URL.

## Other responses

- `400` — An error occurred
- `401` — An error occurred
- `500` — Internal Server error

---

[API](https://skmtc.net/acquired/apis/acquired-api.md) · [All operations](https://skmtc.net/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acquired/acquired-api/versions/7ae178a046f2/schema)