O Fintely utiliza webhooks para notificar sua aplicação sobre eventos importantes em tempo real, como confirmações de pagamento e mudanças de status de assinaturas.
Como Funcionam
Quando um evento ocorre (ex: um pagamento é confirmado via PIX), o Fintely envia uma requisição HTTP POST para a URL configurada na sua conta, contendo os dados do evento no corpo da requisição em formato JSON.
Eventos Disponíveis
| Evento | Descrição |
|---|---|
payment.confirmed | Pagamento confirmado pelo gateway |
payment.failed | Falha no processamento do pagamento |
subscription.activated | Assinatura ativada |
subscription.canceled | Assinatura cancelada |
invoice.created | Nova fatura gerada |
invoice.overdue | Fatura vencida |
Configuração
Configure a URL de webhook no painel do Fintely em Configurações > Webhooks.
Boas Práticas
- Responda com
200 OKo mais rápido possível para confirmar o recebimento. - Processe eventos de forma assíncrona — não execute operações demoradas durante o processamento do webhook.
- Implemente idempotência — o mesmo evento pode ser enviado mais de uma vez em caso de falha na entrega.
- Valide a origem das requisições para garantir que são legítimas.
Last modified on