O que são Webhooks?
Webhooks são notificações HTTP enviadas automaticamente pela VisePag para a URL configurada no seu sistema quando um evento ocorre (ex: pagamento confirmado, saque concluído).Eventos Suportados
Os endpoints são cadastrados no Dashboard, no menu Webhooks. Veja Webhooks na API Reference para a assinatura.
Exemplos de Payload
transaction.paid
transaction.paid
withdrawal.completed
withdrawal.completed
withdrawal.failed
withdrawal.failed
Respondendo ao Webhook
Sua URL deve responder com qualquer HTTP 2xx em até 10 segundos:Boas Práticas
- Seja idempotente: o mesmo evento pode ser entregue mais de uma vez. Use o
iddo evento (headerX-Event-Id) para evitar processamento duplicado - Responda rápido: retorne
200imediatamente e processe em background - Valide o payload: verifique se o
idexiste no seu sistema antes de processar