# Monetizze

> Veja como conectar a sua plataforma com a Monetizze.

Com a integração da Monetizze, cada venda finalizada/aprovada (ou assinatura ativa) libera o acesso do aluno aos cursos da entrega. Cancelamento, devolução e assinatura inadimplente ou cancelada 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 "Monetizze" no filtro e clique em **Monetizze**.
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 **Código do Produto** o código do produto na Monetizze (veja abaixo). Um código por linha.
5. No campo **Token**, cole a **Chave única** da Monetizze (opcional; veja o aviso abaixo).
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/monetizze/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o código do produto e a chave única

- **Código do produto:** no painel da Monetizze, menu superior **Produtos**, coluna **Código**.
- **Chave única:** menu superior **Ferramentas › Postback**. O token aparece como **Chave única**.

:::dica Sobre o campo Token
O token é opcional. Quando preenchido, a venda só é aceita se esse mesmo valor vier no envio da Monetizze. 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 postback na Monetizze

1. No painel da Monetizze, abra **Ferramentas › Postback**.
2. Em **Produto**, selecione apenas os produtos desta entrega.
3. Em **Tipo**, escolha **Postback (JSON)**.
4. Em **URL**, cole a URL de postback copiada da entrega.
5. Selecione os eventos:
   - Finalizada/Aprovada
   - Cancelada
   - Devolvida
   - Assinatura - Ativa
   - Assinatura - Inadimplente
   - Assinatura - Cancelada
6. Clique em **Salvar**.

:::dica
Cada entrega tem a sua própria URL. Se você entrega produtos diferentes pela Monetizze, configure um postback para cada entrega e selecione os produtos de cada um.
:::

## 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 Monetizze (e-mail, código da venda, status e códigos 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.
:::