---
title: "Void a pre-authorization"
method: POST
path: "/tokenized-payment/v1/pre-auths/{id}/void"
tags: ["Pre-Auth"]
---

# Void a pre-authorization

`POST /tokenized-payment/v1/pre-auths/{id}/void`

Releases the held funds for a pre-authorization. The pre-auth must be in AUTHORIZED status. If the provider rejects the void, the pre-auth stays AUTHORIZED and the merchant may retry.

## Path parameters

- `id` string, required

## Request body

- VoidPreAuthRequest
  - `reason` string — Optional free-text reason for voiding. Stored verbatim on the pre-auth lifecycle.
  - `merchantMetadata` object — Opaque JSON blob stored verbatim on the pre-auth row, replacing any value set at creation. Max 5 keys; each string value must not exceed 200 characters.

## Response `200`

- PreAuthResponseDto
  - `id` string, required — Pre-authorization UUID.
  - `merchantRef` string, required — Merchant's reference ID supplied at creation.
  - `status` 'PENDING' | 'AUTHORIZED' | 'CAPTURE_INITIATED' | 'CAPTURED' | 'VOIDED' | 'DECLINED' | 'EXPIRED', required — Lifecycle state of the pre-authorization.
  - `amount` number, required — Hold amount in major currency units.
  - `currency` string, required — 3-letter ISO currency code.
  - `orderUuid` string, nullable, required — UUID of the settled order. Non-null after capture.
  - `orderStatus` string, nullable, required — Status of the settled order. Non-null after capture.
  - `failureReason` string, nullable, required — Failure reason if the pre-auth was declined or expired.
  - `merchantMetadata` object, nullable, required — Merchant-supplied metadata stored verbatim at creation.
  - `createdAt` string, required — ISO 8601 creation timestamp.
  - `updatedAt` string, required — ISO 8601 last-updated timestamp.

## Other responses

- `401` — Missing or invalid merchant JWT.
- `404` — Pre-authorization not found or belongs to a different merchant.
- `409` — The pre-authorization is in a state that cannot be voided (already captured, voided, declined, or expired).

---

[API](https://skmtc.net/shopback/apis/online-payments-api.md) · [All operations](https://skmtc.net/shopback/apis/online-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopback/online-payments-api/revisions/160fc287769e/schema)