# Zuptos

> Veja como conectar a sua plataforma com o Zuptos.

Com a integração da Zuptos, cada venda paga libera o acesso do aluno aos cursos da entrega. Reembolso e chargeback 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 "Zuptos" no filtro e clique em **Zuptos**.
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 Zuptos (veja abaixo). Um por linha.
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/zuptos/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o ID do produto na Zuptos

1. No menu lateral, clique em **Produtos** e selecione o produto.
2. Na página **Detalhes do Produto**, copie o **ID do Produto**.

:::info
A Zuptos não tem ID de oferta: todas as ofertas usam o ID do produto principal. Basta cadastrar o ID do produto na entrega.
:::

## 2. Configure o webhook na Zuptos

1. No menu lateral, acesse **Integrações › Webhooks › Adicionar Webhook**.
2. Preencha:
   - **Nome:** um nome que identifique a sua plataforma
   - **URL Postback:** a URL de postback copiada da entrega
   - **Produtos:** os produtos desta entrega
3. Em **Status**, marque **Pagas**, **Chargeback** e **Reembolsadas**.
4. Clique em **Salvar**.

:::dica
Cada entrega tem a sua própria URL. Se você entrega produtos diferentes pela Zuptos, crie um webhook 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 Zuptos (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.
:::