Webhooks
Visao Geral
Introdução ao servico de webhooks do EagleIX para notificacoes de eventos PIX
O servico epix-envia-webhook gerencia o registro, despacho e entrega de webhooks para notificacoes de eventos PIX em tempo real.
O que sao webhooks?
Webhooks permitem que seu sistema receba notificacoes automaticas quando eventos ocorrem na plataforma EagleIX. Ao invés de fazer polling periodico, você registra uma URL HTTPS e recebe um POST com o payload do evento assim que ele acontece.
Tipos de evento
| Tipo | Descricao |
|---|---|
ATUALIZACAO_STATUS_PIX | Mudanca de status de uma transacao PIX (ex: SETTLED, REJECTED) |
FALHA_WEBHOOK | Notificacao de falha na entrega de um webhook |
Fluxo basico
- Registre um webhook —
POST /api/v1/webhookscom a URL do seu endpoint, tipo de evento e secret - Receba eventos — Quando um evento PIX ocorre, o servico envia um POST para sua URL com o payload assinado
- Valide a assinatura — Use o secret para verificar o header
X-Signaturee garantir autenticidade - Responda com 2xx — Retorne qualquer status 2xx para confirmar o recebimento
- Retentativas automaticas — Se seu endpoint falhar, o servico retenta automaticamente com backoff exponencial