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

# Capture a pre-authorization

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

Executes the held funds for a pre-authorization and creates an order. The pre-auth must be in AUTHORIZED status.

## Path parameters

- `id` string, required

## Request body

- CapturePreAuthRequestDto
  - `useCashback` boolean — Whether to apply available cashback balance at capture. Defaults to true.
  - `merchantMetadata` object — Opaque JSON blob stored verbatim and returned on read endpoints. Max 5 keys; each string value must not exceed 200 characters.
  - `callbackUrl` string — HTTPS URL to receive order status webhook notifications. When provided, ShopBack will POST the order outcome to this URL upon capture.

## Response `201`

- CapturePreAuthResponseDto
  - `uuid` string, required — Pre-authorization UUID.
  - `orderUuid` string, required — UUID of the settled order created by this capture.
  - `status` string, required — Order status after capture.
  - `orderType` string, required — Order type.
  - `merchantRef` string, required — Merchant's reference ID supplied at pre-auth creation.
  - `merchantOrderId` string, required — Merchant's order ID.
  - `consumerEmail` string, required — Consumer's email address.
  - `createdAt` string, required — ISO 8601 creation timestamp.
  - `failureReason` string, nullable, required — null on a successful capture; error code when the payment is declined.

## Other responses

- `401` — Missing or invalid merchant JWT.
- `404` — Pre-authorization not found or belongs to a different merchant.
- `409` — The pre-authorization has already been captured, voided, declined, or has 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)