Webhooks — Documentação Técnica
Webhooks são notificações HTTP que a Alphazz envia automaticamente para o seu sistema sempre que um evento relevante acontece: pagamento confirmado, fatura criada, boleto vencido e mais. Você configura a URL de destino e escolhe quais eventos deseja receber.
Benefícios dos Webhooks
- Receba notificações em tempo real sem polling — seu sistema é notificado no momento do evento.
- Automatize fluxos pós-venda: liberação de acesso, envio de e-mail, atualização de ERP.
- Segurança com verificação de assinatura HMAC em cada payload.
- Retentativas automáticas com backoff exponencial em caso de falha no seu endpoint.
Eventos disponíveis
invoice.created — Nova fatura criada no sistema.
invoice.payment_confirmed — Pagamento confirmado pelo gateway.
invoice.payment_registered — Tentativa de pagamento registrada.
invoice.refused — Pagamento recusado pelo gateway.
invoice.updated — Dados da fatura atualizados.
invoice.abandoned — Carrinho abandonado pelo cliente.
subscription.created — Nova assinatura iniciada.
subscription.renewed — Cobrança de recorrência processada.
Formato do payload
Todo webhook envia um payload JSON com o evento, os dados do recurso afetado e metadados da loja. O header X-Alphazz-Signature contém a assinatura HMAC-SHA256 para verificação.
POST /seu-endpoint-de-webhook HTTP/1.1
Content-Type: application/json
X-Alphazz-Signature: sha256=abc123...
{
"event": "invoice.payment_confirmed",
"company_id": 123,
"data": {
"invoice_id": 789,
"status": "paid",
"total": 199.90,
"payment_method": "pix",
"customer": {
"name": "João Silva",
"email": "[email protected]"
}
}
}Como a Alphazz ajuda
A Alphazz gerencia toda a complexidade de webhooks para você: fila de envio, retentativas automáticas com intervalo configurável, verificação de assinatura e logs detalhados de cada disparo. Você só precisa implementar o endpoint receptor — a plataforma cuida da entrega, do monitoramento e do alerta em caso de falhas persistentes.
Perguntas Frequentes
Preciso verificar a assinatura de todo webhook?
Recomendamos fortemente. A assinatura garante que o payload veio da Alphazz e não foi alterado no trânsito. Use o secret do webhook para calcular o HMAC e comparar com o header recebido.
Quantas retentativas são feitas em caso de falha?
O número de retentativas e o intervalo são configuráveis por loja no painel administrativo. Por padrão, são 3 tentativas com 5 minutos de intervalo.
Posso filtrar quais eventos quero receber?
Sim. Na configuração de webhook você seleciona exatamente quais eventos deseja subscrever, evitando tráfego desnecessário.
Pronto para integrar?
Veja os guias de integração com WooCommerce e Shopify e conecte sua loja hoje.
Saiba mais sobre integração
A plataforma completa para pagamentos online com checkout whitelabel
© 2026 Alphazz Checkout. Todos os direitos reservados.