Quando alguém compra na sua conta Stripe, o aviso chega à Academy por webhook. O acesso é liberado quando o pagamento é confirmado e retirado se a venda for desfeita.
Passo a passo
- Abra Configurações → Integrações, procure Stripe (aba Pagamentos) e clique em Abrir configuração.
- Em Copie a URL e cole no Stripe, clique em Copiar ao lado de URL do webhook. No painel da Stripe, em Webhooks, crie o destino com essa URL e marque os eventos de Eventos para marcar na Stripe (o botão Copiar eventos copia a lista).
- Copie o signing secret do destino, cole em Cole aqui: Signing secret do endpoint Stripe e clique em Salvar.
- Em cada Payment Link ou Checkout Session, adicione no metadata a chave
product_id. Em Ligue os produtos, use esse valor em ID do produto na plataforma, escolha o Grupo de acesso e clique em Adicionar mapeamento. - Faça uma compra e confira o resultado na tela ou na aba Eventos recebidos.
O que cada evento faz
| Evento | O que acontece |
|---|---|
checkout.session.completed | Libera quando o pagamento já está confirmado |
checkout.session.async_payment_succeeded | Libera o boleto ou o Pix depois de pago |
invoice.paid | Renova o acesso da assinatura a cada cobrança paga |
invoice_payment.paid | Não muda acesso: liga a cobrança da renovação à assinatura nas versões novas da API |
payment_intent.succeeded | Libera pagamentos sem Checkout, com product_id e e-mail de recibo |
charge.refunded | Retira o acesso no reembolso total (o parcial não muda nada) |
charge.dispute.created | Retira o acesso na contestação (chargeback) |
customer.subscription.updated | Suspende durante o atraso e devolve quando a assinatura volta a ficar ativa |
customer.subscription.deleted | Retira o acesso quando a assinatura é cancelada |
Bom saber
- Boleto e Pix só liberam o acesso depois de pagos.
- Eventos de teste da Stripe aparecem como Teste recebido e nunca liberam nem retiram acesso.
- Reembolso, contestação, atraso e cancelamento são ligados à compra original pelos ids da Stripe e só retiram o acesso que aquela venda deu. Se o aluno tiver o mesmo acesso por outra venda ou origem, o evento aparece como Acesso mantido.
- Sem a compra original nesta academia, o evento aparece como Venda não identificada e o acesso não muda. Confira o aluno e ajuste à mão, se for o caso.