Skip to main content

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ê.
Qual identificador usar? Use o transactionId numérico retornado pela Fire Banking, o externalId que você forneceu na criação da transação, ou o endToEndId do PIX recebido nos webhooks. Todos são igualmente válidos.

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:
A URL temporária não é persistida. O próximo webhook automático será enviado para a URL configurada na conta.

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.
Mesmo em caso de erro, o webhook é registrado no log de auditoria. Use o webhookLogId para rastreamento.

Erro: Timeout (504)

O servidor de destino não respondeu dentro do tempo limite (10 segundos).
Se você está recebendo timeouts frequentes, verifique se seu servidor está respondendo em menos de 10 segundos.

Rate Limiting

Este endpoint possui rate limiting de 60 requisições por minuto por conta para evitar abusos.
Se o limite for excedido, você receberá um erro 429 Too Many Requests:

Auditoria

Todos os reenvios manuais são registrados para fins de auditoria e rastreabilidade:
Use o webhookLogId retornado na resposta para correlacionar com logs de suporte se necessário.

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