{"section":"tutorials","requestedLocale":"es","requestedSlug":"mode-off-faq","locale":"es","slug":"mode-off-faq","path":"docs/es/tutorials/pagos/transacciones/mode-off-faq.md","branch":"main","content":"**Contingency Mode** (antes conocido como **Mode-off**) es una funcionalidad de resiliencia de VTEX Payments que ayuda a proteger transacciones elegibles durante inestabilidades temporales en proveedores de pago.\n\nEste artículo explica:\n\n- [Cómo funciona **Contingency Mode**](#como-funciona-contingency-mode)\n- [El impacto en las transacciones](#impacto-en-las-transacciones)\n- [Qué medios y flujos de pago pueden verse afectados](#medios-de-pago-afectados)\n- [Cómo funcionan la recuperación del conector y los reintentos](#recuperacion-y-comportamiento-de-los-intentos)\n- [Cómo identificar **Contingency Mode**](#como-identificar-contingency-mode)\n- [Qué hacer cuando **Contingency Mode** está activo](#que-hacer-cuando-contingency-mode-esta-activo)\n- [Orientaciones para proveedores de pago](#orientaciones-para-proveedores-de-pago)\n\n> ℹ️ Los comerciantes no necesitan configurar ni activar **Contingency Mode** manualmente. VTEX gestiona automáticamente la activación, la recuperación y los intentos de las transacciones.\n\n## Cómo funciona Contingency Mode\n\n**Contingency Mode** es un mecanismo de protección automática para conectores de pago. Cuando VTEX identifica fallas técnicas recurrentes en un conector, el sistema activa este modo para reducir el impacto de la inestabilidad en el procesamiento de pagos.\n\nDurante este periodo:\n\n- Nuevas autorizaciones elegibles dejan de enviarse temporalmente al proveedor.\n- Nuevas transacciones elegibles pueden posponerse para procesamiento posterior.\n- Las transacciones ya pospuestas siguen un flujo independiente de intentos programados.\n\nEsta protección se aplica al conector afectado, no a la tienda en su conjunto. Otros proveedores de pago o medios de pago que no se vieron afectados por la inestabilidad pueden seguir operando con normalidad.\n\nEl ciclo de activación y recuperación de **Contingency Mode** es independiente del ciclo de intentos de las transacciones pospuestas. Esto significa que un conector puede haber salido de **Contingency Mode** mientras ciertas transacciones aún esperan la siguiente ventana de intento configurada.\n\n### Activación\n\n**Contingency Mode** se activa cuando VTEX detecta 5 errores técnicos calificables en 5 minutos para el mismo conector.\n\nLos errores técnicos calificables pueden incluir:\n\n- Se agotó el tiempo de espera de la solicitud.\n- Fallas de conexión.\n- Solicitudes canceladas por inestabilidad técnica.\n- Respuestas HTTP `408` de tiempo de espera agotado.\n- Errores HTTP `5xx` del proveedor, como `500`, `502`, `503` o `504`.\n\n> ℹ️ Los resultados esperados del proceso de autorización no activan **Contingency Mode**. Por ejemplo, el saldo insuficiente, tarjeta no válida, tarjeta vencida y pago no autorizado forman parte del flujo normal de autorización y no se consideran inestabilidad del conector.\n\n### Ciclo de Contingency Mode\n\nCuando **Contingency Mode** está activo:\n\n- VTEX marca el conector afectado como temporalmente no disponible.\n- Las nuevas solicitudes de autorización elegibles no se envían al proveedor.\n- Las nuevas transacciones elegibles pueden posponerse para un intento posterior.\n- El conector permanece temporalmente no disponible hasta que finaliza el periodo automático de recuperación.\n- Los retailers pueden ver una indicación de **Contingency Mode** en los detalles de la transacción o en los logs de pago.\n\nEste comportamiento ayuda a evitar nuevas llamadas a un conector inestable mientras el proveedor se recupera.\n\nEl siguiente diagrama muestra el ciclo de activación y recuperación de **Contingency Mode** para nuevas autorizaciones:\n\n```mermaid\n%%{init: {'flowchart': {'htmlLabels': true, 'useMaxWidth': false, 'wrappingWidth': 500, 'padding': 14}}}%%\nflowchart LR\n A[\"Nuevo intento
de autorización\"] --> B[\"VTEX inicia el proceso
de autorización\"]\n B --> C{\"¿Conector en
Contingency Mode?\"}\n C -- \"Sí\" --> D[\"Se envía al flujo
de autorización programada\"]\n C -- \"No\" --> E[\"VTEX envía el pago
al conector\"]\n E --> F{\"¿El conector devolvió
un error calificable?\"}\n F -- \"No\" --> G[\"Flujo normal
de autorización\"]\n F -- \"Sí\" --> H[\"El error calificable
se acumula\"]\n H --> I{\"¿5 errores calificables
en los últimos 5 minutos?\"}\n I -- \"Sí\" --> J[\"Se activa Contingency Mode
durante unos 5 minutos\"]\n J --> K[\"Nuevas autorizaciones elegibles
dejan de enviarse al conector\"]\n K --> L[\"Tras unos 5 minutos, se
desactiva Contingency Mode\"]\n L --> M[\"Nuevas autorizaciones vuelven
a evaluarse con normalidad\"]\n```\n\n## Impacto en las transacciones\n\n**Contingency Mode** no cancela pedidos. Las transacciones afectadas por **Contingency Mode** pueden posponerse para un intento automático posterior.\n\n> ℹ️ **Contingency Mode** no sustituye las reglas normales de vencimiento y cancelación del pago. Si el pago no puede autorizarse antes del plazo aplicable, se puede cancelar el pedido según el flujo normal del pedido.\n\nLos clientes pueden ver el pago como en procesamiento o pendiente mientras VTEX espera el siguiente intento de la autorización.\n\nSe debe evitar pedirles a los clientes que realicen un nuevo pedido de inmediato, a menos que el pedido original ya se haya cancelado o que el medio de pago exija una nueva acción del cliente.\n\n## Medios de pago afectados\n\n**Contingency Mode** se aplica a flujos de pago que pueden procesarse de forma asíncrona y volver a intentarse de forma segura tras una inestabilidad temporal en el proveedor.\n\nLos medios o flujos de pago que requieren una respuesta online inmediata, redirección del cliente o una nueva acción del cliente pueden no posponerse ni intentarse de nuevo de la misma manera. En estos casos, la transacción sigue el comportamiento predeterminado de esos medios de pago.\n\n> ℹ️ Si no sabes si un medio de pago específico es elegible para **Contingency Mode**, ponte en contacto con el [Soporte VTEX](https://supporticket.vtex.com/support) o con tu proveedor de pago.\n\n## Recuperación y comportamiento de los intentos\n\nLa recuperación del conector es automática. Tras aproximadamente 5 minutos desde el último error calificable, VTEX remueve **Contingency Mode** del conector y nuevas autorizaciones elegibles pueden volver a enviarse con normalidad al proveedor.\n\nLa salida de **Contingency Mode** solo afecta a los nuevos intentos de autorización. Las transacciones pospuestas previamente siguen su propio flujo de intento programado.\n\n### Intentos de transacciones pospuestas\n\nLas transacciones pospuestas durante **Contingency Mode** no necesariamente se intentan de nuevo inmediatamente después de la recuperación del conector.\n\nEstas transacciones siguen un flujo independiente de intento con base en:\n\n- Las reglas de reintento del medio de pago.\n- El tiempo de cancelación del pago (`delayToCancel`).\n- La información devuelta por el proveedor.\n- Otras condiciones operativas del flujo de pago.\n\nEl siguiente diagrama muestra el comportamiento de las autorizaciones programadas:\n\n```mermaid\n%%{init: {'flowchart': {'htmlLabels': true, 'useMaxWidth': false, 'wrappingWidth': 500, 'padding': 14}}}%%\nflowchart LR\n A[\"Llega la autorización mientras el
conector está en Contingency Mode\"] --> B[\"VTEX no llama al conector\"]\n B --> C[\"El pago se envía a una
cola de reprocesamiento\"]\n C --> D[\"El pago queda con
autorización programada\"]\n D --> E[\"VTEX realiza automáticamente
un nuevo intento de autorización\"]\n E --> F[\"VTEX inicia nuevamente
el proceso de autorización\"]\n F --> G{\"¿El conector está en Contingency
Mode en el momento del intento?\"}\n G -- \"Sí\" --> C\n G -- \"No\" --> H[\"El pago sigue al
flujo normal de autorización\"]\n```\n\nEl periodo de recuperación de **Contingency Mode** y el intervalo de intento de las transacciones son procesos independientes. Esto significa que:\n\n- El conector puede salir de **Contingency Mode** tras aproximadamente 5 minutos.\n- Las transacciones pospuestas pueden seguir esperando la siguiente ventana de intento configurada para ese flujo de pago.\n\nEste comportamiento evita nuevas llamadas inmediatas a conectores que aún estén inestables y, al mismo tiempo, preserva las transacciones elegibles para su reprocesamiento automático posterior.\n\nEl intervalo entre intentos puede variar según:\n\n- El medio de pago.\n- La información devuelta por el proveedor.\n- El tiempo de cancelación del pago (`delayToCancel`).\n- Las condiciones operativas del flujo de pago.\n\nEstos factores determinan el tiempo que todavía es posible reprocesar la transacción y el intervalo que debe respetarse entre un intento y otro. Por eso el tiempo hasta el siguiente intento no es fijo para todos los pagos y puede variar según la configuración y el contexto de cada transacción.\n\nEn general:\n\nCuando `delayToCancel` es menor que 1 día, los intentos generalmente ocurren cada 1 hora.\nCuando `delayToCancel` es igual o mayor que 1 día, los intentos generalmente ocurren cada 4 horas.\n\nPara más información, consulta el endpoint [Create Payment].\n\n> ℹ️ Aunque los pagos vía [Pix (Brasil)](https://help.vtex.com/es/docs/tutorials/configurar-pix-como-medio-de-pago) no se vean afectados por **Contingency Mode**, es decir, que no hay bloqueo de transacciones realizadas por ese medio, hay otros problemas que pueden interrumpir el procesamiento del pago. En estos casos, cuando el campo `delayToCancel` está configurado entre 5 minutos y 1 hora, los intentos generalmente ocurren cada 5 minutos.\n\n> ⚠️ El tiempo de intentos puede variar según el medio de pago, la configuración de la cuenta y las condiciones operativas. VTEX gestiona este proceso automáticamente para que los intentos ocurran en el menor intervalo posible, reduciendo el tiempo de procesamiento de la cola de transacciones pendientes.\n\n## Cómo identificar Contingency Mode\n\nLos comerciantes pueden notar **Contingency Mode** cuando hay inestabilidad en un proveedor de pago que afecta a un conector específico.\n\nLos indicadores comunes incluyen:\n\n- Un número inusual de pagos con autorización o procesamiento pendiente para el mismo proveedor.\n- Registros de transacción que indican **Contingency Mode** en el conector afectado.\n- Una reducción temporal en el volumen de pagos aprobados para un medio de pago o proveedor específico.\n- Autorizaciones elegibles que se posponen para un intento posterior.\n\nLos proveedores de pago también pueden observar más indicadores de inestabilidad en la integración, tales como:\n\n- Eventos de tiempo de espera agotado.\n- Fallas de conexión.\n- Errores HTTP `5xx`.\n\n## Qué hacer cuando Contingency Mode está activo\n\nEn la mayoría de los casos, no es necesaria ninguna acción por parte del retailer. VTEX protege automáticamente el flujo de transacciones, reactiva el conector cuando la inestabilidad disminuye y procesa las transacciones elegibles según las reglas automáticas de intento.\n\nAcciones recomendadas:\n\n1. Monitorea las transacciones afectadas en el Admin VTEX.\n2. Verifica si el problema se concentra en un proveedor o medio de pago específico.\n3. Ponte en contacto con el proveedor de pago si la inestabilidad persiste o si necesita investigar la integración.\n4. Ponte en contacto con el [Soporte VTEX](https://supporticket.vtex.com/support) si las transacciones permanecen pendientes más tiempo del esperado o si los clientes reportan problemas de pago recurrentes.\n\n> ⚠️ Evita cancelar o recrear pedidos manualmente, a menos que haya una razón comercial clara para ello, como una solicitud del cliente, el vencimiento del pedido o la confirmación de que el pago no puede completarse.\n\n## Orientaciones para proveedores de pago\n\nLos proveedores de pago deben investigar y resolver la inestabilidad que causó las fallas técnicas recurrentes.\n\nLas verificaciones comunes incluyen:\n\n- Disponibilidad de los endpoints de autorización.\n- Tiempo de respuesta y comportamiento de tiempo de espera agotado.\n- Errores HTTP `5xx`.\n- Conectividad de la red.\n- Deploys recientes o cambios en la infraestructura.\n\nCuando el proveedor se estabilice, VTEX automáticamente removerá **Contingency Mode** del conector y las nuevas autorizaciones elegibles podrán volver a enviarse con normalidad.\n\n> ℹ️ Las transacciones pospuestas previamente seguirán las reglas de intento configuradas."}