---
title: "capturePreauthTransaction"
method: POST
path: "/v2/capturePreauthTransaction"
tags: ["Create & Manage Transactions"]
---

# capturePreauthTransaction

`POST /v2/capturePreauthTransaction`

Execute the preauthorized transaction which is specified by provided 'id'.

The AeroPay transaction is returned.

<details>
<summary><strong>Error Glossary</strong> (click to expand)</summary>

| Code | HTTP Status | Message |
|------|-------------|-------------|
| `AP009` | 401 | Unauthorized |
| `AP101` | 401 | No authenticated user |
| `AP300` | 200 | Unable to connect to bank |
| `AP310` | 200 | Credit transaction declined |
| `AP312` | 200 | Preauth already captured |
| `AP313` | 200 | Preauth ineligible for capture |
| `AP400` | 200 | No bank account linked |
| `AP401` | 400 | Cannot validate bank account |
| `AP412` | 200 | Bank account already removed |
| `AP700` | 400 | Missing or invalid required parameter |
| `AP701` | 400 | Improperly formatted parameter |
| `AP1000` | 200 | Invalid API |

</details>

## Headers

- `Content-Type` string, required
- `authorization` string, required

## Request body

- object
  - `id` string, required — preauthtransactionId of transaction to capture. In UUID format.

## Response `200`

Success or Business Logic Error

- union
  - CapturePreauthTransactionResponse
    - `transaction` object
      - `id` string
      - `amount` object
        - `currency` string
        - `amount` integer
      - `status` string
      - `userId` string
      - `description` string
      - `attributes` object
      - `createdDate` string, date-time
      - `expiryDate` string, date-time
      - `userName` string
      - `userEmail` string, email
      - `merchantId` integer
      - `userAccountId` integer
      - `locationId` integer
  - 200failure
    - `error` object
      - `code` string
      - `message` string
      - `help` string — Support contact information

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/aero/apis/aeropay-v2-api.md) · [All operations](https://skmtc.net/aero/apis/aeropay-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aero/aeropay-v2-api/revisions/4700c4ceeaad/schema)