Integração Genérico / Zapier / Make / n8n
Dar acesso automático aos compradores da Genérico / Zapier / Make / n8n e retirá-lo em reembolsos.
1. Criar a integração
- Painel → app → Vendas → Nova integração → escolha Genérico / Zapier / Make / n8n.
- Preencha Secret (Enviar no header X-Webhook-Secret), Campo do email (default: email), Campo do nome (default: name), Campo do produto (default: product_id), Campo da transação (default: transaction), Campo do evento (default: event), Valores = aprovado (default: approved,paid,completed), Valores = reembolso (default: refunded,chargeback), Valores = cancelamento (default: canceled,cancelled). Os campos secretos são guardados cifrados e servem para confirmar que cada aviso vem mesmo da plataforma.
- Guarde. O painel mostra o URL de webhook desta integração.
2. Configurar na Genérico / Zapier / Make / n8n
POST (JSON ou form) para a URL abaixo. Formato por omissão: {"event":"approved|refunded|canceled","email":"…","name":"…","product_id":"…","transaction":"…","event_id":"…"}. Pode mapear outros nomes de campos (pontos para campos aninhados, ex.: data.buyer.email).
https://www.zurianlab.com/api/webhooks/generic/<token-da-integração>3. Associar produtos
Na integração, associe cada produto da Genérico / Zapier / Make / n8n (Valor do campo de produto) a um ou mais produtos da app. Compras de produtos sem associação aparecem em Vendas com erro para corrigir com um clique.
4. Testar
Faça uma compra de teste (ou use o botão de teste/reenvio da Genérico / Zapier / Make / n8n). Em Vendas vê cada evento recebido com o estado (processado, ignorado, falhou) e pode reprocessá-lo.
O que cada evento faz
| Evento | Efeito |
|---|---|
| Compra ou renovação aprovada | Cria o aluno (se não existir), dá acesso aos produtos associados e envia o email de acesso. |
| Reembolso, chargeback ou cancelamento | Retira o acesso dado por essa transação (os acessos dados por outras compras mantêm-se). |
| Pagamento pendente (transferência, voucher ou referência) | Cria um lead para recuperação; nunca dá acesso. |
| Pagamento recusado ou expirado, carrinho abandonado | Cria um lead e dispara as automações de recuperação. |
| Subscrição com pagamento em atraso | Inicia o período de tolerância definido nas Definições; depois retira o acesso. |
| Mudança de plano | Troca os produtos da subscrição. |
Segurança e fiabilidade
- Cada aviso é verificado (assinatura, token ou chave) antes de qualquer alteração; avisos não verificados são rejeitados.
- O processamento é idempotente: o mesmo evento repetido pela plataforma nunca dá acesso duas vezes.
- O acesso só é dado depois de a plataforma confirmar o pagamento — nunca a partir do navegador do comprador.