Uma notificação pode chegar novamente
Seu servidor pode receber um evento, concluir uma etapa e falhar antes da resposta HTTP chegar ao emissor. A reentrega existe para recuperar falhas, então o consumidor precisa estar preparado para reconhecer a mesma mensagem.
Usar apenas o horário ou o valor da cobrança para decidir se já processou não é suficiente. O identificador do evento deve ter uma regra de unicidade no armazenamento.
Valide os bytes que chegaram
Confira a assinatura sobre o corpo HTTP cru, com o timestamp recebido e o segredo do endpoint. Serializar novamente o JSON pode mudar os bytes. Rejeite mensagens antigas ou com assinatura inválida.
Depois, registre o evento de forma durável antes de responder sucesso. Uma transação ou fila persistente ajuda a separar o recebimento da conclusão do trabalho.
Observe o histórico de entrega
Uma falha de entrega não quer dizer necessariamente que o pagamento falhou. Ela pode representar uma indisponibilidade no destino do evento. Consulte a cobrança e os detalhes da tentativa.
Após corrigir o endpoint, use os mecanismos documentados de reenvio. O consumidor precisa continuar seguro diante de mensagens repetidas e do histórico real do pedido.
Confira os campos e regras atuais antes de integrar. Seu cliente sempre paga a cobrança por Pix.
Abrir documentação ↗
