# Zouti

> Veja como conectar a sua plataforma com a Zouti.

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

1. No painel, acesse **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, digite "Zouti" no filtro e clique em **Zouti**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. 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.
5. O campo **Account ID** recebe o identificador da sua conta Zouti, que começa com `acc_` (veja abaixo). É opcional; veja a dica.
6. 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.
7. Clique em **Salvar**.
8. 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 com `acc_` e vai até a próxima barra.

:::dica Sobre o campo Account ID
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

1. No painel da Zouti, acesse **Conteúdo › Área de Membros Externa › Integrar com Área de Membros**.
2. Escolha a integração de área de membros por URL de postback.
3. Preencha:
   - **URL Postback:** a URL de postback copiada da entrega
   - **URL Área de Membros:** o endereço da sua plataforma, `https://<sua-plataforma>`
4. Confira se o webhook aparece como **Ativo** na tela de Webhooks.

:::aviso Antes de ativar
- 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.
:::

:::aviso Uma URL para cada entrega
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

1. 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).
2. Acesse **Vendas › Vendas**. A venda aparece em **Últimas** (enquanto é processada, fica em **Na Fila**).
3. 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**.
4. Se precisar ajustar a entrega, corrija e clique em **Reprocessar** na venda.

:::info Integração por leitura automática
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.
:::