Webhooks personalizados
Como configurar webhooks para integrar com sistemas externos
Configurando webhooks personalizados:
Webhooks permitem que sistemas externos recebam notificações automáticas sobre eventos no ggCheckout. As entregas são retentadas automaticamente até 3 vezes em caso de falha.
Configurando webhook:
- Acesse "Configurações" na SideBar
- Clique em "Webhooks"
- Clique em "Adicionar Webhook"
- Cole a URL do seu endpoint
- Selecione os eventos que deseja receber
- Salve a configuração
- Teste o webhook com uma transação de teste
Pagamento aprovado
Quando uma venda é confirmada
Pagamento recusado
Quando o pagamento falha
Reembolso
Quando há devolução
Novo lead
Quando alguém inicia checkout
Informações importantes:
Retentativas automáticas
Se seu endpoint retornar erro, o webhook será retentado automaticamente até 3 vezes.
Histórico de entregas
O histórico de webhooks fica disponível por 7 dias na aba "Histórico" dentro de Configurações > Webhooks.
Secret (opcional)
Ao definir um Secret, os headers Authorization: Bearer <secret> e x-secret: <secret> são enviados para validação no seu servidor.
Filtro por produto
Você pode configurar o webhook para disparar apenas para produtos específicos ou para todos os produtos.