Introdução
Entenda um pouco mais sobre o que é e sua a importância
O que é um Webhook?Copied!
Um webhook é um mecanismo de notificação em tempo real onde a Fire Banking envia uma requisição HTTP ao seu endpoint sempre que um evento relevante ocorre na nossa API (por exemplo, quando uma transação PIX ou Boleto é paga, estornada ou cancelada). Diferente de um endpoint de polling, o webhook “empurra” a informação assim que ela acontece.
Importância:
-
Eficiência: reduz a necessidade de sua aplicação fazer múltiplas requisições GET para verificar o status de cada transação.
-
Imediatismo: você recebe o evento assim que ele ocorre, diminuindo latência e melhorando a experiência do usuário.
-
Escalabilidade: evita picos de requisições ao nosso servidor, já que não há polling contínuo.
Como usar:
-
Defina sua URL de Webhook: no painel da Fire Banking, acesse a seção de Webhooks e insira a URL em que sua aplicação está aguardando requisições.
-
Valide a conexão: sua aplicação deve responder
HTTP STATUS/OK 200em até 5 segundos. -
Receba eventos: sempre que uma transação mudar de status, enviaremos um payload JSON para sua URL.
-
Tratamento de falhas: se seu endpoint não responder ou devolver erro, nossa API tentará reenviar algumas vezes. Em última instância, você pode consultar manualmente nosso endpoint GET de transações como fallback.
Com esse fluxo, sua aplicação fica mais leve, reativa e preparada para processar eventos em tempo real sem sobrecarregar seus recursos.