---
title: "Renovar Preauthorizations por vencer"
method: POST
path: "/{country_code}/cards/preauths/renew"
tags: ["Preauthorizations"]
---

# Renovar Preauthorizations por vencer

`POST /{country_code}/cards/preauths/renew`

## Request

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

Renueva las autorizaciones pendientes de captura que están por vencer.

Es una operación interna que ejecuta Toku de forma programada, no un endpoint de integración.

Cada autorización se renueva según la política configurada para su Account: sin política configurada, o fuera de la ventana máxima de renovación, la autorización se omite. Devuelve el total de candidatas y cuántas quedaron renovadas, capturadas, omitidas y fallidas.

## Path parameters

- `country_code` 'cl' | 'mx' | 'br', required: Códigos de país admitidos en el prefijo de ruta `/{country_code}`.

## Response `200`

Resumen de la corrida: cuántas autorizaciones se evaluaron y en qué terminó cada intento.

- RenewPreauthsResponse: Resumen de una corrida de renovación automática sobre las autorizaciones por vencer.
  - `candidates_for_renewal` integer, required: Autorizaciones por vencer que se evaluaron en esta corrida.
  - `captured_preauths` integer, required: Autorizaciones que se cobraron porque la renovación no se pudo completar y su política indica capturar en ese caso.
  - `failed_preauths` integer, required: Autorizaciones cuya renovación no se completó: terminó en error, o el emisor la rechazó de forma definitiva y su política las deja vencer.
  - `renewed_preauths` integer, required: Autorizaciones que se renovaron con una nueva autorización.
  - `skipped_preauths` integer, required: Autorizaciones que no se procesaron: sin política de renovación, fuera de la ventana máxima, o con otra operación en curso.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado 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/cards/preauths/renew/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)