Webhook
Receba notificações em tempo real sobre eventos da plataforma.
Atualizado em
Os Webhooks da Dom Pagamentos permitem que sua aplicação seja notificada automaticamente quando eventos importantes ocorrem na plataforma — como pagamentos confirmados, assinaturas canceladas ou subcontas aprovadas.
Como funciona
Quando um evento ocorre, a Dom Pagamentos envia uma requisição POST com um payload JSON para a URL configurada no seu cadastro. Sua aplicação deve responder com status 200 para confirmar o recebimento.
Segurança
Cada requisição de webhook inclui uma assinatura digital no header X-Dom-Signature. Valide sempre essa assinatura antes de processar o evento para garantir que a requisição é legítima.
Consulte a documentação de Verificação de Assinatura para detalhes de implementação em PHP e outras linguagens.
Recursos disponíveis
- Eventos — Lista completa de todos os tipos de evento suportados
- Payload — Exemplos de payloads JSON por tipo de evento
- Verificação de Assinatura — Como validar a autenticidade dos webhooks