---
title: "Release an authorization"
method: DELETE
path: "/purchases/{id}"
---

# Release an authorization

`DELETE /purchases/{id}`

## Request

- Base URL: `https://gateway.pmnts-sandbox.io/v1.0`
- URL: `https://gateway.pmnts-sandbox.io/v1.0/purchases/{id}`
- Auth: HTTP basic

Void an authorization partially or completely

## Path parameters

- `id` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `amount` integer: The new amount for the authorisation (where the amount is being increased from the original authorized value). If this field is not provided, the `original amount` will be used.
  - `metadata` string
  - `extend` boolean: Indicates if an authorization extension should be processed

## Response `200`

200

- union
  - object
    - `successful` boolean
    - `response` object
      - `authorization` string
      - `id` string
      - `card_number` string
      - `card_holder` string
      - `card_expiry` string
      - `card_token` string
      - `card_type` string
      - `card_category` string
      - `card_subcategory` string
      - `amount` integer
      - `decimal_amount` integer
      - `successful` boolean
      - `message` string
      - `reference` string
      - `currency` string
      - `transaction_id` string
      - `settlement_date` string
      - `transaction_date` string
      - `response_code` string
      - `captured` boolean
      - `captured_amount` integer
      - `rrn` string
      - `cvv_match` string
      - `metadata` object
      - `addendum_data` object
    - `errors` unknown[]
      - unknown
  - object
    - `successful` boolean
    - `response` object
      - `authorization` string
      - `id` string
      - `card_number` string
      - `card_holder` string
      - `card_expiry` string
      - `card_token` string
      - `card_type` string
      - `card_category` string
      - `card_subcategory` string
      - `amount` integer
      - `decimal_amount` integer
      - `successful` boolean
      - `message` string
      - `reference` string
      - `currency` string
      - `transaction_id` string
      - `settlement_date` unknown
      - `transaction_date` string
      - `response_code` string
      - `captured` boolean
      - `captured_amount` integer
      - `rrn` string
      - `cvv_match` string
      - `metadata` object
      - `addendum_data` object
    - `errors` string[]

## Changes

- **2026-11-03** `a62ddbae3800`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fatzebra/apis/gateway/changes/purchases/:id/delete.md)

---

[API](https://skmtc.dev/fatzebra/apis/gateway.md) - [All operations](https://skmtc.dev/fatzebra/apis/gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fatzebra/apis/gateway/revisions/a62ddbae3800?raw)