Pular para o conteúdo

Stripe

Veja como conectar a sua plataforma com o Stripe.

Nesta página

Com a integração da Stripe, cada pagamento confirmado libera o acesso do aluno aos cursos da entrega. Assinatura cancelada remove o acesso.

Integração em validação

A leitura dos envios da Stripe ainda está em validação: a Stripe nem sempre manda o ID do produto ou do link de pagamento no formato que a plataforma reconhece, e a venda pode chegar "sem ID". Faça um pagamento de teste e confira o resultado (passo 3) antes de vender.

1. Crie a entrega na sua plataforma

  1. No painel, acesse Vendas › Entregas e clique em Nova Entrega.
  2. Na tela Selecione um Gateway, digite "Stripe" no filtro e clique em Stripe.
  3. Dê um nome à entrega e escolha a Modalidade de Venda: Venda única ou Assinatura.
  4. Em Conexão com o gateway, preencha o campo ID do Produto ou ID do Link de Pagamento com os dois IDs, um por linha: o do produto e o do link de pagamento (veja abaixo).
  5. Em Conteúdo entregue, marque os cursos ou vitrines que a venda libera e, se quiser, o Tempo de acesso e a turma em Liberação. Em Tags, marque as tags que o aluno deve receber.
  6. Clique em Salvar.
  7. Copie o endereço completo do campo URL de Postback, no formato https://<sua-plataforma>/api/postback/stripe/<token>. Ele só aparece depois de salvar.

Onde encontrar os IDs na Stripe

  • ID do produto: no dashboard da Stripe, menu Produtos, abra o produto e copie o ID na caixa Detalhes.
  • ID do link de pagamento: menu Mais › Payment Links, abra o link (ou ... › editar) e copie o ID.

Use o mesmo produto da Stripe para cobranças diferentes (mensal e anual, por exemplo) quando o aluno recebe exatamente o mesmo acesso. Se as regras de acesso mudam, crie outro produto na Stripe e outra entrega na sua plataforma.

2. Configure o webhook na Stripe

  1. No dashboard da Stripe, abra Desenvolvedores › Webhooks.
  2. Clique em Adicionar Endpoint.
  3. Em URL do endpoint, cole a URL de postback copiada da entrega.
  4. Em Eventos para enviar, selecione:
    • checkout.session.completed
    • invoice.paid
    • invoice.payment_failed
    • customer.subscription.deleted
  5. Clique em Adicionar Endpoint.
Uma URL para cada entrega

A URL de postback leva o token de uma entrega e só libera o conteúdo dela. Como o endpoint da Stripe recebe os eventos de todos os produtos, eventos de produtos que não estão nessa entrega aparecem com erro em Vendas › Vendas (você pode usar Ignorar neles).

3. Teste

  1. Faça um pagamento de teste com um e-mail que não seja de administrador da plataforma (vendas com e-mail de administrador são recusadas).
  2. Acesse Vendas › Vendas e abra a venda (menu ··· › Ver detalhes).
  3. Confira o campo IDs de produto/oferta no payload:
    • Se aparecer um ID (por exemplo, um ID de preço que começa com price_), acrescente esse ID na entrega, um por linha, salve e clique em Reprocessar na venda.
    • Se aparecer o erro "O payload não trouxe nenhum ID de produto/oferta", a plataforma ainda não consegue ligar esse evento a uma entrega. Não use a Stripe para liberar acesso até isso ser resolvido.
  4. Confira também o evento recebido e, se houver, o Motivo do erro.
Integração por leitura automática

A plataforma reconhece os campos mais comuns do envio da Stripe (e-mail, código, status e IDs). Valide com uma venda real antes de abrir as vendas. Se algo não for reconhecido, a venda aparece em Vendas › Vendas, na aba Com erro, com o motivo.

Esta página ajudou?

Artigos relacionados