Zouti
Veja como conectar a sua plataforma com a Zouti.
Nesta página
Com a integração da Zouti, cada venda aprovada libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso.
1. Crie a entrega na sua plataforma
- No painel, acesse Vendas › Entregas e clique em Nova Entrega.
- Na tela Selecione um Gateway, digite "Zouti" no filtro e clique em Zouti.
- Dê um nome à entrega e escolha a Modalidade de Venda: Venda única ou Assinatura.
- Em Conexão com o gateway, cole no campo ID do Produto o ID do produto na Zouti, que começa com
prod_(veja abaixo). Um por linha. - O campo Account ID recebe o identificador da sua conta Zouti, que começa com
acc_(veja abaixo). É opcional; veja a dica. - 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.
- Clique em Salvar.
- Copie o endereço completo do campo URL de Postback, no formato
https://<sua-plataforma>/api/postback/zouti/<token>. Ele só aparece depois de salvar.
Onde encontrar o ID do produto e o Account ID
- ID do produto: no portal da Zouti, menu lateral Produtos, clique no produto. O ID tem o formato
prod_1wah3kk6980n6yysjx56ki. - Account ID: com a conta aberta no dashboard, olhe a URL, por exemplo
https://dashboard.zouti.com.br/acc_zezygn9ze6x5ncdyx6mb49/dashboard/.... O Account ID é o trecho que começa comacc_e vai até a próxima barra.
Quando preenchido, a venda só é aceita se esse mesmo valor vier no envio da Zouti. Se o teste mostrar o erro "Token do gateway não confere com o cadastrado na entrega", apague o campo, salve e reprocesse: a URL completa da entrega já autoriza as vendas.
2. Configure o webhook na Zouti
- No painel da Zouti, acesse Conteúdo › Área de Membros Externa › Integrar com Área de Membros.
- Escolha a integração de área de membros por URL de postback.
- Preencha:
- URL Postback: a URL de postback copiada da entrega
- URL Área de Membros: o endereço da sua plataforma,
https://<sua-plataforma>
- Confira se o webhook aparece como Ativo na tela de Webhooks.
- Os produtos precisam estar publicados e ativos na Zouti.
- A entrega precisa ter o ID do produto correto.
- Ative o webhook só depois de terminar toda a configuração.
A URL de postback leva o token de uma entrega e só libera o conteúdo dela. Se a Zouti mandar vendas de outros produtos para esse endereço, elas aparecem com erro em Vendas › Vendas (você pode usar Ignorar nelas). Se vários produtos liberam o mesmo conteúdo, coloque todos os IDs na mesma entrega.
3. Teste
- Faça uma compra de teste com um e-mail que não seja de administrador da plataforma (vendas com e-mail de administrador são recusadas).
- Acesse Vendas › Vendas. A venda aparece em Últimas (enquanto é processada, fica em Na Fila).
- Abra a venda (menu ··· › Ver detalhes) e confira o evento recebido, os IDs de produto/oferta no payload e, se houver, o Motivo do erro.
- Se precisar ajustar a entrega, corrija e clique em Reprocessar na venda.
A plataforma reconhece os campos mais comuns do envio da Zouti (e-mail, código da venda, status e IDs do produto). 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.