A integração via Webhook permite que o sistema dispare eventos para a sua aplicação sempre que algo acontecer (ex.: ativação de assinatura, suspensão, reativação ou cancelamento).
Assim, seu backend recebe uma requisição HTTP com os dados do evento e pode executar ações automáticas (provisionamento, bloqueio, notificações, etc.).
📂 Onde fica
-
Configurações → Planos→ Planos de Assinatura→ Passo 3 da criação ou edição de um plano.
-
Também disponível nas configurações de Assinaturas/Planos para definir URLs específicas por ação.
📊 Eventos disponíveis
Você pode cadastrar uma URL para receber os eventos abaixo (os principais ligados às assinaturas):
-
subscription.activated – quando a assinatura é ativada
-
subscription.suspended – quando a assinatura é suspensa
-
subscription.unsuspended – quando a assinatura é des-suspensa (reativada sem novo ciclo)
-
subscription.canceled – quando a assinatura é cancelada
⚙️ Como configurar
-
Criar endpoint no seu sistema (HTTP POST, status 2xx em sucesso).
-
Em Configurações → Webhooks, informe:
-
URL de destino (HTTPS recomendado)
-
Eventos que deseja receber
-
(Opcional) Chave secreta para assinar as requisições
-
-
Salvar e, se disponível, Disparar teste para validar.
✅ Conclusão
Com os Webhooks, seu sistema reage em tempo real aos eventos de assinatura — ativar, suspender, reativar e cancelar — automatizando provisionamento, bloqueios e rotinas internas.
Basta configurar a URL, escolher os eventos e validar a segurança para ter integrações robustas e escaláveis.