Novas tentativas automáticas
O plugin processa os eventos Pix de forma assíncrona. Se falhar ao processar um evento, o plugin tenta de novo no mesmo lugar e depois captura o evento em uma dead-letter queue, sem perda. Um operador reprocessa um evento estacionado, limitado a um número máximo de tentativas. Depois do limite, o registro continua estacionado para inspeção e o plugin nunca o descarta. O plugin repete as chamadas de saída ao provedor em respostas 5xx e em timeouts. Cada nova tentativa usa backoff exponencial com jitter.
Conciliação de devoluções
Uma devolução pode ter sucesso no provedor e mesmo assim não ser registrada localmente, se o serviço cair entre os dois passos. O sweeper de conciliação de devoluções é a rede de segurança em segundo plano para esse caso. O sweeper roda em um timer e encontra 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 estaciona para um operador a linha que ainda está no passo de criação, porque repetir a criação às cegas poderia causar uma devolução em duplicidade. Cada tentativa que falha espera mais que a anterior, de um minuto até uma hora. Depois de um número máximo de tentativas, o sweeper estaciona o registro e dispara um alerta. Ele não tenta para sempre. O sweeper é opcional e vem desligado por padrão.
Configuração
Você pode ajustar o comportamento de novas tentativas e de conciliação com variáveis de ambiente:
O que você precisa fazer
O plugin gerencia as novas tentativas e a conciliação para você. As configurações padrão servem à maioria dos deploys. Para manter as operações saudáveis:
- Use IDs únicos e rastreáveis para suas transações e contas.
- Monitore a entrega dos eventos e o status das transações.
- Fale com a Lerian para visibilidade dos jobs ou suporte a reprocessamento de eventos.