@veriko-mx/sdk 0.4.11 → 0.4.13

package/dist/cjs/generated/openapi.d.ts

@@ -65,9 +65,11 @@ export interface paths {
          *     - Clave de rastreo / Referencia numérica.
          *     - Banco emisor.
          *     - Banco receptor.
-         *     - Cuenta beneficiaria.
+         *     - Cuenta beneficiaria, o una lista de cuentas candidatas.
+         *
+         *     La cuenta beneficiaria (`cuenta_beneficiaria`) es obligatoria en esta operación, salvo que se envíe `cuentas_candidatas`. Si faltan las dos, la petición se rechaza con `422 preflight_failed` y el error de campo `cuenta_required`: el servicio no la busca entre los beneficiarios guardados.
          *
-         *     La cuenta beneficiaria (`cuenta_beneficiaria`) es obligatoria en esta operación. Si falta, la petición se rechaza con `422 preflight_failed` y el error de campo `cuenta_required`: el servicio no la busca entre los beneficiarios guardados.
+         *     Cuando no se sabe a cuál de varias cuentas se hizo el pago, `cuentas_candidatas` sustituye a `cuenta_beneficiaria`: de 2 cuentas al máximo que admite el servicio (3 de forma predeterminada) en una sola validación y con una sola unidad de cuota. La consulta recorre las candidatas en el orden enviado y adopta la primera que coincide con la transferencia; esa cuenta vuelve completa en `normalized_data.cuenta_beneficiaria` y su posición en `candidate_match`. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code`. Las dos formas no pueden enviarse juntas (`422 cuenta_y_candidatas_excluyentes`) y una lista que no cumple se rechaza con `422 cuentas_candidatas_invalidas`, las dos antes de consumir cuota.
          *
          *     El veredicto final (estado terminal) de una validación puede ser alguno de estos:
          *
@@ -135,7 +137,17 @@ export interface paths {
          *
          *     {% callout type="info" %}
          *     El campo `cuenta_beneficiaria` permite enviar explícitamente la cuenta receptora de la transferencia, enviarlo es especialmente útil cuando la imagen no lleva este dato o lo lleva incompleto.\
-         *     Un beneficiario guardado (con `POST /v1/beneficiaries`) no sustituye a este campo: solo sirve para completar los dígitos de la cuenta que la imagen sí muestra. Si la imagen no trae dígitos suficientes, la validación se rechaza con `cuenta_unresolvable`, porque las cuentas guardadas no se prueban una por una.
+         *     Un beneficiario guardado (con `POST /v1/beneficiaries`) no sustituye a este campo: solo sirve para completar los dígitos de la cuenta que la imagen sí muestra. Si la imagen no trae dígitos suficientes, la validación se rechaza con `cuenta_unresolvable`, porque las cuentas guardadas no se prueban una por una.\
+         *     \
+         *     Cuando no se sabe cuál de varias cuentas recibió el pago, `cuentas_candidatas` las prueba en una sola validación (de 2 cuentas al máximo que admite el servicio, 3 de forma predeterminada; una sola unidad de cuota, también con `?async=1`) y sustituye a `cuenta_beneficiaria`: enviar las dos se rechaza con `422 cuenta_y_candidatas_excluyentes`, y una lista que no cumple, con `422 cuentas_candidatas_invalidas`, las dos antes de consumir cuota. La lista tiene prioridad sobre la cuenta que se lea en la imagen; la ganadora vuelve completa en `normalized_data.cuenta_beneficiaria` y su posición en `candidate_match`. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code`.
+         *
+         *     {% /callout %}
+         *
+         *     {% callout type="info" %}
+         *     **Retención del comprobante:**\
+         *     De forma predeterminada el archivo del comprobante se conserva y se sirve con `GET /v1/validations/{id}/image`. Con `retain_image=false`, se borra cuando la validación llega a un estado terminal del que ya no se necesita, y el veredicto y los datos extraídos se conservan. La validación publica `image_retained=false` y la imagen responde un estado HTTP `410` (con `image_not_retained` en el cuerpo).\
+         *     \
+         *     Un valor que no es booleano responde un estado HTTP `422` (con `invalid_retain_image` en el cuerpo), antes de consumir cuota. Para borrar después una validación y todo lo que dejó, está `POST /v1/validations/{id}/purge/prepare`, descrito en {% concept slug="data-retention" %}la retención de comprobantes y datos{% /concept %}.
          *
          *     {% /callout %}
          *
@@ -281,6 +293,12 @@ export interface paths {
          *     Si el `ETag` enviado en `If-None-Match` sigue vigente, responde con un estado HTTP `304` sin cuerpo, como describe {% concept slug="conditional-caching" %}la caché condicional{% /concept %}.
          *
          *     {% /callout %}
+         *
+         *     {% callout type="info" %}
+         *     **Validaciones purgadas:**\
+         *     Una validación purgada con `POST /v1/validations/{id}/purge/execute` responde con un estado HTTP `200` y queda como una lápida: conserva el veredicto, las fechas y el monto, y trae `purged_at`. Ya no tiene `request_data`, `ocr_result`, `banxico_result` ni archivos.
+         *
+         *     {% /callout %}
          */
         get: operations["getValidation"];
         put?: never;
@@ -290,6 +308,8 @@ export interface paths {
          * @description Retira una validación del historial de validaciones del usuario autenticado.
          *
          *     La eliminación es lógica, no física. Lo que quiere decir que puede seguir apareciendo en las listas como `GET /v1/validations` si se usa el filtro `with_deleted` u otros.
+         *
+         *     El registro, el CEP, los datos extraídos y el archivo del comprobante se conservan. Para borrarlos de forma definitiva está `POST /v1/validations/{id}/purge/prepare`, seguido de `POST /v1/validations/{id}/purge/execute`.
          */
         delete: operations["deleteValidation"];
         options?: never;
@@ -306,7 +326,7 @@ export interface paths {
         };
         /**
          * Descargar el CEP oficial
-         * @description Descarga el {% concept slug="cep-concept" %}Comprobante Electrónico de Pago (CEP){% /concept %} emitido por Banxico de una validación con veredicto `valid`.
+         * @description Descarga el {% concept slug="cep-concept" %}Comprobante Electrónico de Pago (CEP){% /concept %} emitido por Banxico de una validación con veredicto `valid`, o `returned` cuando el CEP se descargó antes de conocerse la devolución.
          *
          *     El formato predeterminado es `xml`; con `format=pdf` se solicita el documento en PDF.
          *
@@ -364,6 +384,8 @@ export interface paths {
          *       para que un navegador no lo abra dentro del propio origen.
          *
          *     Si la validación no tiene imagen disponible, responde con un estado HTTP `404` (con `image_not_available` en el cuerpo).
+         *
+         *     Si la validación se creó con `retain_image=false`, responde con un estado HTTP `410` (con `image_not_retained` en el cuerpo); si se purgó, con un estado HTTP `410` (con `validation_purged` en el cuerpo). Un `410` no se resuelve reintentando: el archivo no existe.
          */
         get: operations["getValidationImage"];
         put?: never;
@@ -416,13 +438,13 @@ export interface paths {
          *     **No se admite en tres casos:**\
          *     — Validaciones que llegaron por importación masiva.\
          *     — Validaciones ya resueltas.\
-         *     — Validaciones fuera de la antigüedad que permite el plan.
+         *     — Validaciones con más de siete días de antigüedad.
          *
          *     {% /callout %}
          *
          *     Un ciclo de reintentos puede devolver `terminal_state="exhausted"` cuando se alcanzan el máximo de reintentos configurado. También puede devolver `terminal_state="cancelled"` cuando el usuario cancela manualmente los reintentos de la validación.
          *
-         *     En ambos casos, el ciclo puede reactivarse mientras conserve reintentos disponibles.
+         *     En ambos casos, el ciclo puede reactivarse hasta tres veces; pasado ese tope, la petición se rechaza con `422 reactivation_cap_exceeded`.
          *
          *     El estado completo de una validación se obtiene con `GET /v1/validations/{id}`, y los límites están descritos en {% concept slug="retry-policy" %}la política de reintentos{% /concept %}.
          */
@@ -458,6 +480,146 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/validations/{id}/recheck": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Volver a consultar el estado de pago de una validación
+         * @description Vuelve a consultar a Banxico el estado del pago de una validación `valid` y, si lo reporta devuelto, la pasa a `returned`.
+         *
+         *     Un veredicto `valid` es la foto del momento de la consulta: el CEP acredita que la transferencia se liquidó, no que el dinero siguiera en la cuenta del beneficiario, y la institución receptora puede devolverlo horas o días después. Esta operación hace sólo esa consulta, con los datos que la validación ya guardó:
+         *
+         *     - No usa IA ni descarga otro CEP.
+         *     - **No consume cuota** ni cuenta como una validación nueva.
+         *     - Guarda la respuesta de Banxico en `banxico_result._payment_status`.
+         *     - Con el estado `devuelto` o `en_proceso_devolucion`, cambia `status` y `banxico_status` a `returned`, conserva el CEP y emite el webhook `validation.returned`.
+         *
+         *     Qué admite:
+         *
+         *     - `valid` creada hace 72 horas como máximo: se consulta. Pasado ese plazo responde con un estado HTTP `422` (con `recheck_window_expired` en el cuerpo).
+         *     - `returned`: responde su estado actual sin consultar a Banxico, con `meta.recheck.checked_at` en `null`.
+         *     - Cualquier otro estado: responde con un estado HTTP `422` (con `recheck_not_eligible` en el cuerpo).
+         *
+         *     Cada validación admite una consulta cada 10 minutos. Si se repite antes, responde con un estado HTTP `429` (con `recheck_rate_limited` en el cuerpo) y la cabecera `Retry-After` indica los segundos que faltan. Ese tope se suma a los de la clave de API.
+         *
+         *     La respuesta es la misma validación que devuelve `GET /v1/validations/{id}`, con el resultado de la revisión en `meta.recheck`:
+         *
+         *     - `checked_at`: Fecha y hora de la consulta a Banxico, en ISO 8601 UTC. `null` cuando no se consultó nada porque la validación ya estaba `returned`.
+         *     - `changed`: `true` cuando esta consulta pasó la validación de `valid` a `returned`.
+         *     - `previous_status`: Veredicto de Banxico antes de la consulta, `valid` o `returned`.
+         *
+         *     {% callout type="info" %}
+         *     **Si Banxico no responde:**\
+         *     Cuando Banxico no entrega un estado legible, responde con un estado HTTP `503` (con `recheck_unavailable` en el cuerpo) y la validación conserva su intervalo: se puede reintentar de inmediato. Un `503` no dice nada sobre la transferencia.
+         *
+         *     {% /callout %}
+         *
+         *     El significado de `valid` y de `returned` está en {% concept slug="cep-concept" %}el CEP y sus veredictos{% /concept %}, y la entrega del evento en {% concept slug="webhooks-architecture" %}la arquitectura de webhooks{% /concept %}.
+         */
+        post: operations["recheckValidation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/validations/{id}/purge/prepare": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Preparar el borrado definitivo de una validación
+         * @description Describe lo que borraría el borrado definitivo de una validación propia y emite el token con el que `POST /v1/validations/{id}/purge/execute` lo confirma. No cambia nada: la validación y sus archivos quedan como estaban.
+         *
+         *     `DELETE /v1/validations/{id}` solo retira la validación del historial; el registro, el CEP, los datos extraídos y el archivo del comprobante siguen existiendo. El borrado definitivo, en dos pasos, los elimina.
+         *
+         *     La respuesta incluye:
+         *
+         *     - `confirmation_token`: Token de un solo uso, atado a la cuenta y a esta validación, que caduca en `expires_in` segundos.
+         *     - `will_delete`: Lo que se borrará: el archivo, el CEP, los campos con contenido y la cantidad de registros derivados.
+         *     - `will_keep`: Los campos que conserva la lápida en que queda la validación.
+         *     - `cancels_pending_retries`: `true` cuando hay un ciclo de reintentos abierto, que el borrado cancela.
+         *     - `same_image_validation_ids`: Otras validaciones de la cuenta con el mismo comprobante, que no se tocan.
+         *     - `irreversible`: `true` siempre.
+         *
+         *     Solo se admite una validación propia en un estado terminal. Una validación en curso responde un estado HTTP `409` (con `purge_validation_in_progress` en el cuerpo), y una ya purgada, un estado HTTP `410` (con `validation_purged` en el cuerpo).
+         *
+         *     {% callout type="warning" %}
+         *     **El borrado es irreversible:**\
+         *     Lo borrado no se recupera, ni siquiera desde la plataforma. La validación queda como una lápida y **no devuelve cuota**.\
+         *     Los respaldos de infraestructura no se alteran: conservan una copia hasta que el ciclo de respaldos la retira.
+         *
+         *     {% /callout %}
+         *
+         *     La lápida, lo que se borra y las limitaciones están en {% concept slug="data-retention" %}la retención de comprobantes y datos{% /concept %}.
+         */
+        post: operations["prepareValidationPurge"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/validations/{id}/purge/execute": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ejecutar el borrado definitivo de una validación
+         * @description Borra de forma definitiva el contenido de una validación propia, con el token que emitió `POST /v1/validations/{id}/purge/prepare`. Es el segundo paso de un flujo de dos pasos: sin ese token no se borra nada.
+         *
+         *     Se borra:
+         *
+         *     - El archivo del comprobante, imagen o PDF.
+         *     - El CEP, en XML y en PDF.
+         *     - `request_data`, `ocr_result`, `banxico_result` y las advertencias de normalización. De `normalized_data` solo se conserva el monto.
+         *     - Los registros derivados con datos personales: intentos de reintento, sondeos de cuenta, respuestas guardadas de `Idempotency-Key` y notificaciones de la bandeja.
+         *     - El cuerpo enviado y la respuesta del receptor en las entregas de webhook de esa validación, y el contenido de sus notificaciones. El registro de cada entrega se conserva.
+         *     - Los cuerpos de las filas de auditoría que nombran la validación, y el contexto libre de sus eventos de seguridad.
+         *
+         *     La validación queda como una lápida: conserva `id`, `validation_type`, `status`, `banxico_status`, las fechas, `processing_time_ms`, `error_code`, el monto y `purged_at`. Con eso la cuota, las estadísticas, finanzas y el historial siguen cuadrando. **El borrado no devuelve cuota.**
+         *
+         *     Después del borrado, `GET /v1/validations/{id}` responde la lápida con un estado HTTP `200` y `purged_at`. La imagen, el CEP, los reintentos y la revisión posterior responden un estado HTTP `410` (con `validation_purged` en el cuerpo), y los webhooks, los reintentos y los barridos la ignoran. Un ciclo de reintentos abierto se cancela.
+         *
+         *     El token se verifica antes de borrar:
+         *
+         *     - Falta, está mal formado, su firma no es válida o venció: responde un estado HTTP `422` con su código (`confirmation_token_missing`, `confirmation_token_malformed`, `confirmation_token_signature_invalid` o `confirmation_token_expired`).
+         *     - Es de otra validación, de otra cuenta o de otra operación: responde un estado HTTP `422` (con `purge_token_mismatch` o `confirmation_token_operation_mismatch` en el cuerpo).
+         *     - Ya se usó: responde un estado HTTP `409` (con `confirmation_token_already_used` en el cuerpo).
+         *
+         *     Si la respuesta no llega, `GET /v1/validations/{id}` dice si el borrado se completó: una validación purgada trae `purged_at`. Repetir este paso sobre una validación purgada responde un estado HTTP `410`.
+         *
+         *     {% callout type="warning" %}
+         *     **El borrado es irreversible:**\
+         *     Lo borrado no se recupera, ni siquiera desde la plataforma. Los respaldos de infraestructura no se alteran y el catálogo global de cuentas, que no guarda vínculo con la validación, no se toca.
+         *
+         *     {% /callout %}
+         *
+         *     Lo que se borra, la lápida y las limitaciones están en {% concept slug="data-retention" %}la retención de comprobantes y datos{% /concept %}.
+         */
+        post: operations["executeValidationPurge"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/public/banks": {
         parameters: {
             query?: never;
@@ -506,6 +668,41 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/public/spei-calendar/{year}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Obtener el calendario de días inhábiles SPEI de un año
+         * @description Devuelve el calendario de días inhábiles SPEI de un año, con la disposición oficial de la que sale.
+         *
+         *     La respuesta incluye:
+         *
+         *     - `non_business_days`: Los días inhábiles que caen de lunes a viernes, en orden y con formato `YYYY-MM-DD`.
+         *     - `source`: La disposición de la **Comisión Nacional Bancaria y de Valores (CNBV)** publicada en el **Diario Oficial de la Federación (DOF)**, con su título y su fecha de publicación.
+         *
+         *     Los sábados y los domingos también son inhábiles, siempre, y no se repiten en `non_business_days`.
+         *
+         *     El calendario determina el día de operación de una transferencia. El SPEI opera todos los días, pero el día hábil cambia a las 18:00 (hora del centro de México): lo enviado a partir de esa hora, en sábado, en domingo o en un día inhábil opera el siguiente día hábil. Ese día es el `operationDate` de `banxico_result`, y puede diferir de la fecha de envío.
+         *
+         *     La consulta no consume cuota de validaciones. Un año sin calendario responde un estado HTTP `404` (con `spei_calendar_year_not_covered` en el cuerpo), y `meta.covered_years` lista los años disponibles. El calendario de cada año se añade cuando la CNBV publica su disposición, normalmente en diciembre del año anterior.
+         *
+         *     La respuesta es cacheable: incluye la cabecera `ETag`, que puede enviarse en otra petición como `If-None-Match`; si el calendario no ha cambiado, responde con un estado HTTP `304` (sin cuerpo).
+         *
+         *     La diferencia entre la fecha de envío y la de operación está en {% concept slug="timezone-handling" %}fechas y zona horaria{% /concept %}.
+         */
+        get: operations["getSpeiCalendar"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/beneficiaries/export": {
         parameters: {
             query?: never;
@@ -515,7 +712,7 @@ export interface paths {
         };
         /**
          * Exportar los beneficiarios de la cuenta de usuario
-         * @description Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro `with_archived` que `GET /v1/beneficiaries/list-beneficiaries`.
+         * @description Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro `with_archived` que `GET /v1/beneficiaries`.
          *
          *     El formato de descarga se elige con `?format` (`csv` por defecto, `xlsx` como alternativa). El tope de filas es de 100 000, y `?limit` sirve para pedir menos, nunca más.
          *
@@ -557,11 +754,11 @@ export interface paths {
          *     - Tarjeta (16 dígitos): `bank_code` es opcional, se deriva del BIN.
          *     - Celular/DiMo (10 dígitos): `bank_code` es **obligatorio** en el cuerpo, ya que el número por sí solo no identifica a la institución bancaria.
          *
-         *     Si la cuenta a registrar no existe previamente, se registra y responde con un estado HTTP `200`.
+         *     Si la cuenta a registrar no existe previamente, se registra y responde con un estado HTTP `201`.
          *
          *     Si se intenta registrar una cuenta activa, responde con un estado HTTP `422` (con `beneficiary_already_registered` en el cuerpo).
          *
-         *     Si existe pero está archivada, el alta la **reactiva** y responde con un estado HTTP `200` (con `meta.reactivated=true` en el cuerpo).
+         *     Si existe pero está archivada, el alta la **reactiva** y responde con un estado HTTP `200` (con `meta.reactivated=true` en el cuerpo). Si la petición no trae `label`, la reactivación conserva el alias que la cuenta ya tenía; si lo trae, lo reemplaza.
          */
         post: operations["createBeneficiary"];
         delete?: never;
@@ -583,10 +780,12 @@ export interface paths {
          * @description Actualiza un beneficiario ya registrado. El cuerpo admite la envoltura JSON:API o un objeto plano, y lo que se envíe determina el alcance del cambio:
          *
          *     - Solo `label`: Se guarda, sin tocar la cuenta.
-         *     - Un `account_number` nuevo, o el alias antiguo: vuelven a derivarse `account_type`, `bank_code` y `bank_name`. Si el nuevo número es un celular (phone), el cuerpo debe llevar `bank_code`.
-         *     - Solo `bank_code`: se aplica únicamente sobre un beneficiario de tipo celular. En una CLABE o una tarjeta el banco se deriva del número, así que el valor enviado se descarta sin error.
+         *     - Un `account_number` nuevo: vuelven a derivarse `account_type`, `bank_code` y `bank_name`. Si el nuevo número es un celular (phone), el cuerpo debe llevar `bank_code`.
+         *     - Solo `bank_code`: se aplica únicamente sobre un beneficiario de tipo celular. En una CLABE o una tarjeta el banco se deriva del número, así que el valor enviado se descarta sin error; si era el único campo, responde con `no_valid_fields`.
          *
          *     Un cuerpo sin ningún campo editable responde con un estado HTTP `422` (con `no_valid_fields` en el cuerpo).
+         *
+         *     Si el `account_number` nuevo ya está registrado para la misma cuenta de usuario, activo o archivado, responde con un estado HTTP `422` (con `beneficiary_already_registered` en el cuerpo) y el beneficiario no cambia.
          */
         put: operations["updateBeneficiary"];
         post?: never;
@@ -635,9 +834,9 @@ export interface paths {
         };
         /**
          * Descargar la plantilla de importación de beneficiarios
-         * @description Devuelve un **archivo plantilla para la importación de beneficiarios** en el formato solicitado, con encabezados en español o inglés y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para {% concept slug="bulk-imports" %}la importación masiva{% /concept %}.
+         * @description Devuelve un **archivo plantilla para la importación de beneficiarios** en el formato solicitado, con los encabezados fijos `alias`, `cuenta` y `banco` y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para {% concept slug="bulk-imports" %}la importación masiva{% /concept %}.
          *
-         *     El idioma de los encabezados se negocia con la cabecera `Accept-Language`; de forma predeterminada se entregan en español, acepta después encabezados en ambos idiomas de forma insensible a acentos.
+         *     Los encabezados no cambian con el idioma: la cabecera `Accept-Language` sólo elige el idioma de las filas de ejemplo y del nombre de la hoja; de forma predeterminada se entregan en español. La importación acepta después encabezados en ambos idiomas de forma insensible a acentos.
          */
         get: operations["downloadBeneficiaryImportTemplate"];
         put?: never;
@@ -659,7 +858,7 @@ export interface paths {
         put?: never;
         /**
          * Iniciar importación masiva de beneficiarios
-         * @description Sube un archivo (CSV, XLS, XLSX, TXT o PDF) de hasta 20 MB y abre con él un trabajo de importación.
+         * @description Sube un archivo (CSV, XLS, XLSX, TXT, JSON o PDF) de hasta 20 MB y abre con él un trabajo de importación.
          *     Las hojas XLSX/XLS admiten hasta 10 000 filas y 64 columnas. Las fórmulas XLSX se leen como texto, sin ejecutarlas. Los PDF admiten hasta 50 páginas y limitan a 8 MiB la descompresión de cada flujo.
          *
          *     El modo de lectura decide cuánto trabajo hace el archivo y cuánto el servidor:
@@ -729,7 +928,7 @@ export interface paths {
          * Previsualizar las filas extraídas de la importación
          * @description Devuelve las filas extraídas del archivo en un trabajo de importación (paginadas y filtrables por grupo).
          *
-         *     Disponible solo cuando la importación está en `preview_ready` o estados posteriores con `total_rows>0`.
+         *     Responde en cualquier estado del trabajo; antes de `preview_ready` la lista sale vacía.
          *
          *     {% callout type="warning" %}
          *     En este endpoint los datos de CLABEs, tarjetas o celulares NO son enmascarados. Se presume que el usuario solicitante de la importación ya tiene en su poder dichos datos, por lo que no hay motivos para tratarlos bajo nuestra política de {% concept slug="pii-masking" %}enmascarado de datos{% /concept %}
@@ -810,8 +1009,8 @@ export interface paths {
          *
          *     Reglas de la confirmación:
          *
-         *     - Filas `valid` y `correctable`: Se persisten (con sufijo de alias si hubo colisión de alias).
-         *     - Filas `fatal` y `duplicate_account`: Se omiten.
+         *     - Filas `valid` y `correctable`: Se persisten (con sufijo de alias si hubo colisión de alias). La excepción es un celular sin banco válido (`bank_code_required_for_phone` o `invalid_bank_code`): se corrige eligiendo el banco en la vista previa, y si al confirmar sigue sin banco no se guarda, queda como `fatal` con ese mismo código y cuenta en `skipped_count`.
+         *     - Filas `fatal` y `duplicate_account`: Se omiten, salvo una `duplicate_account` cuya cuenta está archivada, que se reactiva.
          *     - Cuentas previamente archivadas con el mismo número: Se reactivan en lugar de duplicarse.
          */
         post: operations["commitBeneficiaryImport"];
@@ -860,9 +1059,9 @@ export interface paths {
          * Obtener métricas de uso de la API
          * @description Devuelve las métricas de uso de la API del usuario autenticado:
          *
-         *     - Peticiones a la API hoy y en el mes.
+         *     - Peticiones con clave de API hoy y en el mes.
          *     - Cuota del plan vigente.
-         *     - Últimas peticiones a la API.
+         *     - Últimas 15 peticiones con clave de API.
          *     - Validaciones consumidas por mes.
          *     - Estado actual del servicio Banxico CEP.
          */
@@ -886,7 +1085,7 @@ export interface paths {
          * Obtener el resumen del panel
          * @description Devuelve los contadores agregados del usuario: el total histórico, el total
          *     del mes UTC en curso, las validaciones con veredicto `valid`, el contador
-         *     mensual de los estados `pending` y `processing`, el monto promedio y la
+         *     mensual de los estados `queued` y `processing`, el monto promedio y la
          *     tasa de éxito. Incluye también la cantidad de beneficiarios activos.
          *
          *     `relationships.recent_validations` contiene las validaciones no retiradas
@@ -974,7 +1173,10 @@ export interface paths {
          *     - `degraded`: Problemas parciales — latencia elevada o errores
          *       intermitentes.
          *     - `down`: El servicio es por el momento inaccesible.
-         *     - `unknown`: Aún no hay datos de chequeos de salud disponibles.
+         *     - `unknown`: No hay datos de salud vigentes: aún no se ha ejecutado ningún
+         *       chequeo, o el último es más viejo que tres veces `check_interval_seconds`
+         *       porque el chequeo automático dejó de correr. En ese caso `last_verified_at`
+         *       conserva la fecha de ese último chequeo.
          *
          *     La respuesta se cachea 60 segundos en el cliente con `Cache-Control`, y ese
          *     plazo se configura en el despliegue. Cualquier usuario autenticado puede
@@ -1067,7 +1269,8 @@ export interface paths {
          *
          *     Cada endpoint puede suscribirse a diferentes eventos, entre ellos:
          *
-         *     - Eventos `validation.*`: Esperan cualquier estado terminal de una validación para notificar ese estado mediante el webhook (p. ej: `validation.completed`, `validation.error`, etc).
+         *     - Eventos `validation.*`: Avisan de cada veredicto de una validación y de cada paso de sus reintentos automáticos (p. ej: `validation.completed`, `validation.error`, etc).
+         *     - Evento `validation.returned`: avisa cuando una validación que ya había salido `valid` pasa después a `returned` porque Banxico reportó la devolución; no se emite al crear la validación, donde el evento es `validation.completed`. Para recibirlo hay que suscribirse a él además de a `validation.completed`.
          *     - Eventos `billing.*`: No producen entregas hasta que haya algún movimiento en la suscripción del usuario (p. ej: `billing.subscription_canceled`, `billing.payment_succeeded`, cuotas de uso, etc).
          *
          *     Si se alcanza el tope de endpoints registrados, la creación responde con un estado HTTP `422` (con `webhook_limit_reached` en el cuerpo) y con el valor del límite en el campo `meta.limit`.
@@ -1240,7 +1443,7 @@ export interface paths {
          * Listar entregas de todos los endpoints webhook
          * @description Devuelve una vista consolidada de las entregas hechas a los endpoints webhook del usuario autenticado.
          *
-         *     Se puede filtrar por endpoint, estado y tipo de evento.
+         *     Se puede buscar por texto con `q` y filtrar por endpoint, estado, tipo de evento, validación, código HTTP, rango de fechas, número de intento y tiempo de respuesta.
          */
         get: operations["listAllDeliveries"];
         put?: never;
@@ -1261,8 +1464,7 @@ export interface paths {
         /**
          * Exportar todas las entregas webhook como CSV o XLSX
          * @description Descarga el historial de entregas de **todos** los endpoints de la cuenta de usuario en
-         *     un archivo, con los mismos filtros que el listado: endpoint, estado y tipo de
-         *     evento.
+         *     un archivo, con los mismos filtros y la misma búsqueda (`q`) que el listado.
          *
          *     {% concept slug="exports-and-formats" %}El formato se elige{% /concept %} con `?format` —`csv` por defecto, `xlsx` como
          *     alternativa— y el tope es de 100 000 filas, que `?limit` puede bajar.
@@ -1393,8 +1595,9 @@ export interface paths {
         };
         /**
          * Consultar índices de consumo mes a mes
-         * @description Devuelve el consumo mensual de validaciones del usuario autenticado en los
-         *     últimos `months` meses, de más reciente a más antiguo.
+         * @description Devuelve el consumo mensual de validaciones del usuario autenticado en hasta
+         *     `months` meses con consumo, de más reciente a más antiguo. Los meses sin
+         *     consumo no aparecen.
          *
          *     {% callout type="warning" %}
          *     El límite que acompaña a cada fila es el de hoy, no el que regía aquel mes:
@@ -1419,7 +1622,7 @@ export interface paths {
         };
         /**
          * Desglosar consumo por operación
-         * @description Desglosa el consumo del periodo indicado por tipo de operación contabilizada (`validation`, `validation_ocr`, etc.).
+         * @description Desglosa el consumo del periodo indicado por tipo de operación contabilizada (`validation` y `sms_2fa`).
          *
          *     El parámetro `period` acepta `current` para el mes en curso o una cadena `YYYY-MM` para un mes específico.
          */
@@ -1443,13 +1646,20 @@ export interface paths {
          * Consultar los límites de tasa (rate-limits)
          * @description Devuelve los límites de tasa aplicables al usuario autenticado, por contexto.
          *
-         *     Los dos contextos no llevan los mismos límites: `api` limita por IP y por
-         *     minuto; `login` limita por IP y por correo electrónico, cada uno por minuto y
-         *     por hora.
+         *     Los contextos no llevan los mismos límites. `api` limita las peticiones
+         *     autenticadas por clave y por minuto, con el valor del plan de la cuenta
+         *     (`key_per_minute`), y suma un techo por IP (`ip_ceiling_per_minute`); las
+         *     peticiones sin clave se limitan por IP (`ip_per_minute`). `webhooks` fija las
+         *     entregas por minuto que la cuenta puede enviar hacia un mismo host destino,
+         *     según su plan (`host_per_minute`), y el tope de todos los clientes juntos
+         *     sobre ese host (`host_global_per_minute`). `login` limita por IP y por correo
+         *     electrónico, cada uno por minuto y por hora.
          *
          *     No devuelve contadores en vivo, sólo la configuración vigente. Estos límites
          *     son ajenos a la cuota mensual de validaciones, que devuelve
-         *     [`GET /v1/usage/summary`](/es/v1/usage/get-usage-summary).
+         *     [`GET /v1/usage/summary`](/es/v1/usage/get-usage-summary). El consumo de la
+         *     ventana en curso lo informan, en cada respuesta autenticada de la API, las
+         *     cabeceras `X-RateLimit-*`.
          *
          *     {% callout type="note" %}
          *     Al superarse uno de estos límites, la operación afectada responde con estado
@@ -1920,7 +2130,7 @@ export interface components {
                 api_version?: string;
                 /**
                  * @description Identificador único de la petición (hex).
-                 * @example a1b2c3d4e5f6
+                 * @example a1b2c3d4e5f66f5e4d3c2b1a
                  */
                 request_id?: string;
                 datetime?: components["schemas"]["DatetimeMeta"];
@@ -1944,8 +2154,8 @@ export interface components {
                  */
                 version?: string;
                 /**
-                 * @description Identificador único de la petición (UUID hex).
-                 * @example a1b2c3d4e5f6
+                 * @description Identificador único de la petición (24 caracteres hex).
+                 * @example a1b2c3d4e5f66f5e4d3c2b1a
                  */
                 request_id?: string;
             };
@@ -1968,7 +2178,7 @@ export interface components {
                 api_version?: string;
                 /**
                  * @description Identificador único de la petición (hex).
-                 * @example a1b2c3d4e5f6
+                 * @example a1b2c3d4e5f66f5e4d3c2b1a
                  */
                 request_id?: string;
                 datetime?: components["schemas"]["DatetimeMeta"];
@@ -2016,17 +2226,17 @@ export interface components {
              */
             name?: string;
             /**
-             * @description Rol de la cuenta de usuario en la organización. Decide qué permisos tienen sus sesiones — `owner`: Es la titular; `admin`: La administra; `user`: La usa; `viewer`: Solo lee.
+             * @description Rol de la cuenta de usuario en la organización. Decide qué permisos tienen sus sesiones — `owner`: Es la titular; `admin`: La administra; `user`: La usa.
              * @example user
              * @enum {string}
              */
-            role?: "owner" | "admin" | "user" | "viewer";
+            role?: "owner" | "admin" | "user";
             /**
-             * @description Estado de la cuenta de usuario — `active`: Permite operar con normalidad; `suspended`: Cuenta suspendida; `pending_verification`: Falta verificación de correo electrónico.
+             * @description Estado de la cuenta de usuario — `active`: Permite operar con normalidad; `suspended`: Cuenta suspendida; `revoked`: Eliminada por el usuario.
              * @example active
              * @enum {string}
              */
-            status?: "active" | "suspended" | "pending_verification";
+            status?: "active" | "suspended" | "revoked";
             /**
              * @description Zona horaria IANA con la que se presentan las fechas al usuario.
              * @example America/Mexico_City
@@ -2054,7 +2264,7 @@ export interface components {
             api_key?: {
                 /**
                  * @description Primeros 8 caracteres de la clave de API.
-                 * @example veriko_a1b2
+                 * @example veriko_
                  */
                 prefix?: string;
                 /**
@@ -2108,7 +2318,7 @@ export interface components {
                  */
                 enabled?: boolean;
                 /**
-                 * @description Canal por el que se entrega el código de autenticación (OTP) — `sms`: Por mensaje de texto; `email`: Por correo electrónico; `null`: La autenticación de 2 factores (2FA) está desactivada.
+                 * @description Canal por el que se entrega el código de autenticación (OTP) — `sms`: Por mensaje de texto; `email`: Por correo electrónico; `null`: La cuenta de usuario nunca lo ha configurado. Al desactivar la 2FA se conserva el último canal usado.
                  * @example sms
                  * @enum {string|null}
                  */
@@ -2141,7 +2351,7 @@ export interface components {
                 telegram_linked?: boolean;
             };
             /**
-             * @description `true` cuando hay una aceptación vigente de los Términos de Servicio y el Aviso de Privacidad (ambos documentos). `false` cuando falta cualquiera de los dos, o cuando quedó antes de `LEGAL_REACCEPT_SINCE` (vacía por defecto). Gatea el modal de consentimiento post-login.
+             * @description `true` cuando no queda pendiente la aceptación de ningún documento: ni los Términos de Servicio ni el Aviso de Privacidad. `false` cuando falta la aceptación de cualquiera de los dos, o cuando el equipo exigió aceptar una versión que la cuenta todavía no ha aceptado. Gatea el modal de consentimiento post-login, que lista lo pendiente en `GET /users/me/legal/pending`.
              * @example true
              */
             legal_accepted?: boolean;
@@ -2180,11 +2390,11 @@ export interface components {
              */
             outcomes?: ("not_found" | "cep_unavailable" | "error")[];
         };
-        /** @description Cuerpo de `POST /v1/validate` para una validación manual SPEI; exige `cuenta_beneficiaria` y `clave_rastreo` o `referencia_numerica`. */
-        ValidationRequest: {
+        /** @description Cuerpo de `POST /v1/validate` para una validación manual SPEI; exige `clave_rastreo` o `referencia_numerica`, y una sola de las dos formas de indicar la cuenta: `cuenta_beneficiaria` o `cuentas_candidatas`. */
+        ValidationRequest: ({
             /**
              * Format: date
-             * @description Fecha de la transferencia en formato ISO 8601 (YYYY-MM-DD).
+             * @description Fecha de envío de la transferencia en formato ISO 8601 (YYYY-MM-DD). Con ella Banxico localiza el CEP, y puede diferir del día de operación que el CEP imprime (`banxico_result.operationDate`).
              * @example 2025-03-15
              */
             fecha: string;
@@ -2195,12 +2405,12 @@ export interface components {
              */
             monto: number;
             /**
-             * @description Clave de rastreo de la transferencia (entre 1 a 30 caracteres). Acepta letras, números, guiones, diagonales y espacios. Se recorta y se le quitan caracteres invisibles de ancho cero antes de validarse, para que la misma clave copiada y pegada compare igual en toda la plataforma. Requerida si `referencia_numerica` no es enviada; ambas pueden incluirse simultáneamente para mayor precisión de búsqueda.
+             * @description Clave de rastreo de la transferencia (entre 1 a 30 caracteres). Acepta letras, números, espacios y los signos de puntuación que admite Banxico (como guiones, diagonales, puntos, comas, `#`, `@` o `_`), pero no `<`, `>` ni la barra invertida. Se recorta y se le quitan caracteres invisibles de ancho cero antes de validarse, para que la misma clave copiada y pegada compare igual en toda la plataforma. Requerida si `referencia_numerica` no es enviada. Si vienen las dos, la consulta a Banxico se hace sólo por la clave.
              * @example MXBA20250315001234
              */
             clave_rastreo?: string;
             /**
-             * @description Referencia numérica de la transferencia (entre 1 y 7 dígitos). Acepta solo números y espacios. Requerida si `clave_rastreo` no es enviada; ambas pueden incluirse simultáneamente para mayor precisión de búsqueda.
+             * @description Referencia numérica de la transferencia (entre 1 y 7 dígitos). Acepta solo números y espacios. Requerida si `clave_rastreo` no es enviada. Si viene `clave_rastreo`, la consulta se hace sólo por la clave, y una referencia mal formada no se rechaza: se ignora y se deja un aviso.
              * @example 1234567
              */
             referencia_numerica?: string;
@@ -2215,10 +2425,22 @@ export interface components {
              */
             receptor?: string;
             /**
-             * @description Cuenta bancaria receptora de la transferencia. Es obligatoria: si falta, la respuesta es un estado HTTP `422` (con `preflight_failed` y el error de campo `cuenta_required`). Puede ser CLABE (18 dígitos), tarjeta (16 dígitos) o celular DiMo (10 dígitos), y el tipo se identifica por la longitud de sus dígitos. Los espacios y guiones que separan grupos ("0121 8000 4412 345678") se ignoran automáticamente antes de contar la longitud. Para celular DiMo, si el banco receptor no puede resolverse por el campo `receptor`, por los beneficiarios registrados ni por el directorio de cuentas, la respuesta es un estado HTTP `422` (con `bank_code_unresolvable_for_phone` en el cuerpo).
+             * @description Cuenta bancaria receptora de la transferencia. Es obligatoria cuando no se envía `cuentas_candidatas`: si faltan las dos, la respuesta es un estado HTTP `422` (con `preflight_failed` y el error de campo `cuenta_required`); si vienen las dos, un `422` con `cuenta_y_candidatas_excluyentes`. Puede ser CLABE (18 dígitos), tarjeta (16 dígitos) o celular DiMo (10 dígitos), y el tipo se identifica por la longitud de sus dígitos. Los espacios y guiones que separan grupos ("0121 8000 4412 345678") se ignoran automáticamente antes de contar la longitud. Para celular DiMo, si el banco receptor no puede resolverse por el campo `receptor`, por los beneficiarios registrados ni por el directorio de cuentas, la respuesta es un estado HTTP `422` (con `bank_code_unresolvable_for_phone` en el cuerpo).
              * @example 012180004412345678
              */
-            cuenta_beneficiaria: string;
+            cuenta_beneficiaria?: string;
+            /**
+             * @description Cuentas entre las que está la receptora de la transferencia, para cuando no se sabe cuál fue. Va en lugar de `cuenta_beneficiaria`: enviar las dos responde un estado HTTP `422` (con `cuenta_y_candidatas_excluyentes` en el cuerpo).
+             *
+             *     Admite de 2 al máximo vigente de la plataforma, 3 por defecto y nunca más de 10; el `422` por exceso informa el máximo en `meta.max`. Cada cuenta es una CLABE (18 dígitos), una tarjeta (16) o un celular DiMo (10), con su dígito verificador válido y sin repetirse. Una lista que no cumple responde un `422` con `cuentas_candidatas_invalidas`, y señala en `field_errors` la posición que falló. Los dos errores ocurren antes de consumir cuota.
+             *
+             *     Consume una sola unidad de cuota, lleve las cuentas que lleve. La consulta recorre las candidatas en el orden enviado y adopta la primera que coincide con la transferencia. La ganadora se publica completa en `normalized_data.cuenta_beneficiaria`, y `candidate_match` indica su posición. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code` (`cuenta_unresolvable_after_probes` cuando no hay un diagnóstico más preciso).
+             * @example [
+             *       "012180004412345678",
+             *       "002010077777777771"
+             *     ]
+             */
+            cuentas_candidatas?: string[];
             /**
              * @description Indica si el beneficiario de la transferencia es directamente la institución receptora del pago («Pago a Banco» en el CEP de Banxico) y no uno de sus cuentahabientes. `0` para una transferencia a un cuentahabiente (valor por defecto); `1` para pagos cuyo beneficiario es el banco —pago de tarjeta de crédito, de crédito o de servicios a la propia institución. Opcional: si se omite se asume `0`.
              * @default 0
@@ -2233,16 +2455,13 @@ export interface components {
              * @example orden-4812
              */
             client_ref?: string;
-        } | unknown | unknown;
-        /**
-         * @description Código estable del fallo de una validación.
-         * @enum {string}
-         */
-        ValidationErrorCode: "network" | "captcha" | "max_retries_exceeded" | "ttl_expired" | "preflight_failed" | "rate_limit_exhausted" | "dispatch_failed" | "bank_code_unresolvable_for_phone" | "intra_bank_no_cep" | "not_found_identity" | "not_found_account" | "not_found_amount" | "not_found_account_and_amount" | "not_found_account_or_amount";
+        } & (unknown | unknown)) | unknown | unknown;
+        /** @description Código estable del fallo de una validación. La lista no es cerrada: un fallo inesperado trae `internal_error` y otros fallos pueden traer el código de su causa, así que trata un valor desconocido como un fallo genérico. */
+        ValidationErrorCode: string | ("network" | "captcha" | "max_retries_exceeded" | "ttl_expired" | "preflight_failed" | "rate_limit_exhausted" | "dispatch_failed" | "bank_code_unresolvable_for_phone" | "intra_bank_no_cep" | "not_found_identity" | "not_found_account" | "not_found_amount" | "not_found_account_and_amount" | "not_found_account_or_amount" | "internal_error");
         /** @description Estado completo del ciclo de reintentos, con configuración, avance y situación actual. */
         RetryStateFull: {
             /**
-             * @description `true` cuando existe un ciclo de reintentos activo.
+             * @description `true` cuando la validación tiene reintentos configurados, aunque su ciclo ya haya terminado (`terminal_state`).
              * @example true
              */
             enabled?: boolean;
@@ -2319,7 +2538,7 @@ export interface components {
                  */
                 status?: "queued" | "processing" | "valid" | "not_found" | "cep_unavailable" | "invalid" | "returned" | "failed" | "error";
                 /**
-                 * @description Veredicto reportado por Banxico. Puede ser: `valid`, `not_found`, `cep_unavailable`, `invalid`, `returned` o `error`. Permanece `pending` mientras no exista un veredicto de Banxico. `returned` significa que la operación se liquidó y la institución beneficiaria la devolvió después — el CEP, si existe, se sigue entregando. Solo toma `error` cuando la petición llegó a Banxico y el servicio falló; `error_code` identifica la causa.
+                 * @description Veredicto reportado por Banxico. Puede ser: `valid`, `not_found`, `cep_unavailable`, `invalid`, `returned` o `error`. Permanece `pending` mientras no exista un veredicto de Banxico. `returned` significa que la operación se liquidó y la institución beneficiaria la devolvió después — el CEP, si existe, se sigue entregando. Un `valid` no es definitivo: es el veredicto del momento de la consulta, y pasa a `returned` cuando Banxico reporta la devolución en una revisión posterior, que se pide con `POST /v1/validations/{id}/recheck` o que el servicio hace solo durante las primeras 72 horas (se emite el webhook `validation.returned`). Solo toma `error` cuando la petición llegó a Banxico y el servicio falló; `error_code` identifica la causa.
                  * @example valid
                  */
                 banxico_status?: string | null;
@@ -2328,7 +2547,7 @@ export interface components {
                  * @example 1320
                  */
                 processing_time_ms?: number | null;
-                /** @description Copia de los campos de la petición original. */
+                /** @description Copia de los campos de la petición original. `fecha` conserva la fecha de envío tal como se envió, aunque Banxico haya encontrado el pago con otra (`banxico_result._fecha`). */
                 request_data?: {
                     [key: string]: unknown;
                 };
@@ -2363,7 +2582,7 @@ export interface components {
                 processing_started_at?: string | null;
                 /**
                  * Format: date-time
-                 * @description Fecha y hora, en ISO 8601 UTC, de expiración para validaciones en cola. Tras esta marca, la validación pasa a `failed`.
+                 * @description Fecha y hora, en ISO 8601 UTC, de expiración para validaciones en cola. Tras esta marca, la validación pasa a `error` con `error_code` `ttl_expired`.
                  * @example 2026-04-30T10:15:00Z
                  */
                 expires_at?: string | null;
@@ -2373,10 +2592,25 @@ export interface components {
                  */
                 etag_version?: number | null;
                 /**
-                 * @description Referencia relativa del comprobante, imagen o PDF (solo si `validation_type` es del tipo `ocr`).
-                 * @example ocr/2026/04/a1b2c3d4.jpg
+                 * @description Referencia relativa del comprobante, imagen o PDF (solo si `validation_type` es del tipo `ocr`). No se publica cuando el archivo no se conserva: ver `image_retained`.
+                 * @example comprobantes/3fa85f64-5717-4562-b3fc-2c963f66afa6.jpg
                  */
                 image_path?: string | null;
+                /**
+                 * @description `true` cuando la plataforma conserva el archivo del comprobante; `false` cuando no, porque la petición envió `retain_image=false` o porque la validación se purgó. Solo aparece en las validaciones de tipo `ocr`.
+                 *
+                 *     Con `false`, `GET /v1/validations/{id}/image` responde un estado HTTP `410` (con `image_not_retained` o `validation_purged` en el cuerpo).
+                 * @example true
+                 */
+                image_retained?: boolean;
+                /**
+                 * Format: date-time
+                 * @description Fecha y hora, en ISO 8601 UTC, en que la validación se purgó con `POST /v1/validations/{id}/purge/execute`. Solo aparece en una validación purgada, que queda como una lápida.
+                 *
+                 *     Una lápida conserva `id`, `validation_type`, `status`, `banxico_status`, las fechas, `processing_time_ms`, `error_code` y el monto en `normalized_data.monto`. No conserva el archivo, el CEP, `request_data`, `ocr_result` ni `banxico_result`, y sus recursos derivados responden un estado HTTP `410` (con `validation_purged` en el cuerpo).
+                 * @example 2026-10-02T09:30:00Z
+                 */
+                purged_at?: string;
                 /**
                  * @description Campos extraídos del comprobante (solo si `validation_type` es del tipo `ocr`).
                  *
@@ -2392,7 +2626,7 @@ export interface components {
                  * @example 0.94
                  */
                 ocr_confidence?: number | null;
-                /** @description Campos normalizados después de la extracción OCR (solo si `validation_type` es del tipo `ocr`). */
+                /** @description Campos normalizados después de la extracción OCR (si `validation_type` es del tipo `ocr`), o la cuenta ganadora en `cuenta_beneficiaria` cuando una validación directa envió `cuentas_candidatas`. Una lápida conserva aquí solo el monto. */
                 normalized_data?: {
                     [key: string]: unknown;
                 } | null;
@@ -2418,9 +2652,9 @@ export interface components {
                     created_at: string;
                 };
                 /**
-                 * @description Conflicto entre la cuenta enviada y la que muestra la imagen. Solo aparece en validaciones de tipo `ocr`, cuando se envió `cuenta_beneficiaria` y la imagen muestra otra cuenta completa de la misma longitud, válida y con confianza suficiente.
+                 * @description Conflicto entre la cuenta enviada y la que muestra la imagen. Solo aparece en validaciones de tipo `ocr`, cuando se envió `cuenta_beneficiaria` y la imagen muestra otra cuenta completa de la misma longitud, válida y con confianza suficiente, o una cuenta enmascarada cuyos dígitos finales visibles (3 o más) no son el final de la cuenta enviada.
                  *
-                 *     Prevalece la cuenta enviada, que es la que se consulta en Banxico: el campo no cambia el veredicto. Si el pago fue a la cuenta de la imagen, lo esperable es un `not_found`. Solo trae los últimos 4 dígitos de cada cuenta, y el conflicto también se añade a `normalization_warnings`.
+                 *     Prevalece la cuenta enviada, que es la que se consulta en Banxico: el campo no cambia el veredicto. Si el pago fue a la cuenta de la imagen, lo esperable es un `not_found`. Solo trae los últimos 4 dígitos de cada cuenta, y el conflicto también se añade a `normalization_warnings`. Con una cuenta enmascarada, `read_last4` trae los dígitos finales que el propio comprobante muestra (3 o 4), nunca más.
                  */
                 account_conflict?: {
                     /**
@@ -2429,11 +2663,28 @@ export interface components {
                      */
                     sent_last4: string;
                     /**
-                     * @description Últimos 4 dígitos de la cuenta completa que muestra la imagen.
+                     * @description Últimos 4 dígitos de la cuenta que muestra la imagen (los visibles, 3 o 4, si está enmascarada).
                      * @example 9012
                      */
                     read_last4: string;
                 };
+                /**
+                 * @description Cuál de las `cuentas_candidatas` enviadas ganó. Solo aparece cuando la petición llevó esa lista y una de las cuentas coincidió con la transferencia.
+                 *
+                 *     La cuenta completa va en `normalized_data.cuenta_beneficiaria`; este objeto indica qué posición de la lista es, para correlacionarla con la entidad propia del integrador sin comparar cuentas. No cambia el veredicto.
+                 */
+                candidate_match?: {
+                    /**
+                     * @description Posición (desde 0) de la cuenta ganadora en el arreglo `cuentas_candidatas`, tal como se envió.
+                     * @example 1
+                     */
+                    index: number;
+                    /**
+                     * @description Últimos 4 dígitos de la cuenta ganadora.
+                     * @example 7771
+                     */
+                    account_last4: string;
+                };
                 /** @description Indica si la cuenta beneficiaria viene enmascarada en el comprobante cargado, sea una CLABE, una tarjeta o un celular. Solo se incluye cuando vale `true` y solo si `validation_type` es del tipo `ocr`. */
                 is_masked?: boolean | null;
                 /**
@@ -2445,15 +2696,32 @@ export interface components {
                  *     `authenticated` es `true` cuando su sello y su cadena original coinciden con los del CEP oficial;
                  *     con `false`, `differing_fields` lista los campos que difieren y `normalization_warnings` lo avisa.
                  *     El veredicto sigue siendo el de Banxico.
+                 *
+                 *     `_payment_status` es el estado oficial del pago, tal como lo dio Banxico la última vez que se le preguntó:
+                 *     `code` (`liquidado`, `en_proceso`, `cancelado`, `rechazado`, `en_proceso_devolucion`, `devuelto` o `desconocido`),
+                 *     `label`, `settled`, `reversed` y `checked_at` (ISO 8601 UTC).
+                 *     Su ausencia significa que no se pudo saber, nunca que el pago esté liquidado.
+                 *     Se actualiza en cada revisión posterior, y con `devuelto` o `en_proceso_devolucion` la validación pasa a `returned`.
+                 *
+                 *     `_fecha` aparece cuando Banxico no encontró el pago con la fecha enviada y sí con otra.
+                 *     `used` es la fecha con la que se encontró, `requested` es la fecha con la que se consultó primero
+                 *     y `reason` es el motivo por el que se probó `used`.
+                 *     Valores de `reason`:
+                 *     `clave_embedded_date`: La clave de rastreo incrusta otra fecha, a un día hábil SPEI o menos de la enviada;
+                 *     `cutoff_18h`: La clave no incrusta fecha y el comprobante indica una hora cercana al corte de las 18:00,
+                 *     así que se probó el día siguiente;
+                 *     `dia_operacion`: La clave incrusta la fecha enviada, porque el comprobante trae la de operación,
+                 *     y se probó un día anterior hasta el día hábil previo.
+                 *     El veredicto sigue siendo el de Banxico, y `request_data.fecha` conserva la fecha enviada.
                  */
                 banxico_result?: ({
                     /**
-                     * @description Fecha de la operación tal como la reporta el CEP de Banxico (`AAAA-MM-DD`).
+                     * @description Día hábil SPEI que Banxico asignó a la operación, tal como lo reporta el CEP (`YYYY-MM-DD`), en hora del centro de México. Puede diferir de la fecha de envío: lo enviado a partir de las 18:00, en sábado, en domingo o en un día inhábil opera el siguiente día hábil.
                      * @example 2025-03-15
                      */
                     operationDate?: string;
                     /**
-                     * @description Hora de la operación tal como la reporta el CEP de Banxico (`HH:MM:SS`).
+                     * @description Hora de la operación tal como la reporta el CEP (`HH:MM:SS`), en hora del centro de México y no en UTC.
                      * @example 14:22:10
                      */
                     processingTime?: string;
@@ -2544,13 +2812,13 @@ export interface components {
                  */
                 self?: string;
                 /**
-                 * @description URL del CEP en formato XML. `null` cuando `status` no es `valid`, o es `returned` sin comprobante (la operación se devolvió antes de emitirse un CEP).
-                 * @example /v1/validations/a1b2c3d4-e5f6-7890-abcd-ef0123456789/cep.xml
+                 * @description URL del CEP en formato XML. Solo aparece cuando `banxico_status` es `valid`, o es `returned` con comprobante, y la validación no se purgó; si no, se omite el objeto `links`.
+                 * @example /v1/validations/a1b2c3d4-e5f6-4890-abcd-ef0123456789/cep?format=xml
                  */
                 cep_xml?: string | null;
                 /**
-                 * @description URL del CEP en formato PDF. `null` cuando `status` no es `valid`, o es `returned` sin comprobante (la operación se devolvió antes de emitirse un CEP).
-                 * @example /v1/validations/a1b2c3d4-e5f6-7890-abcd-ef0123456789/cep.pdf
+                 * @description URL del CEP en formato PDF. Solo aparece cuando `banxico_status` es `valid`, o es `returned` con comprobante, y la validación no se purgó; si no, se omite el objeto `links`.
+                 * @example /v1/validations/a1b2c3d4-e5f6-4890-abcd-ef0123456789/cep?format=pdf
                  */
                 cep_pdf?: string | null;
             };
@@ -2615,25 +2883,47 @@ export interface components {
                 playground?: boolean;
             };
         };
-        /** @description Cuerpo de `POST /v1/validate-ocr` con el comprobante en `image` o `image_url`; exige al menos uno de ambos campos. */
+        /** @description Cuerpo de `POST /v1/validate-ocr` con el comprobante en `image` o `image_url`; exige al menos uno de ambos campos. `cuenta_beneficiaria` y `cuentas_candidatas` no pueden ir juntas. */
         OcrValidationRequest: {
             /**
              * Format: byte
-             * @description Comprobante codificado en base64, en imagen o en PDF. Si también se proporciona `image_url`, solo se considera `image`. Formatos aceptados: JPEG, PNG, WebP o PDF de 1 a 3 páginas. Tamaño máximo: `12 MB`. Dimensiones máximas de una imagen: `12000px` por lado. Admite el prefijo `data:image/...;base64,` o `data:application/pdf;base64,`.
+             * @description Comprobante codificado en base64, en imagen o en PDF. Si también se proporciona `image_url`, solo se considera `image_url`. Formatos aceptados: JPEG, PNG, WebP o PDF de 1 a 3 páginas. Tamaño máximo: `12 MB`. Dimensiones máximas de una imagen: `12000px` por lado. Admite el prefijo `data:image/...;base64,` o `data:application/pdf;base64,`.
              * @example iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==
              */
             image?: string;
             /**
              * Format: uri
-             * @description URL pública (HTTPS) del comprobante. Sigue los mismos límites de formato y tamaño que `image`: JPEG, PNG, WebP o PDF de 1 a 3 páginas, con un máximo de `12 MB`.
+             * @description URL pública (HTTPS) del comprobante. Sigue los mismos límites de formato y tamaño que `image`: JPEG, PNG, WebP o PDF de 1 a 3 páginas, con un máximo de `12 MB`. Una URL `http` responde un estado HTTP `422` (con `invalid_url_scheme` en el cuerpo), y una redirección hacia `http` no se sigue.
              * @example https://storage.example.com/receipts/comprobante-2025-03.jpg
              */
             image_url?: string;
             /**
-             * @description Cuenta receptora de la transferencia (útil cuando falta o está incompleta en la imagen). Requerida para celular DiMo; opcional si la imagen muestra la cuenta completa o sus últimos dígitos, que se completan con los beneficiarios guardados (estos no sustituyen a este campo). Acepta CLABE (18 dígitos), tarjeta (16 dígitos) o celular DiMo (10 dígitos).
+             * @description Cuenta receptora de la transferencia (útil cuando falta o está incompleta en la imagen). Requerida para celular DiMo; opcional si la imagen muestra la cuenta completa o sus últimos dígitos, que se completan con los beneficiarios guardados (estos no sustituyen a este campo). Acepta CLABE (18 dígitos), tarjeta (16 dígitos) o celular DiMo (10 dígitos). No puede enviarse junto con `cuentas_candidatas`: enviar las dos responde un estado HTTP `422` (con `cuenta_y_candidatas_excluyentes` en el cuerpo).
              * @example 012180004412345678
              */
             cuenta_beneficiaria?: string;
+            /**
+             * @description Cuentas entre las que está la receptora de la transferencia, para cuando la imagen no la muestra y no se sabe cuál fue. Va en lugar de `cuenta_beneficiaria`: enviar las dos responde un estado HTTP `422` (con `cuenta_y_candidatas_excluyentes` en el cuerpo). Tiene prioridad sobre la cuenta que se lea en la imagen.
+             *
+             *     Admite de 2 al máximo vigente de la plataforma, 3 por defecto y nunca más de 10; el `422` por exceso informa el máximo en `meta.max`. Cada cuenta es una CLABE (18 dígitos), una tarjeta (16) o un celular DiMo (10), con su dígito verificador válido y sin repetirse. Una lista que no cumple responde un `422` con `cuentas_candidatas_invalidas`, y señala en `field_errors` la posición que falló. Los dos errores ocurren antes de consumir cuota.
+             *
+             *     Consume una sola unidad de cuota, lleve las cuentas que lleve, también con `?async=1`. La consulta recorre las candidatas en el orden enviado y adopta la primera que coincide con la transferencia. La ganadora se publica completa en `normalized_data.cuenta_beneficiaria`, y `candidate_match` indica su posición. Si ninguna coincide, la respuesta es un estado HTTP `422` con el motivo en `code` (`cuenta_unresolvable_after_probes` cuando no hay un diagnóstico más preciso).
+             * @example [
+             *       "012180004412345678",
+             *       "002010077777777771"
+             *     ]
+             */
+            cuentas_candidatas?: string[];
+            /**
+             * @description **Código SPEI** del banco emisor (4 o 5 dígitos, p. ej. `40012`), para corregir el que se leyó del comprobante. Sustituye al leído antes de consultar Banxico. Un valor que no son 4 o 5 dígitos (un nombre, por ejemplo) se ignora y se conserva el leído.
+             * @example 40012
+             */
+            banco_emisor?: string;
+            /**
+             * @description **Código SPEI** del banco receptor (4 o 5 dígitos, p. ej. `40002`), para corregir el que se leyó del comprobante. Sustituye al leído antes de consultar Banxico. Un valor que no son 4 o 5 dígitos (un nombre, por ejemplo) se ignora y se conserva el leído.
+             * @example 40002
+             */
+            banco_receptor?: string;
             /** @description Política de reintentos automáticos para esta validación. Si se omite, se aplica la política general del usuario, configurada en `PUT /v1/users/me/retry-policy`. **Los reintentos no consumen cuota de validaciones**. */
             retry_policy?: components["schemas"]["RetryPolicy"];
             /**
@@ -2641,11 +2931,21 @@ export interface components {
              * @example orden-4812
              */
             client_ref?: string;
+            /**
+             * @description `true` cuando la plataforma conserva el archivo del comprobante después de validarlo, que es lo habitual. Con `false`, el archivo se borra en cuanto la validación llega a un estado terminal del que ya no se necesita; el veredicto y los datos extraídos se conservan.
+             *
+             *     Con `false`, la validación publica `image_retained=false` y `GET /v1/validations/{id}/image` responde un estado HTTP `410` (con `image_not_retained` en el cuerpo). Vale igual con `?async=1`.
+             *
+             *     El archivo existe mientras la validación se procesa. Si entró como un CEP en PDF y tiene reintentos automáticos activos, el borrado espera a que ese ciclo cierre, porque cada reintento vuelve a comparar el sello del PDF. Un valor que no es booleano responde un estado HTTP `422` (con `invalid_retain_image` en el cuerpo), antes de consumir cuota.
+             * @default true
+             * @example false
+             */
+            retain_image: boolean;
         } | unknown | unknown;
         /** @description Estado resumido del ciclo de reintentos, con la configuración representada como `null`. */
         RetryStateCompact: {
             /**
-             * @description `true` cuando existe un ciclo de reintentos activo.
+             * @description `true` cuando la validación tiene reintentos configurados, aunque su ciclo ya haya terminado (`terminal_state`).
              * @example true
              */
             enabled?: boolean;
@@ -2692,7 +2992,7 @@ export interface components {
             id: string;
             /** @description Datos mostrados en el historial de validaciones. */
             attributes: {
-                /** @description Nombre del banco de la contraparte. Prioriza `receptor_name` o `emisor_name` guardado; si falta, intenta resolver el código de receptor o emisor. Si tampoco puede resolverlo, devuelve ese código o `Banco no identificado`. */
+                /** @description Nombre del banco de la contraparte. Prioriza `receptor_name` o `emisor_name` guardado; si falta, intenta resolver el código de receptor o emisor. Si tampoco puede resolverlo, devuelve el valor guardado cuando no es una clave numérica, o `Banco no identificado` (en inglés, `Unidentified bank`). */
                 bank_name?: string;
                 /** @description Clave Banxico canónica (3-5 dígitos) del banco de la contraparte, resuelta por la autoridad del dominio. `null` cuando el banco no pudo resolverse. Es aditiva respecto de `bank_name`: sirve para resolver recursos/avatares por clave, nunca por el nombre visible. */
                 bank_code?: string | null;
@@ -2726,6 +3026,8 @@ export interface components {
                 created_at?: components["schemas"]["TimestampUTC"];
                 /** @description Fecha de retiro del historial, en ISO 8601 UTC. */
                 deleted_at?: components["schemas"]["TimestampUTC"] | null;
+                /** @description Fecha y hora, en ISO 8601 UTC, en que la validación se purgó. Solo aparece en una validación purgada, que queda como una lápida con su veredicto, sus fechas y su monto. */
+                purged_at?: components["schemas"]["TimestampUTC"];
                 retry_state?: components["schemas"]["RetryStateCompact"];
                 /**
                  * @description Referencia propia enviada al validar (`client_ref`), devuelta tal cual. Solo aparece cuando la petición la incluyó.
@@ -2915,6 +3217,211 @@ export interface components {
         CancelValidationRetriesAttributes: {
             retry_state?: components["schemas"]["RetryStateFull"];
         };
+        /** @description Resultado de la revisión que acompaña, dentro de `meta`, la respuesta de `POST /v1/validations/{id}/recheck`. */
+        ValidationRecheckMeta: {
+            /**
+             * Format: date-time
+             * @description Fecha y hora, en ISO 8601 UTC, en que se consultó el estado del pago a Banxico. `null` cuando no se consultó nada porque la validación ya estaba en `returned`.
+             * @example 2026-10-01T18:42:07Z
+             */
+            checked_at: string | null;
+            /**
+             * @description `true` cuando esta consulta pasó la validación de `valid` a `returned`. En ese caso también se emitió el webhook `validation.returned`.
+             * @example false
+             */
+            changed: boolean;
+            /**
+             * @description Veredicto de Banxico antes de esta consulta — `valid`: La validación seguía confirmada; `returned`: La validación ya estaba devuelta y no se consultó nada.
+             * @example valid
+             * @enum {string}
+             */
+            previous_status: "valid" | "returned";
+        };
+        /** @description Respuesta de `POST /v1/validations/{id}/purge/prepare`: lo que borraría el borrado definitivo, lo que conservaría y el token que lo confirma. Todavía no ha cambiado nada. */
+        ValidationPurgePrepareResponse: {
+            /** @description Recurso JSON:API de la preparación. Su `id` es el de la validación. */
+            data: components["schemas"]["JsonApiResourceBase"] & {
+                /**
+                 * @description Tipo del recurso, fijo para esta operación. Forma parte de su identidad en la envoltura JSON:API. Siempre `validation_purge`.
+                 * @example validation_purge
+                 * @enum {string}
+                 */
+                type: "validation_purge";
+                /**
+                 * Format: uuid
+                 * @description Identificador de la validación que se borraría.
+                 * @example 3fa85f64-5717-4562-b3fc-2c963f66afa6
+                 */
+                id: string;
+                /** @description Resumen del borrado y token de confirmación. */
+                attributes: {
+                    /**
+                     * @description Token de un solo uso, atado a la cuenta y a esta validación, que `POST /v1/validations/{id}/purge/execute` exige para borrar. Caduca en `expires_in` segundos.
+                     * @example eyJhZG1pbl9pZCI6Ii4uLiJ9.q1w2e3r4t5y6u7i8o9p0
+                     */
+                    confirmation_token: string;
+                    /**
+                     * @description Segundos de vigencia del token.
+                     * @example 120
+                     */
+                    expires_in: number;
+                    /**
+                     * @description `true` siempre: el borrado no se puede deshacer. Un respaldo de infraestructura no lo revierte para el cliente.
+                     * @example true
+                     */
+                    irreversible: boolean;
+                    /** @description Lo que borraría el borrado definitivo. */
+                    will_delete: {
+                        /**
+                         * @description `true` cuando hay un archivo del comprobante (imagen o PDF) que se borraría.
+                         * @example true
+                         */
+                        image: boolean;
+                        /**
+                         * @description `true` cuando hay un CEP (el XML o el PDF) que se borraría.
+                         * @example true
+                         */
+                        cep: boolean;
+                        /**
+                         * @description Campos de la validación con contenido que se vaciarían. De `normalized_data` se conserva únicamente el monto.
+                         * @example [
+                         *       "request_data",
+                         *       "ocr_result",
+                         *       "normalized_data",
+                         *       "banxico_result"
+                         *     ]
+                         */
+                        stored_data: ("request_data" | "ocr_result" | "normalized_data" | "normalization_warnings" | "banxico_result")[];
+                        /**
+                         * @description Cantidad de intentos de reintento que se borrarían.
+                         * @example 2
+                         */
+                        retry_attempts: number;
+                        /**
+                         * @description Cantidad de sondeos de cuenta candidata que se borrarían.
+                         * @example 0
+                         */
+                        probe_attempts: number;
+                        /**
+                         * @description Cantidad de entregas de webhook de esta validación a las que se les quitaría el cuerpo enviado y la respuesta del receptor. El registro de cada entrega se conserva.
+                         * @example 1
+                         */
+                        webhook_deliveries: number;
+                        /**
+                         * @description Cantidad de entregas de notificación de esta validación cuyo contenido se vaciaría. Las notificaciones de la bandeja de la cuenta se borrarían.
+                         * @example 1
+                         */
+                        notifications: number;
+                        /**
+                         * @description Cantidad de respuestas guardadas de `Idempotency-Key` que se borrarían.
+                         * @example 1
+                         */
+                        idempotency_responses: number;
+                        /**
+                         * @description `true` siempre: los cuerpos de las filas de auditoría que nombran la validación se quitarían, y el contexto libre de sus eventos de seguridad se reduciría a ids y códigos.
+                         * @example true
+                         */
+                        audit_traces: boolean;
+                    };
+                    /**
+                     * @description Campos que conserva la lápida en que queda la validación: bastan para que la cuota, las estadísticas, finanzas y el historial sigan cuadrando.
+                     * @example [
+                     *       "id",
+                     *       "validation_type",
+                     *       "status",
+                     *       "banxico_status",
+                     *       "amount",
+                     *       "created_at",
+                     *       "purged_at"
+                     *     ]
+                     */
+                    will_keep: string[];
+                    /**
+                     * @description `true` cuando la validación tiene un ciclo de reintentos abierto, que el borrado cancela.
+                     * @example false
+                     */
+                    cancels_pending_retries: boolean;
+                    /**
+                     * @description `false` siempre: el borrado no devuelve cuota ni cambia lo cobrado.
+                     * @example false
+                     */
+                    refunds_quota: boolean;
+                    /**
+                     * @description Identificadores de otras validaciones de la misma cuenta con el mismo comprobante (hasta 20). No se tocan: cada una guarda su propia copia de lo extraído y se borra por separado.
+                     * @example []
+                     */
+                    same_image_validation_ids: string[];
+                };
+            };
+        };
+        /** @description Cuerpo de `POST /v1/validations/{id}/purge/execute`: el token del paso de preparación. */
+        ValidationPurgeExecuteRequest: {
+            /**
+             * @description Token que devolvió `POST /v1/validations/{id}/purge/prepare` para esta misma validación y esta misma cuenta. Es de un solo uso y caduca en el plazo que indicó `expires_in`.
+             * @example eyJhZG1pbl9pZCI6Ii4uLiJ9.q1w2e3r4t5y6u7i8o9p0
+             */
+            confirmation_token: string;
+        };
+        /** @description Respuesta de `POST /v1/validations/{id}/purge/execute`: la validación quedó purgada y esto es lo que se borró. */
+        ValidationPurgeExecuteResponse: {
+            /** @description Recurso JSON:API del borrado. Su `id` es el de la validación. */
+            data: components["schemas"]["JsonApiResourceBase"] & {
+                /**
+                 * @description Tipo del recurso, fijo para esta operación. Forma parte de su identidad en la envoltura JSON:API. Siempre `validation_purge`.
+                 * @example validation_purge
+                 * @enum {string}
+                 */
+                type: "validation_purge";
+                /**
+                 * Format: uuid
+                 * @description Identificador de la validación purgada.
+                 * @example 3fa85f64-5717-4562-b3fc-2c963f66afa6
+                 */
+                id: string;
+                /** @description Resultado del borrado. */
+                attributes: {
+                    /**
+                     * Format: date-time
+                     * @description Fecha y hora, en ISO 8601 UTC, en que la validación quedó purgada.
+                     * @example 2026-10-02T09:30:00Z
+                     */
+                    purged_at: string;
+                    /**
+                     * @description Estado del borrado de los archivos — `complete`: Los archivos ya no existen; `pending`: Algún archivo no se pudo borrar en este momento y el barrido diario lo termina. El contenido de la base de datos ya está borrado en los dos casos y el archivo no se sirve.
+                     * @example complete
+                     * @enum {string}
+                     */
+                    file_removal: "complete" | "pending";
+                    /** @description Lo que se borró. Los contadores cuentan filas tocadas; los booleanos dicen si había algo que borrar. */
+                    deleted: {
+                        /** @description `true` cuando había un archivo del comprobante. */
+                        image?: boolean;
+                        /** @description `true` cuando había un PDF del CEP. */
+                        cep_pdf?: boolean;
+                        /** @description `true` cuando el borrado cerró un ciclo de reintentos que seguía abierto. */
+                        retry_cycle_cancelled?: boolean;
+                        /** @description Intentos de reintento borrados. */
+                        retry_attempts?: number;
+                        /** @description Sondeos de cuenta candidata borrados. */
+                        probe_attempts?: number;
+                        /** @description Entregas de webhook a las que se les quitó el cuerpo enviado y la respuesta del receptor. */
+                        webhook_deliveries?: number;
+                        /** @description Entregas de notificación cuyo contenido se vació. */
+                        notification_deliveries?: number;
+                        /** @description Notificaciones de la bandeja que se borraron. */
+                        notifications?: number;
+                        /** @description Respuestas guardadas de `Idempotency-Key` que se borraron. */
+                        idempotency_responses?: number;
+                        /** @description Filas de importación masiva cuyo contenido se vació. */
+                        import_rows?: number;
+                        /** @description Filas de auditoría a las que se les quitaron los cuerpos. Falta cuando ese barrido no se pudo completar. */
+                        audit_log_rows?: number;
+                        /** @description Eventos de seguridad cuyo contexto se redactó. Falta cuando ese barrido no se pudo completar. */
+                        security_events_rows?: number;
+                    };
+                };
+            };
+        };
         /** @description Banco participante del catálogo SPEI, en formato JSON:API. `id` y `attributes.code` son siempre iguales (`id` se conserva como identificador estable del recurso aunque `code` lo duplique). */
         BankResource: components["schemas"]["JsonApiResourceBase"] & {
             /**
@@ -2976,7 +3483,7 @@ export interface components {
                  */
                 bin: string;
                 /**
-                 * @description Nombre oficial del banco, resuelto a partir de su `bank_code`.
+                 * @description Nombre del banco registrado para ese BIN.
                  * @example BBVA MEXICO
                  */
                 bank_name: string;
@@ -3011,25 +3518,103 @@ export interface components {
         BinLookupResponse: components["schemas"]["SuccessEnvelope"] & {
             data: components["schemas"]["BinResource"];
         };
-        /** @description Cupo de beneficiarios activos del plan y ocupación actual de la cuenta autenticada. */
-        BeneficiaryCapacity: {
-            /** @description Tope de beneficiarios activos. `-1` significa sin tope. */
-            max?: number;
-            /** @description Cantidad de beneficiarios activos guardados, independientemente del filtro de archivados. */
-            current?: number;
-            /** @description Cantidad de lugares necesarios para crear o reactivar cuentas del trabajo de importación. */
-            required?: number;
-            /** @description `true` cuando el trabajo de importación necesita lugares nuevos y supera el cupo disponible. */
-            exceeded?: boolean;
-        };
-        /** @description Cuenta beneficiaria registrada como recurso JSON:API. Puede ser una CLABE, un número de tarjeta o un número de celular DiMo. El tipo de cuenta se autodetecta por longitud al momento de inserción. */
-        Beneficiary: components["schemas"]["JsonApiResourceBase"] & {
+        /** @description Calendario de días inhábiles SPEI de un año, en formato JSON:API. `id` y `attributes.year` son siempre iguales: el año del calendario. */
+        SpeiCalendarResource: components["schemas"]["JsonApiResourceBase"] & {
             /**
-             * @description Tipo de recurso JSON:API. Siempre `beneficiary`.
-             * @example beneficiary
+             * @description Tipo de recurso JSON:API. Siempre `spei_calendar`.
+             * @example spei_calendar
              * @enum {string}
              */
-            type: "beneficiary";
+            type: "spei_calendar";
+            /**
+             * @description Año del calendario (cuatro dígitos).
+             * @example 2026
+             */
+            id: string;
+            /** @description Datos del calendario del año. */
+            attributes: {
+                /**
+                 * @description Año del calendario (cuatro dígitos). Mismo valor que `id`.
+                 * @example 2026
+                 */
+                year: number;
+                /**
+                 * @description Días inhábiles que caen de lunes a viernes (`YYYY-MM-DD`), de menor a mayor. Los sábados y los domingos también son inhábiles y no se repiten aquí.
+                 * @example [
+                 *       "2026-01-01",
+                 *       "2026-02-02",
+                 *       "2026-03-16",
+                 *       "2026-04-02",
+                 *       "2026-04-03",
+                 *       "2026-05-01",
+                 *       "2026-09-16",
+                 *       "2026-11-02",
+                 *       "2026-11-16",
+                 *       "2026-12-25"
+                 *     ]
+                 */
+                non_business_days: string[];
+                /** @description Disposición oficial de la que sale el calendario. */
+                source: {
+                    /**
+                     * @description Siglas de la autoridad que emite la disposición, por ejemplo `CNBV`.
+                     * @example CNBV
+                     */
+                    issuer: string;
+                    /**
+                     * @description Siglas del medio oficial en el que se publicó la disposición, por ejemplo `DOF`.
+                     * @example DOF
+                     */
+                    published_in: string;
+                    /**
+                     * Format: date
+                     * @description Fecha de publicación de la disposición (`YYYY-MM-DD`).
+                     * @example 2025-12-10
+                     */
+                    published_on: string;
+                    /**
+                     * @description Título oficial de la disposición, en español.
+                     * @example Disposiciones de carácter general que señalan los días del año 2026 en que las entidades financieras sujetas a la supervisión de la Comisión Nacional Bancaria y de Valores deberán cerrar sus puertas y suspender operaciones
+                     */
+                    title: string;
+                };
+            };
+        };
+        /** @description Respuesta de `GET /v1/public/spei-calendar/{year}`. Un único recurso con los días inhábiles SPEI del año y su fuente, y en `meta.covered_years` los años que tienen calendario. Un año sin calendario responde `404`, no este cuerpo. */
+        SpeiCalendarResponse: components["schemas"]["SuccessEnvelope"] & {
+            data: components["schemas"]["SpeiCalendarResource"];
+            /** @description Metadatos de la respuesta. */
+            meta?: {
+                /**
+                 * @description Años con calendario publicado, de menor a mayor.
+                 * @example [
+                 *       2024,
+                 *       2025,
+                 *       2026
+                 *     ]
+                 */
+                covered_years?: number[];
+            };
+        };
+        /** @description Cupo de beneficiarios activos del plan y ocupación actual de la cuenta autenticada. */
+        BeneficiaryCapacity: {
+            /** @description Tope de beneficiarios activos. `-1` significa sin tope. */
+            max?: number;
+            /** @description Cantidad de beneficiarios activos guardados, independientemente del filtro de archivados. */
+            current?: number;
+            /** @description Cantidad de lugares necesarios para crear o reactivar cuentas del trabajo de importación. */
+            required?: number;
+            /** @description `true` cuando el trabajo de importación necesita lugares nuevos y supera el cupo disponible. */
+            exceeded?: boolean;
+        };
+        /** @description Cuenta beneficiaria registrada como recurso JSON:API. Puede ser una CLABE, un número de tarjeta o un número de celular DiMo. El tipo de cuenta se autodetecta por longitud al momento de inserción. */
+        Beneficiary: components["schemas"]["JsonApiResourceBase"] & {
+            /**
+             * @description Tipo de recurso JSON:API. Siempre `beneficiary`.
+             * @example beneficiary
+             * @enum {string}
+             */
+            type: "beneficiary";
             /**
              * @description Identificador numérico del beneficiario en el sistema.
              * @example 42
@@ -3049,12 +3634,12 @@ export interface components {
                  */
                 account_type: "clabe" | "card" | "phone";
                 /**
-                 * @description Código SPEI (5 dígitos) del banco resuelto.
+                 * @description Código SPEI (5 dígitos) del banco resuelto. Es la cadena vacía (`""`) cuando la cuenta no tiene un banco conocido: una tarjeta cuyo BIN no está en el directorio. En ese caso `bank_name` trae un texto de relleno en el idioma de la petición.
                  * @example 40012
                  */
                 bank_code: string;
                 /**
-                 * @description Nombre oficial del banco, resuelto a partir de su `bank_code`.
+                 * @description Nombre oficial del banco, resuelto a partir de su `bank_code`. Con un `bank_code` vacío es un texto de relleno («BIN no reconocido (411111)»), que se traduce al idioma de la petición.
                  * @example BBVA MEXICO
                  */
                 bank_name: string;
@@ -3152,7 +3737,7 @@ export interface components {
                  */
                 account_type: "clabe" | "card" | "phone";
                 /**
-                 * @description Código SPEI (5 dígitos) del banco resuelto.
+                 * @description Código SPEI (5 dígitos) del banco resuelto. Es la cadena vacía (`""`) para una tarjeta cuyo BIN no está en el directorio.
                  * @example 40012
                  */
                 bank_code: string;
@@ -3176,12 +3761,13 @@ export interface components {
         CreateBeneficiaryImportRequest: {
             /**
              * Format: binary
-             * @description Archivo a importar. Formatos aceptados: CSV, XLS, XLSX, TXT o PDF. Tamaño máximo: 20 MB.
+             * @description Archivo a importar. Formatos aceptados: CSV, XLS, XLSX, TXT, JSON o PDF. Tamaño máximo: 20 MB.
              * @example beneficiarios-marzo.csv
              */
             file: string;
             /**
              * @description Modo de lectura del archivo — `template`: Respeta los encabezados canónicos; `free`: Formato libre, el sistema deduce la estructura.
+             * @default template
              * @example template
              * @enum {string}
              */
@@ -3237,11 +3823,11 @@ export interface components {
                  */
                 status?: "pending" | "parsing" | "preview_ready" | "committing" | "completed" | "failed" | "cancelled";
                 /**
-                 * @description Formato del archivo subido. Aceptados: `csv`, `xls`, `xlsx`, `txt` o `pdf`.
+                 * @description Formato del archivo subido. Aceptados: `csv`, `xls`, `xlsx`, `txt`, `json` o `pdf`.
                  * @example csv
                  * @enum {string}
                  */
-                file_format?: "csv" | "xls" | "xlsx" | "txt" | "pdf";
+                file_format?: "csv" | "xls" | "xlsx" | "txt" | "json" | "pdf";
                 /**
                  * @description Modo de lectura del archivo — `template`: Respeta los encabezados canónicos; `free`: Formato libre, el sistema deduce la estructura.
                  * @example template
@@ -3289,7 +3875,7 @@ export interface components {
                  */
                 llm_invoked?: boolean;
                 /**
-                 * @description Código estable del fallo del trabajo. `null` cuando no terminó en `failed`. Por ejemplo, `file_corrupt` o `plan_cap_exceeded`.
+                 * @description Código estable del fallo del trabajo. `null` cuando no terminó en `failed`. Por ejemplo, `file_corrupt` o `empty_file`.
                  * @example null
                  */
                 error_code?: string | null;
@@ -3395,7 +3981,7 @@ export interface components {
                     [key: string]: unknown;
                 };
                 /**
-                 * @description Fragmento del archivo original para diagnóstico. Los dígitos de 6 o más caracteres consecutivos aparecen enmascarados (`••••`) para evitar exposición de números de tarjeta en los cuerpos de depuración.
+                 * @description Fragmento del archivo original para diagnóstico. Las series de 13 a 19 dígitos que no son una CLABE (18 dígitos) aparecen enmascaradas (`••••` y los últimos cuatro), igual que un número de celular de 10 dígitos cuando lo precede una etiqueta como «cuenta» o «celular», para evitar exposición de números de tarjeta en los cuerpos de depuración.
                  * @example {}
                  */
                 raw_preview?: {
@@ -3532,17 +4118,17 @@ export interface components {
         /** @description Estadísticas de uso de la API, cuota de validaciones y estado de Banxico para la cuenta. */
         ApiUsage: {
             /**
-             * @description Cantidad de peticiones a la API del usuario en el día calendario actual (UTC).
+             * @description Cantidad de peticiones del usuario con clave de API en el día calendario actual (UTC).
              * @example 42
              */
             requests_today?: number;
             /**
-             * @description Cantidad de peticiones a la API del usuario en el mes calendario actual (UTC).
+             * @description Cantidad de peticiones del usuario con clave de API en el mes calendario actual (UTC).
              * @example 580
              */
             requests_month?: number;
             quota?: components["schemas"]["PlanQuotaState"];
-            /** @description Últimas peticiones a la API del usuario, de la más reciente a la más antigua. */
+            /** @description Últimas 15 peticiones del usuario con clave de API, de la más reciente a la más antigua. */
             recent_requests?: {
                 /**
                  * @description Verbo HTTP de la petición. Uno de `GET`, `POST`, `PUT`, `PATCH` o `DELETE`.
@@ -3613,7 +4199,7 @@ export interface components {
                  */
                 monthly_validations?: number;
                 /**
-                 * @description Cantidad de validaciones no retiradas del mes UTC en curso cuyo estado almacenado es `pending` o `processing`.
+                 * @description Cantidad de validaciones no retiradas del mes UTC en curso cuyo estado almacenado es `queued` o `processing`.
                  * @example 3
                  */
                 pending_month?: number;
@@ -3629,7 +4215,7 @@ export interface components {
                 avg_ticket?: number;
                 /**
                  * @description Tasa de éxito, expresada de `0` a `100`: `valid_validations` entre `total_validations`, redondeada a un decimal. La población histórica es la misma e incluye las validaciones retiradas y las del banco de pruebas (Playground); devuelve `0` cuando el total es `0`.
-                 * @example 0
+                 * @example 90.3
                  */
                 success_rate_percent?: number;
                 /**
@@ -3658,11 +4244,16 @@ export interface components {
                         /**
                          * Format: uuid
                          * @description Identificador único de la validación (UUID v4).
-                         * @example a1b2c3d4-e5f6-7890-abcd-ef0123456789
+                         * @example a1b2c3d4-e5f6-4890-abcd-ef0123456789
                          */
                         id?: string;
                         /** @description Datos resumidos de la validación reciente mostrados en el panel. */
                         attributes?: {
+                            /**
+                             * @description Clave Banxico canónica del banco, si se puede resolver.
+                             * @example 40012
+                             */
+                            bank_code?: string | null;
                             /**
                              * @description Nombre del banco de la contraparte. Prioriza `receptor_name` o `emisor_name` guardado; si falta, intenta resolver el código de receptor o emisor. Si tampoco puede resolverlo, devuelve ese código o `Banco no identificado`.
                              * @example BBVA MEXICO
@@ -3736,6 +4327,33 @@ export interface components {
             /** @description Veredictos que admiten reintentos automáticos. */
             eligible_outcomes?: string[];
         };
+        /** @description Política de reintentos guardada de la cuenta: activación, límite, intervalo y resultados elegibles. Desactivada o sin configurar, trae `enabled=false`, `max_retries=0`, `interval_seconds=0` y `outcomes` vacío. */
+        SavedRetryPolicy: {
+            /**
+             * @description `true` cuando el ciclo de reintentos está activo. Si es `false`, los demás campos pueden ser ignorados.
+             * @example true
+             */
+            enabled?: boolean;
+            /**
+             * @description Número máximo de reintentos automáticos. Una vez alcanzado, el ciclo pasa al estado terminal `exhausted`.
+             * @example 3
+             */
+            max_retries?: number;
+            /**
+             * @description Segundos de espera entre cada reintento. Valores válidos: 300–86400 (5 min a 24h).
+             * @example 600
+             */
+            interval_seconds?: number;
+            /**
+             * @description Resultados que originan un reintento. De forma predeterminada son `not_found`, `cep_unavailable` y `error`; la combinación `["not_found", "cep_unavailable"]` excluye `error`.
+             * @example [
+             *       "not_found",
+             *       "cep_unavailable",
+             *       "error"
+             *     ]
+             */
+            outcomes?: ("not_found" | "cep_unavailable" | "error")[];
+        };
         UserRetryPolicyResponse: components["schemas"]["SuccessEnvelope"] & {
             /** @description Metadatos de la respuesta y límites efectivos de reintentos. */
             meta?: {
@@ -3745,7 +4363,7 @@ export interface components {
             data?: {
                 /** @enum {string} */
                 type?: "retry_policy";
-                attributes?: components["schemas"]["RetryPolicy"];
+                attributes?: components["schemas"]["SavedRetryPolicy"];
             };
         };
         /** @description Cuerpo de la petición para actualizar la política de reintentos por defecto del usuario (aplica a futuras validaciones). */
@@ -3755,7 +4373,7 @@ export interface components {
         /** @description Estado público del servicio de verificación de Banxico, tal como lo devuelve `GET /v1/status/banxico`. Muestra el estado operativo actual y una explicación legible. */
         BanxicoPublicStatus: {
             /**
-             * @description Estado agregado del servicio de verificación de Banxico — `operational`: Todas las pruebas pasan y la latencia es normal; `degraded`: Problemas parciales (latencia elevada o errores intermitentes); `down`: Servicio inaccesible; `unknown`: Aún no hay datos de salud disponibles.
+             * @description Estado agregado del servicio de verificación de Banxico — `operational`: Todas las pruebas pasan y la latencia es normal; `degraded`: Problemas parciales (latencia elevada o errores intermitentes); `down`: Servicio inaccesible; `unknown`: no hay datos de salud vigentes, porque aún no se ha ejecutado ningún chequeo o porque el último tiene más de tres veces `check_interval_seconds` de antigüedad (el chequeo automático dejó de correr).
              * @example operational
              * @enum {string}
              */
@@ -3771,7 +4389,7 @@ export interface components {
              */
             message: string;
             /**
-             * @description Timestamp del último chequeo de salud ejecutado. `null` cuando aún no se ha ejecutado ningún chequeo.
+             * @description Timestamp del último chequeo de salud ejecutado. `null` cuando aún no se ha ejecutado ningún chequeo. Cuando `status` es `unknown` por un chequeo demasiado viejo, conserva la fecha de ese chequeo: dice desde cuándo no hay dato.
              * @example 2026-04-11T15:30:00Z
              */
             last_verified_at: components["schemas"]["TimestampUTC"] | null;
@@ -3882,7 +4500,7 @@ export interface components {
                  */
                 url: string;
                 /** @description Eventos a los que se suscribe el endpoint webhook. Entre 1 y 10. */
-                events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
+                events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
                 /**
                  * @description Etiqueta libre para distinguir el endpoint webhook de los demás.
                  * @example Alta de pagos en el ERP
@@ -3919,12 +4537,12 @@ export interface components {
         CreateWebhookRequest: {
             /**
              * Format: uri
-             * @description URL receptora del webhook. En producción se rechaza si no usa HTTPS, si resuelve a una dirección privada o si pasa de 2048 caracteres.
+             * @description URL receptora del webhook. Se rechaza si resuelve a una dirección privada o si pasa de 2048 caracteres y, en producción, también si no usa HTTPS.
              * @example https://example.com/webhooks/entregas
              */
             url: string;
             /** @description Eventos a los que se suscribe el endpoint webhook. Entre 1 y 10. */
-            events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
+            events: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
             /**
              * @description Etiqueta libre para distinguir el endpoint webhook de los demás. `null` la omite; más de 255 caracteres responde `422 webhook_description_too_long`.
              * @example Alta de pagos en el ERP
@@ -3935,12 +4553,12 @@ export interface components {
         UpdateWebhookRequest: {
             /**
              * Format: uri
-             * @description Nueva URL receptora del webhook. En producción se rechaza si no usa HTTPS, si no resuelve a una dirección pública o si supera 2048 caracteres.
+             * @description Nueva URL receptora del webhook. Se rechaza si no resuelve a una dirección pública o si supera 2048 caracteres y, en producción, también si no usa HTTPS.
              * @example https://example.com/webhooks/entregas
              */
             url?: string;
             /** @description Nuevos eventos a los que se suscribe el endpoint webhook. Sustituyen a la lista anterior. Entre 1 y 10. */
-            events?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
+            events?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming")[];
             /**
              * @description Nueva etiqueta libre para distinguir el endpoint webhook de los demás. `null` la elimina; más de 255 caracteres responde `422 webhook_description_too_long`.
              * @example Alta de pagos en el ERP
@@ -4007,7 +4625,7 @@ export interface components {
                  * @example validation.completed
                  * @enum {string}
                  */
-                event_type: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                event_type: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
                 /**
                  * Format: uuid
                  * @description Identificador único de la validación (UUID v4) asociada cuando el evento es `validation.*`. `null` cuando el evento es otro.
@@ -4272,13 +4890,13 @@ export interface components {
              */
             remaining: number;
             /**
-             * @description Porcentaje del límite consumido en el ciclo actual, redondeado a 2 decimales.
+             * @description Porcentaje del límite consumido en el ciclo actual, redondeado a 2 decimales. Puede pasar de 100 si hay excedente.
              * @example 70.5
              */
             used_percent: number;
             /**
              * @description Nivel de alerta según el consumo: `ok` (<70 %), `warn` (70–89 %), `danger` (≥90 % o cuota agotada).
-             * @example ok
+             * @example warn
              * @enum {string}
              */
             tone: "ok" | "warn" | "danger";
@@ -4391,10 +5009,30 @@ export interface components {
                 type?: "usage_limits";
                 /** @description Datos de los límites: los límites por contexto y sus notas. */
                 attributes?: {
-                    /** @description Límites de tasa por contexto. Cada entrada trae sólo los que ese contexto aplica: `api` lleva `ip_per_minute`; `login`, los cuatro. */
+                    /** @description Límites de tasa por contexto. Cada entrada trae sólo los que ese contexto aplica: `api` lleva `key_per_minute`, `ip_ceiling_per_minute` e `ip_per_minute`; `webhooks`, `host_per_minute` y `host_global_per_minute`; `login`, los cuatro de IP y correo electrónico. `key_per_minute` y `host_per_minute` los fija el plan de la cuenta. */
                     rate_limits?: {
                         [key: string]: {
-                            /** @description Cantidad máxima de peticiones por dirección IP por minuto. */
+                            /**
+                             * @description Peticiones por minuto de una clave de la cuenta en la API, según su plan. Rige a las peticiones autenticadas.
+                             * @example 240
+                             */
+                            key_per_minute?: number;
+                            /**
+                             * @description Techo de peticiones por minuto por dirección IP para las peticiones autenticadas, todas las claves de un mismo origen juntas.
+                             * @example 1200
+                             */
+                            ip_ceiling_per_minute?: number;
+                            /**
+                             * @description Entregas de webhook por minuto que la cuenta puede enviar hacia un mismo host destino, según su plan.
+                             * @example 60
+                             */
+                            host_per_minute?: number;
+                            /**
+                             * @description Tope de entregas de webhook por minuto hacia un mismo host destino, todos los clientes juntos.
+                             * @example 600
+                             */
+                            host_global_per_minute?: number;
+                            /** @description Cantidad máxima de peticiones por dirección IP por minuto. En `api` sólo rige a las peticiones anónimas, sin clave. */
                             ip_per_minute?: number;
                             /** @description Cantidad máxima de peticiones por dirección IP por hora. */
                             ip_per_hour?: number;
@@ -4432,12 +5070,12 @@ export interface components {
                 /** @description Lista de celdas del mapa; cada entrada es una combinación de `day_of_week` y `hour_of_day` con su conteo. */
                 buckets?: {
                     /**
-                     * @description Día de la semana (0 = domingo … 6 = sábado).
+                     * @description Día de la semana en UTC (0 = domingo … 6 = sábado).
                      * @example 0
                      */
                     day_of_week?: number;
                     /**
-                     * @description Hora del día (0–23), hora del servidor.
+                     * @description Hora del día (0–23), en UTC.
                      * @example 0
                      */
                     hour_of_day?: number;
@@ -4632,22 +5270,20 @@ export interface components {
                  */
                 month?: string;
                 /**
-                 * Format: date-time
-                 * @description Inicio del mes en UTC (ISO 8601).
-                 * @example 2026-04-01T06:00:00Z
+                 * @description Inicio del mes en UTC, con formato `YYYY-MM-DD HH:MM:SS`.
+                 * @example 2026-04-01 06:00:00
                  */
                 from_utc?: string;
                 /**
-                 * Format: date-time
-                 * @description Fin del mes en UTC (ISO 8601, exclusivo).
-                 * @example 2026-05-01T06:00:00Z
+                 * @description Fin del mes en UTC (exclusivo), con formato `YYYY-MM-DD HH:MM:SS`.
+                 * @example 2026-05-01 06:00:00
                  */
                 to_utc?: string;
             };
             /** @description Conteos de validaciones por veredicto, más retiros mediante borrado lógico del periodo (informativo). */
             counts?: {
                 /**
-                 * @description Cantidad de validaciones completadas en el periodo (excluyendo las validaciones con estado `pending`).
+                 * @description Cantidad de validaciones del periodo, incluidas las que tienen estado `pending`.
                  * @example 287
                  */
                 total?: number;
@@ -4736,7 +5372,7 @@ export interface components {
                 verified_share_pct?: number;
             };
             /**
-             * @description Tasa de éxito: porcentaje de validaciones con resultado `valid` sobre el total completado, expresado de 0 a 100.
+             * @description Tasa de éxito: porcentaje de validaciones con resultado `valid` sobre `counts.total`, expresado de 0 a 100.
              * @example 79.4
              */
             success_rate?: number;
@@ -4891,9 +5527,20 @@ export interface components {
                  * @description Nombres de las columnas para formato CSV (en el mismo orden que las filas en `rows`).
                  * @example [
                  *       "Fecha",
-                 *       "Monto",
+                 *       "Folio plataforma",
+                 *       "Tipo",
                  *       "Clave de rastreo",
-                 *       "Estado"
+                 *       "Fecha operación",
+                 *       "Monto",
+                 *       "Banco emisor",
+                 *       "CLABE emisora",
+                 *       "Banco receptor",
+                 *       "CLABE receptora",
+                 *       "Beneficiario",
+                 *       "Veredicto Banxico",
+                 *       "CEP disponible",
+                 *       "Folio CEP",
+                 *       "Tiempo (ms)"
                  *     ]
                  */
                 headers?: string[];
@@ -4901,10 +5548,21 @@ export interface components {
                  * @description Primeras 20 filas (máximo) de datos del reporte.
                  * @example [
                  *       [
+                 *         "2026-04-15 10:32:00",
+                 *         "c3d4e5f6-a7b8-9012-cdef-123456789012",
+                 *         "direct",
+                 *         "MXBA20260415001234",
                  *         "2026-04-15",
                  *         "15000.50",
-                 *         "MXBA20260415001234",
-                 *         "valid"
+                 *         "BBVA MEXICO",
+                 *         "012180001234567891",
+                 *         "BANORTE",
+                 *         "072180009876543210",
+                 *         "Comercializadora Ejemplo SA de CV",
+                 *         "valid",
+                 *         "Sí",
+                 *         "",
+                 *         "412"
                  *       ]
                  *     ]
                  */
@@ -4924,7 +5582,7 @@ export interface components {
             plan_slug?: string;
             /**
              * @description Nombre del plan que muestran las interfaces.
-             * @example Pro
+             * @example Personal
              */
             plan_name?: string;
             /**
@@ -5051,17 +5709,59 @@ export interface components {
         BillingSubscriptionQuotaMeta: {
             /**
              * @description Identificador único y legible del plan. Coincide con `data.attributes.plan_slug`.
-             * @example pro
+             * @example personal
+             */
+            plan_slug?: string;
+            /**
+             * @description Nombre del plan que muestran las interfaces.
+             * @example Personal
+             */
+            plan_name?: string;
+            /**
+             * @description Modelo de facturación del plan — `free`: Sin cobro; `tiered`: Cuota fija; `metered`: Cobro por consumo; `hybrid`: Cuota fija más consumo.
+             * @example hybrid
+             * @enum {string}
+             */
+            billing_model?: "free" | "tiered" | "metered" | "hybrid";
+            /**
+             * @description Origen de la suscripción — `stripe`: Pago mediante Stripe; `admin_granted`: Concesión administrativa; `system_default`: Plan asignado por el sistema.
+             * @example stripe
+             * @enum {string}
              */
-            plan?: string;
+            source?: "stripe" | "admin_granted" | "system_default";
+            /**
+             * @description `true` cuando el usuario aceptó cobro por excedente en un plan `hybrid`. En ese caso, `effective_limit` salta de `included_validations` a `monthly_validation_limit`.
+             * @example false
+             */
+            overage_enabled?: boolean;
+            /**
+             * @description `true` cuando el plan es `hybrid` y el cobro por excedente todavía no está activo: el usuario puede activarlo.
+             * @example false
+             */
+            overage_available?: boolean;
+            /**
+             * @description Límite del ciclo fijado por un administrador para esta suscripción. Cuando existe, manda sobre el del plan. `null` sin ajuste.
+             * @example null
+             */
+            monthly_limit_override?: number | null;
+            /**
+             * @description Validaciones incluidas en la cuota base antes del cobro por excedentes. `null` cuando el plan no tiene cuota base.
+             * @example 500
+             */
+            included_validations?: number | null;
+            /**
+             * @description Tope de validaciones por ciclo de la suscripción. `0` no permite validaciones. En planes `hybrid`, es el tope duro cuando `overage_enabled` es `true`; cuando es `false`, `effective_limit` usa `included_validations`. En los demás modelos, es el límite efectivo salvo que exista un ajuste administrativo.
+             * @example 10000
+             */
+            monthly_validation_limit?: number;
             /**
              * @description Validaciones consumidas en el ciclo actual.
-             * @example 420
+             * @example 220
              */
             used?: number;
             /**
-             * @description Límite efectivo de validaciones para el ciclo actual. Tiene el mismo valor que `data.attributes.effective_limit`.
-             * @example 500
+             * @description Límite efectivo de validaciones para el ciclo actual. Tiene el mismo valor que `data.attributes.effective_limit`, salvo con `quota_kind=trial`: entonces es la asignación de prueba.
+             * @example 300
              */
             limit?: number;
             /**
@@ -5119,7 +5819,31 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "1a2b3c4d5e6f"
+                 *         "request_id": "1a2b3c4d5e6ff6e5d4c3b2a1"
+                 *       }
+                 *     }
+                 */
+                "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
+        /** @description El cuerpo de la petición llegó vacío cuando la operación necesita datos (`body_empty`). */
+        BodyEmpty: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                /**
+                 * @example {
+                 *       "errors": [
+                 *         {
+                 *           "status": "400",
+                 *           "code": "body_empty",
+                 *           "detail": "El cuerpo de la petición está vacío."
+                 *         }
+                 *       ],
+                 *       "meta": {
+                 *         "version": "1.51.0",
+                 *         "request_id": "2b3c4d5e6f7aa7f6e5d4c3b2"
                  *       }
                  *     }
                  */
@@ -5143,7 +5867,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "c4d5e6f7a8b9"
+                 *         "request_id": "c4d5e6f7a8b99b8a7f6e5d4c"
                  *       }
                  *     }
                  */
@@ -5155,11 +5879,11 @@ export interface components {
             headers: {
                 /** @description Segundos a esperar antes de reintentar. Coincide con la ventana de rate-limit del endpoint (típicamente 60s para listas, 1-5s para operaciones idempotentes en vuelo). */
                 "Retry-After"?: number;
-                /** @description Límite de solicitudes configurado para este bucket (emitido sólo en 429). */
+                /** @description Límite de solicitudes configurado para este bucket. Se emite en cada 429 y, en la API autenticada, también en las respuestas correctas, donde es el tope por clave del plan de la cuenta. */
                 "X-RateLimit-Limit"?: number;
-                /** @description Solicitudes restantes en la ventana actual — siempre 0 en el momento del 429 (emitido sólo en 429). */
+                /** @description Solicitudes restantes en la ventana actual. Siempre 0 en el momento del 429; en una respuesta correcta de la API autenticada es lo que queda del tope por clave. */
                 "X-RateLimit-Remaining"?: number;
-                /** @description Unix epoch absoluto (segundos) en que se reinicia la ventana. Emitido sólo en 429, junto con Retry-After. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`). */
+                /** @description Unix epoch absoluto (segundos) en que se reinicia la ventana. Se emite en cada 429, junto con Retry-After, y en las respuestas correctas de la API autenticada. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`). */
                 "X-RateLimit-Reset"?: number;
                 [name: string]: unknown;
             };
@@ -5175,7 +5899,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "f7a8b9c0d1e2",
+                 *         "request_id": "f7a8b9c0d1e22e1d0c9b8a7f",
                  *         "retry_after": 45
                  *       }
                  *     }
@@ -5221,7 +5945,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "3c4d5e6f7a8b"
+                 *         "request_id": "3c4d5e6f7a8bb8a7f6e5d4c3"
                  *       }
                  *     }
                  */
@@ -5247,7 +5971,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "2b3c4d5e6f7a"
+                 *         "request_id": "2b3c4d5e6f7aa7f6e5d4c3b2"
                  *       }
                  *     }
                  */
@@ -5274,13 +5998,37 @@ export interface components {
                  *       "errors": [
                  *         {
                  *           "status": "403",
-                 *           "code": "forbidden",
+                 *           "code": "permission_denied",
                  *           "detail": "No tienes permiso para acceder a este recurso."
                  *         }
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "d5e6f7a8b9c0"
+                 *         "request_id": "d5e6f7a8b9c00c9b8a7f6e5d"
+                 *       }
+                 *     }
+                 */
+                "application/json": components["schemas"]["ErrorResponse"];
+            };
+        };
+        /** @description La validación se purgó y este recurso ya no existe (`validation_purged`). */
+        ValidationPurged: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                /**
+                 * @example {
+                 *       "errors": [
+                 *         {
+                 *           "status": "410",
+                 *           "code": "validation_purged",
+                 *           "detail": "La validación se purgó y este recurso ya no existe."
+                 *         }
+                 *       ],
+                 *       "meta": {
+                 *         "version": "1.61.0",
+                 *         "request_id": "1a2b3c4d5e6ff6e5d4c3b2a1"
                  *       }
                  *     }
                  */
@@ -5316,7 +6064,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "e6f7a8b9c0d1"
+                 *         "request_id": "e6f7a8b9c0d11d0c9b8a7f6e"
                  *       }
                  *     }
                  */
@@ -5340,7 +6088,7 @@ export interface components {
                  *       ],
                  *       "meta": {
                  *         "version": "1.51.0",
-                 *         "request_id": "d5e6f7a8b9c1"
+                 *         "request_id": "d5e6f7a8b9c11c9b8a7f6e5d"
                  *       }
                  *     }
                  */
@@ -5355,7 +6103,7 @@ export interface components {
         AsyncQueryParam: "0" | "1" | "true" | "false" | "yes";
         /** @description Identificador (UUID) de la validación */
         ValidationId: string;
-        /** @description **ETag** recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. */
+        /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
         IfNoneMatchHeader: string;
     };
     requestBodies: never;
@@ -5430,7 +6178,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             409: components["responses"]["IdempotencyKeyInProgress"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description Falló la validación de la petición. Códigos típicos: `clave_or_ref_required`, `required` (fecha/monto), `invalid_date`, `invalid_amount`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `invalid_bank_code` (`emisor`/`receptor` no reconocidos), `intra_bank_no_cep` (emisor y receptor son el mismo banco), `invalid_field_type` (un campo que debe ser texto llegó como arreglo u objeto — p. ej. `emisor`, `receptor` o `referencia_numerica`), `invalid_receptor_participante`, `retry_policy_invalid`, `retry_pending_cap_exceeded`. También se emite cuando se reutiliza `Idempotency-Key` con un cuerpo distinto (`idempotency_key_reused`). Cuando los datos se contradicen entre sí, la petición se rechaza antes de consultar a Banxico con `preflight_failed` y el detalle por campo en `errors` (`clabe_receptor_mismatch` y `tarjeta_receptor_mismatch`: la cuenta pertenece a otro banco que el `receptor`; `cuenta_invalid_luhn`; `clave_fecha_incoherente`; `clave_longitud_invalida`). También se rechaza con `preflight_failed` cuando falta `cuenta_beneficiaria` (`cuenta_required`). Ningún rechazo `preflight_failed` de esta ruta consume cuota, sea por datos que se contradicen, por un campo mal formado o por una cuenta ausente. */
+            /** @description Falló la validación de la petición. Códigos típicos: `clave_or_ref_required`, `required` (fecha/monto), `invalid_date`, `invalid_amount`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `invalid_bank_code` (`emisor`/`receptor` no reconocidos), `intra_bank_no_cep` (emisor y receptor son el mismo banco), `invalid_field_type` (un campo que debe ser texto llegó como arreglo u objeto — p. ej. `emisor`, `receptor` o `referencia_numerica`), `invalid_receptor_participante`, `retry_policy_invalid`, `retry_pending_cap_exceeded`, `cuenta_y_candidatas_excluyentes` (`cuenta_beneficiaria` y `cuentas_candidatas` juntas), `cuentas_candidatas_invalidas` (la lista no tiene de 2 al máximo vigente de cuentas válidas y distintas) y `cuenta_unresolvable_after_probes` (ninguna candidata coincidió con la transferencia). También se emite cuando se reutiliza `Idempotency-Key` con un cuerpo distinto (`idempotency_key_reused`). Cuando los datos se contradicen entre sí, la petición se rechaza antes de consultar a Banxico con `preflight_failed` y el detalle por campo en `errors` (`clabe_receptor_mismatch` y `tarjeta_receptor_mismatch`: la cuenta pertenece a otro banco que el `receptor`; `cuenta_invalid_luhn`; `clave_fecha_incoherente`; `clave_longitud_invalida`). También se rechaza con `preflight_failed` cuando falta `cuenta_beneficiaria` (`cuenta_required`). Ningún rechazo `preflight_failed` de esta ruta consume cuota, sea por datos que se contradicen, por un campo mal formado o por una cuenta ausente. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -5488,7 +6236,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             409: components["responses"]["IdempotencyKeyInProgress"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description La imagen o los datos de la petición no son válidos. Códigos posibles: `image_or_image_url_required`, `invalid_image`, `invalid_image_format`, `image_too_large`, `invalid_url`, `invalid_url_scheme`, `url_ssrf_blocked`, `invalid_clabe_checksum`. También puede devolver: `image_too_small`, `image_mime_mismatch`, `image_dimensions_too_large`, `image_decompression_bomb`, `image_polyglot_detected`, `image_url_unreachable`, `image_url_too_large`, `image_url_too_many_redirects`. Con un PDF: `pdf_invalid_structure`, `pdf_encrypted`, `pdf_active_content`, `pdf_hidden_content`, `pdf_modified_after_issue`, `pdf_too_many_pages`, `pdf_unsupported_image`, `pdf_text_layer_too_large` y `pdf_multiple_receipts`. En modo asíncrono, un fallo genérico de la imagen se reporta como `image_invalid`. Reutilizar `Idempotency-Key` con un cuerpo distinto produce `idempotency_key_reused`. */
+            /** @description La imagen o los datos de la petición no son válidos. Códigos posibles: `image_or_image_url_required`, `invalid_image`, `invalid_image_format`, `image_too_large`, `invalid_url`, `invalid_url_scheme`, `url_ssrf_blocked`, `invalid_clabe_checksum`. También puede devolver: `image_too_small`, `image_mime_mismatch`, `image_dimensions_too_large`, `image_decompression_bomb`, `image_polyglot_detected`, `image_url_unreachable`, `image_url_too_large`, `image_url_too_many_redirects`. Con un PDF: `pdf_invalid_structure`, `pdf_encrypted`, `pdf_active_content`, `pdf_hidden_content`, `pdf_modified_after_issue`, `pdf_too_many_pages`, `pdf_unsupported_image`, `pdf_text_layer_too_large` y `pdf_multiple_receipts`. Con `retain_image` que no es booleano: `invalid_retain_image`. Con `cuentas_candidatas`: `cuenta_y_candidatas_excluyentes`, `cuentas_candidatas_invalidas` y, si ninguna candidata coincide, `cuenta_unresolvable_after_probes`. En modo asíncrono, un fallo genérico de la imagen se reporta como `image_invalid`. Reutilizar `Idempotency-Key` con un cuerpo distinto produce `idempotency_key_reused`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -5572,6 +6320,11 @@ export interface operations {
                  * @example 012
                  */
                 bank?: string;
+                /**
+                 * @description Filtro — Varias claves SPEI separadas por coma (hasta 50); devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellas. Si un elemento no tiene de 1 a 5 dígitos, responde con estado HTTP `422` e `invalid_filter`. Se combina con `bank`: si mandas los dos, se cumplen ambos.
+                 * @example 40012,40014,40072
+                 */
+                banks?: string;
                 /**
                  * @description Filtro — Importe mínimo inclusivo, como número. El servidor también tolera enviarlo como texto con separador de miles o símbolo de moneda ("1,000.50", "$500") y lo normaliza con el mismo algoritmo que el resto de la plataforma, pero el contrato es un número: un cliente tipado debe mandarlo así. Un valor no vacío que no se reconozca como número devuelve un estado HTTP `422` con `invalid_filter`, en vez de ignorarse en silencio. Se aplica de forma independiente de `amount_max`.
                  * @example 1000.5
@@ -5677,6 +6430,11 @@ export interface operations {
                  * @example 012
                  */
                 bank?: string;
+                /**
+                 * @description Filtro — Varias claves SPEI separadas por coma (hasta 50); devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellas. Si un elemento no tiene de 1 a 5 dígitos, responde con estado HTTP `422` e `invalid_filter`. Se combina con `bank`: si mandas los dos, se cumplen ambos.
+                 * @example 40012,40014,40072
+                 */
+                banks?: string;
                 /**
                  * @description Filtro — Importe mínimo inclusivo de las validaciones contadas.
                  * @example 1000.5
@@ -5790,6 +6548,11 @@ export interface operations {
                  * @example 012
                  */
                 bank?: string;
+                /**
+                 * @description Filtro — Varias claves SPEI separadas por coma (hasta 50); devuelve las validaciones cuyo banco emisor o receptor sea cualquiera de ellas. Si un elemento no tiene de 1 a 5 dígitos, responde con estado HTTP `422` e `invalid_filter`. Se combina con `bank`: si mandas los dos, se cumplen ambos.
+                 * @example 40012,40014,40072
+                 */
+                banks?: string;
                 /**
                  * @description Filtro — Importe mínimo inclusivo. Se aplica de forma independiente de `amount_max`.
                  * @example 1000.5
@@ -5840,7 +6603,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: {
-                /** @description **ETag** recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. */
+                /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
                 "If-None-Match"?: components["parameters"]["IfNoneMatchHeader"];
             };
             path: {
@@ -5971,7 +6734,7 @@ export interface operations {
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Validación no encontrada (`not_found`) o el CEP no está disponible para esta validación (`cep_not_available`). Este último código se devuelve cuando `banxico_status` no es `valid` o falta el archivo solicitado. */
+            /** @description Validación no encontrada (`not_found`) o el CEP no está disponible para esta validación (`cep_not_available`). Este último código se devuelve cuando `banxico_status` no es `valid` ni `returned` o falta el archivo solicitado. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -5980,6 +6743,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            410: components["responses"]["ValidationPurged"];
             /** @description UUID inválido en la ruta (`invalid_uuid`). */
             422: {
                 headers: {
@@ -6046,6 +6810,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            410: components["responses"]["ValidationPurged"];
             /** @description UUID inválido en la ruta (`invalid_uuid`). */
             422: {
                 headers: {
@@ -6112,6 +6877,15 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description La imagen no existe por decisión del cliente: la validación se creó con `retain_image=false` (`image_not_retained`) o se purgó (`validation_purged`). */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description UUID inválido en la ruta (`invalid_uuid`). */
             422: {
                 headers: {
@@ -6157,6 +6931,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            410: components["responses"]["ValidationPurged"];
             /** @description UUID inválido en la ruta (`invalid_uuid`). */
             422: {
                 headers: {
@@ -6227,6 +7002,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            410: components["responses"]["ValidationPurged"];
             413: components["responses"]["PayloadTooLarge"];
             /** @description Política inválida o precondición no cumplida. `retry_policy_invalid`, la forma, el rango o el resultado no se admiten; `retry_not_supported_for_bulk`, la validación nació de una importación; `retry_not_applicable`, su estado queda fuera de los tres que admiten reintento (`not_found`, `cep_unavailable`, `error`) o cambió mientras tanto; `retry_already_resolved`, el ciclo ya cerró; `retry_age_exceeded`, la validación es más vieja que `max_age_seconds`; `retry_pending_cap_exceeded`, se alcanzó el tope de pendientes de la cuenta de usuario o el de despachados en 24 horas; `reactivation_cap_exceeded`, se alcanzó el tope de reactivaciones de esa validación. */
             422: {
@@ -6285,6 +7061,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            410: components["responses"]["ValidationPurged"];
             /** @description No hay ciclo de reintentos activo que cancelar (código `retry_not_active`). UUID inválido (`invalid_uuid`). */
             422: {
                 headers: {
@@ -6296,11 +7073,203 @@ export interface operations {
             };
         };
     };
+    recheckValidation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Identificador (UUID) de la validación */
+                id: components["parameters"]["ValidationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Estado de pago consultado. Devuelve la validación y, en `meta.recheck`, cuándo se consultó, si cambió a `returned` y qué veredicto tenía antes. */
+            200: {
+                headers: {
+                    /** @description ETag débil de la validación después de la consulta. Sigue el formato `W/"{etag_version}-{status}"` y sube en cada consulta, aunque el veredicto no cambie. */
+                    ETag?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessEnvelope"] & {
+                        data?: components["schemas"]["Validation"];
+                        meta?: {
+                            recheck?: components["schemas"]["ValidationRecheckMeta"];
+                        };
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Validación no encontrada, retirada o ajena a la cuenta de usuario (`not_found`). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            410: components["responses"]["ValidationPurged"];
+            /** @description La validación no se puede consultar: su estado no es `valid` ni `returned` (código `recheck_not_eligible`, con el estado en `meta.status`) o tiene más horas que la ventana (código `recheck_window_expired`, con la ventana en `meta.window_hours`). UUID inválido (`invalid_uuid`). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description La validación se consultó hace menos de 10 minutos (código `recheck_rate_limited`). `Retry-After` y `meta.retry_after` dan los segundos que faltan. También responde así el límite de peticiones de la clave de API (`rate_limit_exceeded`). */
+            429: {
+                headers: {
+                    /** @description Segundos que faltan para poder consultar esta validación de nuevo. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Banxico no entregó un estado legible, o la consulta de estado está apagada (código `recheck_unavailable`). La validación no cambia y conserva su intervalo. `Retry-After` y `meta.retry_after` sugieren esperar 60 segundos. */
+            503: {
+                headers: {
+                    /** @description Segundos que se sugiere esperar antes de reintentar. */
+                    "Retry-After"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    prepareValidationPurge: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Identificador (UUID) de la validación */
+                id: components["parameters"]["ValidationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Resumen de lo que se borraría y token de confirmación. La validación no cambió. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessEnvelope"] & components["schemas"]["ValidationPurgePrepareResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Validación no encontrada, o ajena a la cuenta de usuario (`not_found`). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description La validación sigue en curso (`queued` o `processing`) y todavía no se puede purgar (`purge_validation_in_progress`, con el estado en `meta.status`). */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            410: components["responses"]["ValidationPurged"];
+            /** @description UUID inválido en la ruta (`invalid_uuid`). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["RateLimited"];
+        };
+    };
+    executeValidationPurge: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Identificador (UUID) de la validación */
+                id: components["parameters"]["ValidationId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "confirmation_token": "eyJhZG1pbl9pZCI6Ii4uLiJ9.q1w2e3r4t5y6u7i8o9p0"
+                 *     }
+                 */
+                "application/json": components["schemas"]["ValidationPurgeExecuteRequest"];
+            };
+        };
+        responses: {
+            /** @description Validación purgada. Devuelve cuándo se purgó, el estado del borrado de los archivos y lo que se borró. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuccessEnvelope"] & components["schemas"]["ValidationPurgeExecuteResponse"];
+                };
+            };
+            400: components["responses"]["BodyEmpty"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Validación no encontrada, o ajena a la cuenta de usuario (`not_found`). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description El token ya se usó (`confirmation_token_already_used`), o la validación sigue en curso y todavía no se puede purgar (`purge_validation_in_progress`, con el estado en `meta.status`). */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            410: components["responses"]["ValidationPurged"];
+            413: components["responses"]["PayloadTooLarge"];
+            /** @description El token no sirve. Códigos posibles: `confirmation_token_missing`, `confirmation_token_malformed`, `confirmation_token_signature_invalid`, `confirmation_token_expired`, `confirmation_token_operation_mismatch` y `purge_token_mismatch` (el token es de otra validación o de otra cuenta). UUID inválido en la ruta (`invalid_uuid`). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["RateLimited"];
+        };
+    };
     listBanks: {
         parameters: {
             query?: never;
             header?: {
-                /** @description **ETag** recibido en peticiones anteriores. Si los datos no han cambiado y el `etag_version` sigue igual, el server responde `304 Not Modified` (sin cuerpo) — evita recibir los datos de nuevo cuando el estado del recurso NO ha cambiado. */
+                /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
                 "If-None-Match"?: components["parameters"]["IfNoneMatchHeader"];
             };
             path?: never;
@@ -6363,6 +7332,109 @@ export interface operations {
             429: components["responses"]["RateLimited"];
         };
     };
+    getSpeiCalendar: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description **ETag** recibido en una respuesta anterior, tal cual (débil `W/"…"` en una validación, fuerte en los catálogos públicos). Si el recurso no ha cambiado, el server responde `304 Not Modified` (sin cuerpo) y evita mandar los datos de nuevo. */
+                "If-None-Match"?: components["parameters"]["IfNoneMatchHeader"];
+            };
+            path: {
+                /**
+                 * @description Año del calendario, de cuatro dígitos.
+                 * @example 2026
+                 */
+                year: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Calendario de días inhábiles SPEI del año, con su fuente. */
+            200: {
+                headers: {
+                    /** @description Firma del calendario actual. Pasar como `If-None-Match` en peticiones posteriores. */
+                    ETag?: string;
+                    /** @description TTL de caché en el cliente (1 h). */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SpeiCalendarResponse"];
+                };
+            };
+            /** @description No modificado: el calendario no ha cambiado según el ETag enviado. */
+            304: {
+                headers: {
+                    /** @description ETag actual del calendario. */
+                    ETag?: string;
+                    /** @description TTL de caché en el cliente (1 h). */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description El año no tiene calendario (código `spei_calendar_year_not_covered`). `meta.covered_years` lista los años disponibles. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "errors": [
+                     *         {
+                     *           "status": "404",
+                     *           "code": "spei_calendar_year_not_covered",
+                     *           "detail": "No tenemos el calendario de 2030. Los años disponibles van de 2024 a 2026."
+                     *         }
+                     *       ],
+                     *       "meta": {
+                     *         "version": "1.63.0",
+                     *         "request_id": "c1d2e3f4a5b66b5a4f3e2d1c",
+                     *         "covered_years": [
+                     *           2024,
+                     *           2025,
+                     *           2026
+                     *         ]
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"] & {
+                        meta?: {
+                            /** @description Años con calendario publicado, de menor a mayor. */
+                            covered_years?: number[];
+                        };
+                    };
+                };
+            };
+            /** @description El año no tiene cuatro dígitos (código `spei_calendar_year_invalid`). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "errors": [
+                     *         {
+                     *           "status": "422",
+                     *           "code": "spei_calendar_year_invalid",
+                     *           "detail": "El año debe tener cuatro dígitos, por ejemplo 2026."
+                     *         }
+                     *       ],
+                     *       "meta": {
+                     *         "version": "1.63.0",
+                     *         "request_id": "d2e3f4a5b6c77c6b5a4f3e2d"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            429: components["responses"]["RateLimited"];
+        };
+    };
     exportBeneficiaries: {
         parameters: {
             query?: {
@@ -6461,7 +7533,6 @@ export interface operations {
                      *         "attributes": {
                      *           "account_number": "012180004412345678",
                      *           "account_type": "clabe",
-                     *           "clabe": "012180004412345678",
                      *           "bank_code": "40012",
                      *           "bank_name": "BBVA MEXICO",
                      *           "label": "Proveedor ABC",
@@ -6501,7 +7572,7 @@ export interface operations {
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description La cuenta no pasó la validación, o el alta chocó con un tope. Los códigos posibles son `account_number_required`, `account_number_invalid_type`, `label_invalid_type`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `beneficiary_already_registered` y `plan_cap_exceeded`. `account_number_invalid_type` y `label_invalid_type` aparecen cuando el campo llega con un tipo distinto de cadena de texto. Todo error de campo trae `source.pointer`. */
+            /** @description La cuenta no pasó la validación, o el alta chocó con un tope. Los códigos posibles son `account_number_required`, `account_number_invalid_type`, `label_invalid_type`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `invalid_bank_code`, `max_length_exceeded`, `beneficiary_already_registered` y `plan_cap_exceeded`. `account_number_invalid_type` y `label_invalid_type` aparecen cuando el campo llega con un tipo distinto de cadena de texto. Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6545,7 +7616,6 @@ export interface operations {
                      *         "attributes": {
                      *           "account_number": "5512345678",
                      *           "account_type": "phone",
-                     *           "clabe": "5512345678",
                      *           "bank_code": "40021",
                      *           "bank_name": "HSBC",
                      *           "label": "Cuenta DiMo HSBC",
@@ -6576,7 +7646,7 @@ export interface operations {
             403: components["responses"]["Forbidden"];
             404: components["responses"]["NotFound"];
             413: components["responses"]["PayloadTooLarge"];
-            /** @description El cuerpo no pasó la validación. Los códigos posibles son `no_valid_fields`, `invalid_account_length`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `account_number_invalid_type` y `label_invalid_type`. Las dos últimas aparecen cuando `account_number` o `label` llegan con un tipo distinto de cadena de texto (por ejemplo, un número o un arreglo). Todo error de campo trae `source.pointer`. */
+            /** @description El cuerpo no pasó la validación. Los códigos posibles son `no_valid_fields`, `invalid_account_format`, `invalid_account_length`, `invalid_clabe_checksum`, `invalid_card_luhn`, `clabe_prefix_not_recognized`, `bank_code_required_for_phone`, `invalid_bank_code`, `max_length_exceeded`, `beneficiary_already_registered`, `account_number_invalid_type` y `label_invalid_type`. Las dos últimas aparecen cuando `account_number` o `label` llegan con un tipo distinto de cadena de texto (por ejemplo, un número o un arreglo). Todo error de campo trae `source.pointer`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6667,7 +7737,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "b2c3d4e5f6a7"
+                     *         "request_id": "b2c3d4e5f6a77a6f5e4d3c2b"
                      *       }
                      *     }
                      */
@@ -6724,7 +7794,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "c5d6e7f8a9b0"
+                     *         "request_id": "c5d6e7f8a9b00b9a8f7e6d5c"
                      *       }
                      *     }
                      */
@@ -6764,7 +7834,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "e1f2a3b4c5d6"
+                     *         "request_id": "e1f2a3b4c5d66d5c4b3a2f1e"
                      *       }
                      *     }
                      */
@@ -6773,7 +7843,7 @@ export interface operations {
             };
             401: components["responses"]["Unauthorized"];
             403: components["responses"]["Forbidden"];
-            /** @description Falló la validación o la pre-condición. Códigos posibles: `file_required`, `file_too_large`, `unsupported_format` e `import_already_in_flight`. */
+            /** @description Falló la validación o la pre-condición. Códigos posibles: `file_required`, `upload_error`, `file_too_large`, `invalid_parse_mode`, `unsupported_format`, `import_already_in_flight` y `persist_failed`. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6791,7 +7861,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "f2a3b4c5d6e7"
+                     *         "request_id": "f2a3b4c5d6e77e6d5c4b3a2f"
                      *       }
                      *     }
                      */
@@ -6871,7 +7941,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "f8a9b0c1d2e3"
+                     *         "request_id": "f8a9b0c1d2e33e2d1c0b9a8f"
                      *       }
                      *     }
                      */
@@ -7011,10 +8081,10 @@ export interface operations {
                      *           "parsed_account_type": "phone",
                      *           "parsed_bank_code": "40012",
                      *           "parsed_bank_name": "BBVA MEXICO",
-                     *           "parsed_label": null,
+                     *           "parsed_label": "Cuenta",
                      *           "error_codes": [],
                      *           "corrections_applied": {
-                     *             "alias_auto_assigned": "Beneficiario 002"
+                     *             "alias_auto_assigned": "Cuenta"
                      *           },
                      *           "user_overrides": {
                      *             "parsed_account_type": "phone",
@@ -7031,7 +8101,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "c1d2e3f4a5b6"
+                     *         "request_id": "c1d2e3f4a5b66b5a4f3e2d1c"
                      *       }
                      *     }
                      */
@@ -7095,7 +8165,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "f4a5b6c7d8e9"
+                     *         "request_id": "f4a5b6c7d8e99e8d7c6b5a4f"
                      *       }
                      *     }
                      */
@@ -7123,7 +8193,7 @@ export interface operations {
                      *       "meta": {
                      *         "version": "1.47.0",
                      *         "api_version": "v1",
-                     *         "request_id": "a5b6c7d8e9f0"
+                     *         "request_id": "a5b6c7d8e9f00f9e8d7c6b5a"
                      *       }
                      *     }
                      */
@@ -7750,21 +8820,65 @@ export interface operations {
                  */
                 per_page?: number;
                 /**
-                 * @description Filtro — Identificador único del endpoint webhook (UUID v4).
-                 * @example 7c9e6679-7425-40de-944b-e07fc1f90ae7
+                 * @description Filtro — Identificador único del endpoint webhook (UUID v4). Hasta 20, separados por comas.
+                 * @example [
+                 *       "7c9e6679-7425-40de-944b-e07fc1f90ae7"
+                 *     ]
                  */
-                endpoint_id?: string;
+                endpoint_id?: string[];
                 /**
-                 * @description Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
-                 * @example failed
+                 * @description Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado. Varios estados, separados por comas.
+                 * @example [
+                 *       "failed"
+                 *     ]
                  */
-                status?: "success" | "failed" | "retrying" | "pending";
+                status?: ("success" | "failed" | "retrying" | "pending")[];
                 /**
-                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando termina bien, `validation.failed` cuando termina mal y `validation.error` cuando hay un error del servicio. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP.\
-                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`.
-                 * @example validation.completed
+                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando hay veredicto de Banxico, sea cual sea (también inválida o no encontrada, y aunque se abran reintentos), `validation.failed` cuando la entrada se rechaza y `validation.error` ante cualquier otro fallo. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP. **De la revisión posterior de un `valid`:** `validation.returned` cuando una validación que había salido `valid` pasa a `returned` porque Banxico reportó la devolución.\
+                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`. Varios tipos, separados por comas.
+                 * @example [
+                 *       "validation.completed"
+                 *     ]
+                 */
+                event_type?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test")[];
+                /**
+                 * @description Filtro — Busca en el identificador de la entrega, el identificador, la URL y la descripción del endpoint, el tipo de evento, el identificador de la validación y el código HTTP de la respuesta. No distingue mayúsculas; `%` y `_` se buscan tal cual. Más de 100 caracteres se recortan.
+                 * @example webhook.example.com
+                 */
+                q?: string;
+                /**
+                 * @description Filtro — Sólo las entregas de esta validación (UUID v4).
+                 * @example 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  */
-                event_type?: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                validation_id?: string;
+                /**
+                 * @description Filtro — Código HTTP con que respondió el receptor, separados por comas. Vale un código exacto (`404`), una familia (`2xx`, `4xx`, `5xx`) o `none` para las que no tuvieron respuesta (tiempo agotado, conexión rechazada o todavía sin intentar). Varios valores suman resultados.
+                 * @example [
+                 *       "5xx",
+                 *       "none"
+                 *     ]
+                 */
+                response_status?: string[];
+                /**
+                 * @description Filtro — Entregas creadas desde este momento, incluido. Acepta fecha (`2026-10-01`, medianoche UTC) o fecha y hora ISO 8601 con zona.
+                 * @example 2026-10-01T00:00:00Z
+                 */
+                from?: string;
+                /**
+                 * @description Filtro — Entregas creadas hasta este momento, incluido. Una fecha sola llega al final de ese día en UTC.
+                 * @example 2026-10-15T23:59:59Z
+                 */
+                to?: string;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo número de intento es al menos este. Con `2` quedan las que se reintentaron.
+                 * @example 2
+                 */
+                min_attempt?: number;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo receptor tardó al menos estos milisegundos en responder.
+                 * @example 3000
+                 */
+                min_response_time_ms?: number;
             };
             header?: never;
             path?: never;
@@ -7804,22 +8918,66 @@ export interface operations {
         parameters: {
             query?: {
                 /**
-                 * @description Filtro — Identificador único del endpoint webhook (UUID v4).
-                 * @example 7c9e6679-7425-40de-944b-e07fc1f90ae7
+                 * @description Filtro — Identificador único del endpoint webhook (UUID v4). Hasta 20, separados por comas.
+                 * @example [
+                 *       "7c9e6679-7425-40de-944b-e07fc1f90ae7"
+                 *     ]
                  */
-                endpoint_id?: string;
+                endpoint_id?: string[];
                 /**
                  * @description \
-                 *     Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado.
-                 * @example failed
+                 *     Filtro — Estado de la entrega. `success` llegó. `failed` es el resultado del último intento; Messenger puede programar otro si el fallo es recuperable. `retrying` se pospuso por el límite de salida y Messenger la reintentará. `pending` todavía no se ha intentado. Varios estados, separados por comas.
+                 * @example [
+                 *       "failed"
+                 *     ]
                  */
-                status?: "success" | "failed" | "retrying" | "pending";
+                status?: ("success" | "failed" | "retrying" | "pending")[];
                 /**
-                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando termina bien, `validation.failed` cuando termina mal y `validation.error` cuando hay un error del servicio. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP.\
-                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`.
-                 * @example validation.completed
+                 * @description Filtro — Tipo de evento que originó la entrega. **De validaciones**: `validation.completed` cuando hay veredicto de Banxico, sea cual sea (también inválida o no encontrada, y aunque se abran reintentos), `validation.failed` cuando la entrada se rechaza y `validation.error` ante cualquier otro fallo. **De los reintentos automáticos:** `validation.retry.scheduled` al programar un reintento automático, `validation.retry.resolved` cuando un reintento automático encuentra el CEP, y `validation.retry.exhausted` cuando los reintentos se agotan sin encontrar el CEP. **De la revisión posterior de un `valid`:** `validation.returned` cuando una validación que había salido `valid` pasa a `returned` porque Banxico reportó la devolución.\
+                 *     **De la suscripción:** `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba gratuita, y `billing.subscription_canceled` al cancelar la suscripción. Las entregas sintéticas (envío de prueba) se marcan como `test`. Varios tipos, separados por comas.
+                 * @example [
+                 *       "validation.completed"
+                 *     ]
+                 */
+                event_type?: ("validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "validation.returned" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test")[];
+                /**
+                 * @description Filtro — Busca en el identificador de la entrega, el identificador, la URL y la descripción del endpoint, el tipo de evento, el identificador de la validación y el código HTTP de la respuesta. No distingue mayúsculas; `%` y `_` se buscan tal cual. Más de 100 caracteres se recortan.
+                 * @example webhook.example.com
+                 */
+                q?: string;
+                /**
+                 * @description Filtro — Sólo las entregas de esta validación (UUID v4).
+                 * @example 3fa85f64-5717-4562-b3fc-2c963f66afa6
+                 */
+                validation_id?: string;
+                /**
+                 * @description Filtro — Código HTTP con que respondió el receptor, separados por comas. Vale un código exacto (`404`), una familia (`2xx`, `4xx`, `5xx`) o `none` para las que no tuvieron respuesta (tiempo agotado, conexión rechazada o todavía sin intentar). Varios valores suman resultados.
+                 * @example [
+                 *       "5xx",
+                 *       "none"
+                 *     ]
+                 */
+                response_status?: string[];
+                /**
+                 * @description Filtro — Entregas creadas desde este momento, incluido. Acepta fecha (`2026-10-01`, medianoche UTC) o fecha y hora ISO 8601 con zona.
+                 * @example 2026-10-01T00:00:00Z
+                 */
+                from?: string;
+                /**
+                 * @description Filtro — Entregas creadas hasta este momento, incluido. Una fecha sola llega al final de ese día en UTC.
+                 * @example 2026-10-15T23:59:59Z
+                 */
+                to?: string;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo número de intento es al menos este. Con `2` quedan las que se reintentaron.
+                 * @example 2
+                 */
+                min_attempt?: number;
+                /**
+                 * @description Filtro — Sólo las entregas cuyo receptor tardó al menos estos milisegundos en responder.
+                 * @example 3000
                  */
-                event_type?: "validation.completed" | "validation.failed" | "validation.error" | "validation.retry.scheduled" | "validation.retry.resolved" | "validation.retry.exhausted" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.trial_will_end" | "billing.subscription_canceled" | "billing.invoice_upcoming" | "test";
+                min_response_time_ms?: number;
                 /**
                  * @description Formato del archivo a descargar. Valores aceptados: `csv` y `xlsx`. Cualquier otro valor se sirve como `csv`.
                  * @example csv