{"section":"tutorials","requestedLocale":"pt","requestedSlug":"mode-off-faq","locale":"pt","slug":"mode-off-faq","path":"docs/pt/tutorials/pagamentos/transações/mode-off-faq.md","branch":"main","content":"O **Contingency Mode** (anteriormente conhecido como **Mode-off**) é um recurso de resiliência do VTEX Payments que ajuda a proteger transações elegíveis durante instabilidades temporárias em provedores de pagamento.\n\nEste artigo explica:\n\n- [Como o **Contingency Mode** funciona](#como-o-contingency-mode-funciona)\n- [O impacto nas transações](#impacto-nas-transações)\n- [Quais meios e fluxos de pagamento podem ser afetados](#meios-de-pagamento-afetados)\n- [Como funcionam a recuperação do conector e as retentativas](#recuperação-e-comportamento-de-retentativas)\n- [Como identificar o **Contingency Mode**](#como-identificar-o-contingency-mode)\n- [O que fazer quando o **Contingency Mode** está ativo](#o-que-fazer-quando-o-contingency-mode-está-ativo)\n- [Orientações para provedores de pagamento](#orientação-para-provedores-de-pagamento)\n\n> ℹ️ Os lojistas não precisam configurar nem ativar o **Contingency Mode** manualmente. A VTEX gerencia automaticamente a ativação, a recuperação e as retentativas de transações.\n\n## Como o Contingency Mode funciona\n\nO **Contingency Mode** é um mecanismo de proteção automática para conectores de pagamento. Quando a VTEX identifica falhas técnicas recorrentes em um conector, o sistema ativa esse modo para reduzir o impacto da instabilidade no processamento de pagamentos.\n\nDurante esse período:\n\n- Novas autorizações elegíveis deixam de ser enviadas temporariamente ao provedor.\n- Novas transações elegíveis podem ser adiadas para processamento posterior.\n- Transações já adiadas seguem um fluxo independente de retentativas agendadas.\n\nEssa proteção se aplica ao conector afetado, não à loja como um todo. Outros provedores de pagamento ou meios de pagamento que não foram afetados pela instabilidade podem continuar operando normalmente.\n\nO ciclo de ativação e recuperação do **Contingency Mode** é separado do ciclo de retentativa das transações adiadas. Isso significa que um conector já pode ter saído de **Contingency Mode** enquanto determinadas transações ainda aguardam a próxima janela de retentativa configurada.\n\n### Ativação\n\nO **Contingency Mode** é ativado quando a VTEX detecta 5 erros técnicos qualificáveis em 5 minutos para o mesmo conector.\n\nErros técnicos qualificáveis podem incluir:\n\n- Timeouts de requisição.\n- Falhas de conexão.\n- Requisições canceladas por instabilidade técnica.\n- Respostas HTTP `408` de timeout.\n- Erros HTTP `5xx` do provedor, como `500`, `502`, `503` ou `504`.\n\n> ℹ️ Retornos esperados do processo de autorização não ativam o **Contingency Mode**. Por exemplo, saldo insuficiente, cartão inválido, cartão expirado e pagamento não autorizado fazem parte do fluxo normal de autorização e não são considerados instabilidade do conector.\n\n### Ciclo do Contingency Mode\n\nQuando o **Contingency Mode** está ativo:\n\n- A VTEX marca o conector afetado como temporariamente indisponível.\n- Novas requisições de autorização elegíveis não são enviadas ao provedor.\n- Novas transações elegíveis podem ser adiadas para uma retentativa posterior.\n- O conector permanece temporariamente indisponível até o término do período automático de recuperação.\n- Os lojistas podem ver uma indicação de **Contingency Mode** nos detalhes da transação ou nos logs de pagamento.\n\nEsse comportamento ajuda a evitar novas chamadas a um conector instável enquanto o provedor se recupera.\n\nO diagrama a seguir mostra o ciclo de ativação e recuperação do **Contingency Mode** para novas autorizações:\n\n```mermaid\n%%{init: {'flowchart': {'htmlLabels': true, 'useMaxWidth': false, 'wrappingWidth': 500, 'padding': 14}}}%%\nflowchart LR\n A[\"Nova tentativa
de autorização\"] --> B[\"VTEX inicia o processo
de autorização\"]\n B --> C{\"Conector está em
Contingency Mode?\"}\n C -- \"Sim\" --> D[\"Encaminha para o fluxo
de autorização agendada\"]\n C -- \"Não\" --> E[\"VTEX envia o pagamento
ao conector\"]\n E --> F{\"Conector retornou
erro qualificável?\"}\n F -- \"Não\" --> G[\"Fluxo normal
de autorização\"]\n F -- \"Sim\" --> H[\"Erro qualificável
é acumulado\"]\n H --> I{\"5 erros qualificáveis
nos últimos 5 minutos?\"}\n I -- \"Sim\" --> J[\"Contingency Mode é ativado
por cerca de 5 minutos\"]\n J --> K[\"Novas autorizações elegíveis
deixam de ser enviadas ao conector\"]\n K --> L[\"Após cerca de 5 minutos,
Contingency Mode é desativado\"]\n L --> M[\"Novas autorizações voltam
a ser avaliadas normalmente\"]\n```\n\n## Impacto nas transações\n\nO **Contingency Mode** não cancela pedidos por si só. As transações afetadas pelo **Contingency Mode** podem ser adiadas para uma retentativa automática posterior.\n\n> ℹ️ O **Contingency Mode** não substitui as regras normais de expiração e cancelamento de pagamento. Se o pagamento não puder ser autorizado antes do prazo aplicável, o pedido ainda poderá ser cancelado conforme o fluxo normal do pedido.\n\nOs clientes podem ver o pagamento como em processamento ou pendente enquanto a VTEX aguarda a próxima retentativa da autorização.\n\nOs lojistas devem evitar pedir aos clientes que façam um novo pedido imediatamente, a menos que o pedido original já tenha sido cancelado ou que o meio de pagamento exija uma nova ação do cliente.\n\n## Meios de pagamento afetados\n\nO **Contingency Mode** aplica-se a fluxos de pagamento que podem ser processados de forma assíncrona e retentados com segurança após uma instabilidade temporária no provedor.\n\nMeios ou fluxos de pagamento que exigem uma resposta online imediata, redirecionamento do cliente ou uma nova ação do cliente podem não ser adiados e retentados da mesma forma. Nesses casos, a transação segue o comportamento padrão desse meios de pagamento.\n\n> ℹ️ Se você não tiver certeza de que um meio de pagamento específico é elegível para o **Contingency Mode**, entre em contato com o [Suporte VTEX](https://supporticket.vtex.com/support) ou com seu provedor de pagamento.\n\n## Recuperação e comportamento de retentativas\n\nA recuperação do conector é automática. Após aproximadamente 5 minutos desde o último erro qualificável, a VTEX remove o conector do **Contingency Mode** e novas autorizações elegíveis podem voltar a ser enviadas normalmente ao provedor.\n\nA saída do **Contingency Mode** afeta apenas novas tentativas de autorização. Transações previamente adiadas seguem seu próprio fluxo de retentativa agendada.\n\n### Retentativa de transações adiadas\n\nTransações adiadas durante o **Contingency Mode** não são necessariamente retentadas imediatamente após a recuperação do conector.\n\nEssas transações seguem um fluxo independente de retentativa baseado:\n\n- Nas regras de retry do meio de pagamento.\n- No tempo de cancelamento do pagamento (`delayToCancel`).\n- Nas informações retornadas pelo provedor.\n- Em outras condições operacionais do fluxo de pagamento.\n\nO diagrama a seguir mostra o comportamento das autorizações agendadas:\n\n```mermaid\n%%{init: {'flowchart': {'htmlLabels': true, 'useMaxWidth': false, 'wrappingWidth': 500, 'padding': 14}}}%%\nflowchart LR\n A[\"Autorização chega enquanto o
conector está em Contingency Mode\"] --> B[\"VTEX não chama o conector\"]\n B --> C[\"Pagamento é enviado para
uma fila de reprocessamento\"]\n C --> D[\"Pagamento fica como
autorização agendada\"]\n D --> E[\"VTEX realiza automaticamente
uma nova tentativa de autorização\"]\n E --> F[\"VTEX inicia novamente
o processo de autorização\"]\n F --> G{\"Conector está em Contingency
Mode no momento da retentativa?\"}\n G -- \"Sim\" --> C\n G -- \"Não\" --> H[\"Pagamento segue para o
fluxo normal de autorização\"]\n```\n\nO período de recuperação do **Contingency Mode** e o intervalo de retentativa das transações são processos independentes. Assim:\n\n- O conector pode sair do **Contingency Mode** após aproximadamente 5 minutos.\n- As transações adiadas podem continuar aguardando a próxima janela de retentativa configurada para aquele fluxo de pagamento.\n\nEsse comportamento evita novas chamadas imediatas a conectores ainda instáveis, ao mesmo tempo em que preserva as transações elegíveis para reprocessamento automático posterior.\n\nO intervalo entre retentativas pode variar conforme:\n\n- O meio de pagamento.\n- As informações retornadas pelo provedor.\n- O tempo de cancelamento do pagamento (`delayToCancel`).\n- As condições operacionais do fluxo de pagamento.\n\nEsses fatores determinam por quanto tempo a transação ainda pode ser reprocessada e qual intervalo deve ser respeitado entre uma tentativa e outra. Por isso, o tempo até a próxima retentativa não é fixo para todos os pagamentos e pode variar conforme a configuração e o contexto de cada transação.\n\nEm geral:\n\nQuando `delayToCancel` é menor que 1 dia, as retentativas geralmente ocorrem a cada 1 hora.\nQuando `delayToCancel` é igual ou maior que 1 dia, as retentativas geralmente ocorrem a cada 4 horas.\n\nPara mais informações, consulte o [Create Payment](https://developers.vtex.com/docs/api-reference/payment-provider-protocol?endpoint=post-/payments) endpoint.\n\n> ℹ️ Embora pagamentos via [PIX](https://help.vtex.com/pt/docs/tutorials/configurar-pix-como-meio-de-pagamento) não sejam afetados pelo **Contingency Mode**, ou seja, não haja bloqueio de transações realizadas por esse meio, outros problemas podem interromper o processamento do pagamento. Nesses casos, quando o campo `delayToCancel` está configurado entre 5 minutos e 1 hora, as tentativas de retry geralmente ocorrem a cada 5 minutos.\n\n> ⚠️ O tempo de retry pode variar conforme o meio de pagamento, as configurações da conta e as condições operacionais. A VTEX gerencia esse processo automaticamente para que as retentativas ocorram no menor intervalo possível, reduzindo o tempo de processamento da fila de transações pendentes.\n\n## Como identificar o Contingency Mode\n\nOs lojistas podem notar o **Contingency Mode** quando há instabilidade em um provedor de pagamento que afeta um conector específico.\n\nIndicadores comuns incluem:\n\n- Um número incomum de pagamentos pendentes de autorização ou processamento para o mesmo provedor.\n- Logs de transação indicando **Contingency Mode** no conector afetado.\n- Uma redução temporária no volume de pagamentos aprovados para um meio de pagamento ou provedor específico.\n- Autorizações elegíveis sendo adiadas para retentiva posterior.\n\nOs provedores de pagamento também podem observar mais indicadores de instabilidade na integração, como:\n\n- Timeouts.\n- Falhas de conexão.\n- Erros HTTP `5xx`.\n\n## O que fazer quando o Contingency Mode está ativo\n\nNa maioria dos casos, nenhuma ação é necessária por parte do lojista. A VTEX protege automaticamente o fluxo de transações, reabilita o conector quando a instabilidade diminui e processa as transações elegíveis conforme as regras automáticas de retentativa.\n\nAções recomendadas:\n\n1. Monitore as transações afetadas no Admin VTEX.\n2. Verifique se o problema está concentrado em um provedor ou meio de pagamento específico.\n3. Entre em contato com o provedor de pagamento se a instabilidade persistir ou se ele precisar investigar a integração.\n4. Entre em contato com o [Suporte VTEX](https://supporticket.vtex.com/support) se as transações permanecerem pendentes por mais tempo do que o esperado ou se os clientes relatarem problemas recorrentes de pagamento.\n\n> ⚠️ Evite cancelar ou recriar pedidos manualmente, a menos que haja uma razão comercial clara para isso, como solicitação do cliente, expiração do pedido ou confirmação de que o pagamento não pode ser concluído.\n\n## Orientação para provedores de pagamento\n\nOs provedores de pagamento devem investigar e resolver a instabilidade que causou as falhas técnicas recorrentes.\n\nVerificações comuns incluem:\n\n- Disponibilidade dos endpoints de autorização.\n- Tempo de resposta e comportamento de timeout.\n- Erros HTTP `5xx`.\n- Conectividade de rede.\n- Deploys recentes ou mudanças na infraestrutura.\n\nDepois que o provedor se estabilizar, a VTEX remove automaticamente o conector do **Contingency Mode** e novas autorizações elegíveis podem voltar a ser enviadas normalmente.\n\n> ℹ️ Transações previamente adiadas continuam seguindo suas regras configuradas de retentativa."}