TRtrytoku
Transactions

Capturar Preauthorization

Changed on

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.

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

Path parameters

country_code'cl' | 'mx' | 'br' required

País de la organización sobre la que se opera, como primer segmento de la ruta: cl (Chile), mx (México) o br (Brasil).

Headers

x-api-versionstring 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.

Example:2026-10-08
x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

amountnumber

Monto a capturar, mayor que cero y no superior al autorizado. Si se omite, la captura se pide sin monto parcial.

idempotency_keystring

Llave con que se deduplican los reintentos de la captura; si se omite, se genera una.

transaction_referencestring required

Identificador público de la Transaction que tiene la autorización a capturar.

Example request

{
  "amount": 15990,
  "transaction_reference": "trs_kR3nQ8sT1vX7yZ2aB5cD9eF4gH6jK0mN"
}

Response

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

detailstring

Mensaje complementario de la operación; null cuando no hay mensaje.

successboolean required

Indica si la operación se completó.

Example response

{
  "success": true
}

Changes