---
title: "Capture an authorization"
method: POST
path: "/purchases/{id}/capture"
---

# Capture an authorization

`POST /purchases/{id}/capture`

Please note, If the outer successful field is false, it means the capture was rejected at the gateway level and the errors array needs to be looked at to confirm why it failed.

## Path parameters

- `id` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `amount` integer, required — Amount of the purchase in the smallest unit of for the currency.
  - `metadata` object
  - `addendum_data` object

## 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[]

## Other responses

- `422` — 422

---

[API](https://skmtc.net/fatzebra/apis/gateway.md) · [All operations](https://skmtc.net/fatzebra/apis/gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fatzebra/gateway/versions/6317ad424277/schema)