---
title: "Void Transaction"
method: POST
path: "/card/auth_capture/void"
tags: ["Auth-Capture-Void"]
---

# Void Transaction

`POST /card/auth_capture/void`

This endpoint voids a previously authorized transaction. This request can only be done on transactions that are fully authorized and have not been captured 

> **Notes:**
>
> 1. **Partially captured authorizations cannot be voided**: If any amount has been captured, void is not allowed. The response will indicate the remaining capturable amount..
> 2. **Fully captured authorizations cannot be voided::** Once a transaction is fully captured (status becomes CAPTURED), it cannot be voided. You must use the refund API instead.
> 3. **Authentication:** Valid Authorization header required (same format as authorize endpoint). 
> 4. **Only fully authorized (uncaptured) transactions can be voided:** Void is only allowed for authorizations that have never been captured.

## Request body

- VoidTransactionRequest
  - `authorization_reference` string, required — The reference of the authorization to be voided.
  - `void_reference` string, required — A unique reference for this void transaction generated by the merchant.
  - `void_reason` string, nullable — Reason for voiding the transaction.

## Response `200`

Void Transaction

- VoidTransactionResponse
  - `status` string — Status of the void operation (e.g., VOIDED, ERROR).
  - `message` string — Descriptive message about the operation status.
  - `void_reference` string, nullable — Unique reference for the void transaction (present on success).
  - `voided_amount` number, nullable — The amount successfully voided.
  - `remaining_amount` number, nullable — Any remaining amount on the authorization (usually 0 after a full void).

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/versions/1ecd4b94ff07/schema)