# PagTrust

> Veja como conectar a sua plataforma com a PagTrust.

Com a integração da PagTrust, cada compra aprovada (ou assinatura renovada) libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback, cancelamento e assinatura 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 "Pagtrust" no filtro e clique em **Pagtrust**.
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 ou o código da oferta na PagTrust (veja abaixo). Um por linha.
5. No campo **Token do Webhook**, cole o token da PagTrust (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/pagtrust/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o ID e o token na PagTrust

- **ID do produto:** clique em **Produtos**, abra o produto e veja em **Informações gerais**.
- **Código da oferta:** dentro do produto, abra **Ofertas**, clique em editar na oferta desejada e veja em **Informações gerais**.
- **Token:** clique em **Integrações › Webhook** e use o botão **Copiar Token**.

Use o código da oferta quando uma oferta precisa liberar um conteúdo diferente das outras. Se a venda trouxer os dois, a plataforma procura primeiro uma entrega com o ID da oferta e, se não achar, usa a do produto.

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

1. No painel da PagTrust, clique em **Integrações › Webhook**.
2. Clique no botão **Adicionar (+)**, no canto superior.
3. Preencha:
   - **Nome do Webhook:** um nome que identifique a sua plataforma
   - **Produtos:** apenas os produtos desta entrega
   - **URL:** a URL de postback copiada da entrega
   - **Versão:** 2.0
4. Selecione os eventos: Compra aprovada, Compra reprovada, Compra cancelada, Compra reembolsada, Chargeback, Assinatura renovada, Assinatura criada, Assinatura cancelada e Acesso encerrado.
5. Clique em **Salvar**.

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

## 3. Teste

1. Depois de salvar o webhook, a PagTrust permite enviar **eventos de teste**. O teste chega em **Vendas › Vendas**; como traz dados fictícios, pode aparecer na aba **Com erro**. Se apareceu, a URL está certa.
2. Faça também uma compra real com um e-mail que **não** seja de administrador da plataforma.
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 PagTrust (e-mail, código da venda, status e IDs do produto e da oferta). 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.
:::