---
title: "Capturar Preauthorization"
method: POST
path: "/{country_code}/preauth/capture"
tags: ["Transactions"]
---

# Capturar Preauthorization

`POST /{country_code}/preauth/capture`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/{country_code}/preauth/capture`
- Auth: API key in header `x-api-key`

Captura una autorización diferida y cierra el cobro.

Se usa para confirmar el cobro del monto retenido: el cuerpo indica la Transaction con la autorización (`transaction_reference`) y, opcionalmente, un `amount` que no supere el autorizado para capturar solo una parte. Las rutas `/cl`, `/mx` y `/br` son equivalentes: el país con que se contacta al medio de pago lo determina la Organization autenticada, no el prefijo de la ruta.

La captura se pide al medio de pago. Cuando este la acepta, la respuesta es `201` con la Transaction ya finalizada y su detalle completo; cuando la rechaza, la respuesta es `200` con `success` en `false` y el mensaje del medio de pago en `detail`.

Responde `404` cuando la Transaction no existe, y `400` cuando la Transaction no está en estado `CAPTURE_PENDING` o el monto pedido supera el autorizado.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Path parameters

- `country_code` 'cl' | 'mx' | 'br', required

## Headers

- `x-api-version` string, date: Versión del API para esta petición, como cualquier fecha `YYYY-MM-DD`. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.
- `x-account-key` string

## Request body

- CapturePreauthRequest: Captura de una autorización diferida.
  - `amount` number: Monto a capturar, mayor que cero y no superior al autorizado. Si se omite, la captura se pide sin monto parcial.
  - `idempotency_key` string: Llave con que se deduplican los reintentos de la captura; si se omite, se genera una.
  - `transaction_reference` string, required: Identificador público de la Transaction que tiene la autorización a capturar.

## Response `200`

El medio de pago rechazó la captura; el mensaje del rechazo viene en `detail`.

- AcknowledgeResponse: Confirmación sin datos adicionales de que la operación se ejecutó.
  - `detail` string: Mensaje complementario de la operación; `null` cuando no hay mensaje.
  - `success` boolean, required: Indica si la operación se completó.

## Other responses

- `201`: Transaction ya finalizada tras capturar la autorización.
- `400`: La Transaction no está en estado `CAPTURE_PENDING`, o el monto a capturar supera el autorizado.
- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: La Transaction no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/:country_code/preauth/capture/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)