O timeout não conta a história inteira
Seu servidor envia uma emissão e não recebe a resposta a tempo. Isso não revela se o pedido chegou ao destino. Criar imediatamente outra operação pode duplicar a cobrança.
A chave de idempotência identifica a emissão para que uma repetição compatível possa recuperar o mesmo resultado dentro da janela implementada.
Vincule a chave à intenção de negócio
Escolha uma chave estável para emitir aquela cobrança ou aquele carnê. Preserve a chave e o corpo quando repetir por falha de rede. Se o pedido realmente mudou, primeiro entenda o estado da operação anterior.
No Pagueo, a emissão de cobranças e planos implementa a garantia documentada. Não generalize para cadastros de clientes ou endpoints de webhook: enviar o cabeçalho não cria uma garantia ausente no servidor.
Tenha também conciliação
Janelas e reservas têm prazo. Depois de um resultado incerto ou do esgotamento da janela, consulte e concilie antes de emitir de novo. Seu banco precisa preservar a relação entre o pedido e o identificador da cobrança.
Trate conflitos de payload e operações em andamento como cenários diferentes. O objetivo do retry é concluir a mesma operação, não contornar uma proteção.
Confira os campos e regras atuais antes de integrar. Seu cliente sempre paga a cobrança por Pix.
Abrir documentação ↗
