# Payt

> Veja como conectar a sua plataforma com a Payt.

Com a integração da Payt, cada venda finalizada/aprovada libera o acesso do aluno aos cursos da entrega. Cancelamento, chargeback e reembolso 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 "Payt" no filtro e clique em **Payt**.
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 Payt, **sem o #**. Um por linha.
5. O campo **Chave de Integração** recebe a **Chave Única** do postback da Payt (passo 2). É opcional; 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/payt/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o código do produto na Payt

No painel da Payt, menu superior **Ofertas e Produtos › Produtos**. Copie o código do produto sem o `#`.

## 2. Configure o postback na Payt

1. No menu superior da Payt, clique em **Ofertas e Produtos › Postbacks** e crie um novo postback.
2. Em **URL**, cole a URL de postback copiada da entrega.
3. Em **Produto**, selecione os produtos desta entrega.
4. Em **Eventos**, selecione:
   - Finalizada/Aprovada
   - Cancelada
   - Cancelada - Chargeback
   - Cancelada - Reembolsada
5. Salve. Se quiser usar a chave, copie a **Chave Única** do postback (no canto superior direito), cole no campo **Chave de Integração** da entrega e salve a entrega.

:::dica Sobre a Chave de Integração
A chave é opcional. Quando preenchida, a venda só é aceita se esse mesmo valor vier no envio da Payt. 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.
:::

## 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 Payt (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.
:::