# Yampi

> Veja como conectar a sua plataforma com a Yampi.

Com a integração da Yampi, cada pedido aprovado 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 "Yampi" no filtro e clique em **Yampi**.
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 Yampi (veja abaixo). Um por linha.
5. O campo **Token** é opcional: deixe em branco (veja a dica 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/yampi/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o ID do produto na Yampi

No painel da Yampi, clique em **Produtos › ver todos**. O ID aparece na linha de cada produto.

:::dica Sobre o campo Token
A Yampi mostra uma **Chave Secreta** na tela do webhook. Se você colar essa chave no campo **Token**, a venda só é aceita quando esse mesmo valor vier no envio. 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 Yampi

1. No painel da Yampi, clique em **Configurações › Webhooks** e em **Novo Webhook**.
2. Em **Nome**, coloque um nome que identifique a sua plataforma.
3. Em **URL**, cole a URL de postback copiada da entrega.
4. Selecione os eventos:
   - Pedido criado
   - O status de um pedido foi atualizado
   - Pedido atualizado
   - Pedido aprovado
5. Selecione os produtos desta entrega.
6. Clique em **Salvar**.

Sempre que passar a entregar um produto novo, acrescente-o à lista de produtos do webhook.

:::info Kits (order bump da Yampi)
Cadastre normalmente os produtos de cada kit nas suas entregas. A Yampi envia uma notificação com cada ID de produto do kit.
:::

## 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 Yampi (e-mail, número do pedido, status e IDs dos produtos). 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.
:::