Pular para o conteúdo

PagTrust

Veja como conectar a sua plataforma com a PagTrust.

Nesta página

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.

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.
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.

Esta página ajudou?

Artigos relacionados