Visão Geral
O endpoint de Reenvio de Webhook permite que você solicite o reenvio manual de notificações de transações específicas. Isso é útil em cenários onde:- Seu servidor estava indisponível quando o webhook original foi enviado
- Você precisa reprocessar uma transação específica
- Deseja testar a integração com uma URL diferente temporariamente
Este endpoint não altera a configuração de webhook da sua conta. A URL fornecida é usada apenas para o reenvio específico.
Funcionamento
Identificação da Transação
O endpoint aceita três tipos de identificadores:O sistema busca simultaneamente por todos os tipos de identificador na sua conta. Na prática não há ambiguidade: id numérico é puramente dígitos; e2eId começa com ‘E’ ou ‘D’ seguido de 32 caracteres alfanuméricos; externalId é qualquer string fornecida por você.
Processamento Síncrono
O reenvio de webhook é processado de forma síncrona. Isso significa que:- A requisição aguarda o envio do webhook ser concluído
- O resultado é comunicado via HTTP status code (200, 502, 504)
- O tempo de resposta depende da latência do seu servidor (timeout: 10s)
Diferentemente dos webhooks automáticos (que utilizam filas com retry), o reenvio manual é executado imediatamente e retorna o resultado na mesma requisição.
Casos de Uso
1. Reenvio para URL Configurada
Se você já tem um webhook configurado na sua conta, basta chamar o endpoint sem body:2. Reenvio com URL Temporária
Para testar com uma URL diferente ou reenviar para um endpoint de contingência:Resposta
Sucesso (200)
Webhook enviado com sucesso para a URL de destino.Erro: Sem URL Configurada (400)
Erro: Transação Não Encontrada (404)
Erro: Destino Retornou Erro (502)
O servidor de destino retornou um erro (4xx ou 5xx) ou houve falha de conexão.Erro: Timeout (504)
O servidor de destino não respondeu dentro do tempo limite (10 segundos).Rate Limiting
Se o limite for excedido, você receberá um erro429 Too Many Requests:
Auditoria
Todos os reenvios manuais são registrados para fins de auditoria e rastreabilidade:Exemplos de Integração
Próximos Passos
Visão Geral de Webhooks
Entenda como os webhooks funcionam na Fire Banking
Implementação
Guia completo de implementação de webhooks