Retentativas automáticas
O plugin processa os eventos Pix de forma assíncrona. Se falha ao processar um evento, o plugin retenta na hora e depois captura o evento em uma fila de mensagens falhas sem perda. Um operador reprocessa um evento isolado, com um número máximo de tentativas. Após o limite, o registro permanece isolado para inspeção e o plugin nunca o descarta. O plugin retenta as chamadas de saída ao provedor diante de respostas 5xx e tempos de espera esgotados. Cada retentativa usa backoff exponencial com jitter.
Reconciliação de devoluções
Uma devolução pode ter sucesso no provedor mas falhar ao registrar localmente se o serviço cai entre os dois passos. O sweeper de reconciliação de devoluções é uma rede de segurança em segundo plano para esse caso. O sweeper roda em um temporizador e encontra as devoluções ainda travadas em pendente. Para cada uma, ele reexecuta os passos idempotentes — liquidar, confirmar ou encerrar — que o provedor deduplica pela referência da devolução. Ele isola para um operador uma linha ainda no passo de criação, porque uma recriação às cegas poderia causar uma devolução em dobro. Cada tentativa falha espera mais que a anterior, de um minuto até uma hora. Após um número máximo de tentativas, o sweeper isola o registro e gera um alerta. Ele não retenta para sempre. O sweeper é opcional e vem desativado por padrão.
Configuração
Você pode ajustar o comportamento de retentativa e reconciliação com variáveis de ambiente:
O que você precisa fazer
O plugin gerencia as retentativas e a reconciliação por você. A configuração padrão atende à maioria dos deployments. Para manter as operações saudáveis:
- Use IDs únicos e rastreáveis para suas transações e contas.
- Monitore a entrega de eventos e o status das transações.
- Contate a Lerian para visibilidade dos jobs ou suporte a replay de eventos.