---
title: "Void an Authorize"
method: POST
path: "/{authorize_id}/void"
---

# Void an Authorize

`POST /{authorize_id}/void`

## Request

- Base URL: `https://api.tap.company/v2/authorize`
- URL: `https://api.tap.company/v2/authorize/{authorize_id}/void`
- Auth: API key in header `Authorization`

This endpoint voids any existing authorizations under the given authorize_id

## Path parameters

- `authorize_id` string, required

## Response `200`

200

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `api_version` string
  - `method` string
  - `status` string
  - `amount` integer
  - `currency` string
  - `threeDSecure` boolean
  - `save_card` boolean
  - `merchant_id` string
  - `product` string
  - `statement_descriptor` string
  - `transaction` object
    - `authorization_id` string
    - `timezone` string
    - `created` string
    - `expiry` object
      - `period` integer
      - `type` string
    - `asynchronous` boolean
    - `amount` integer
    - `currency` string
  - `reference` object
    - `track` string
    - `payment` string
    - `gateway` string
    - `acquirer` string
    - `transaction` string
    - `order` string
  - `response` object
    - `code` string
    - `message` string
  - `acquirer` object
    - `response` object
      - `code` string
      - `message` string
  - `card` object
    - `object` string
    - `first_six` string
    - `last_four` string
  - `receipt` object
    - `id` string
    - `email` boolean
    - `sms` boolean
  - `customer` object
    - `id` string
    - `first_name` string
    - `last_name` string
    - `email` string
    - `phone` object
      - `country_code` string
      - `number` string
  - `source` object
    - `object` string
    - `type` string
    - `payment_type` string
    - `payment_method` string
    - `channel` string
    - `id` string
  - `redirect` object
    - `status` string
    - `url` string
  - `post` object
    - `status` string
    - `url` string
  - `auto` object
    - `status` string
    - `type` string
    - `time` integer
  - `void` object
    - `authorize_id` string
    - `id` string
    - `amount` integer
    - `created` string
    - `by` string
  - `description` string
  - `metadata` object
    - `udf1` string
    - `udf2` string
    - `udf3` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `205297cbfd7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tap/apis/authorize/changes/:authorize_id/void/post.md)

---

[API](https://skmtc.dev/tap/apis/authorize.md) - [All operations](https://skmtc.dev/tap/apis/authorize/llms.txt) - [OpenAPI document](https://skmtc.dev/tap/apis/authorize/revisions/205297cbfd7e?raw)