Perfect Pay
Veja como conectar a sua plataforma com a Perfect Pay.
Nesta página
Com a integração da Perfect Pay, cada venda aprovada libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso.
1. Crie a entrega na sua plataforma
- No painel, acesse Vendas › Entregas e clique em Nova Entrega.
- Na tela Selecione um Gateway, digite "Perfect" no filtro e clique em Perfect Pay.
- Dê um nome à entrega e escolha a Modalidade de Venda: Venda única ou Assinatura.
- Em Conexão com o gateway, cole no campo Código do Produto ou Plano o código do produto ou do plano na Perfect Pay (veja abaixo). Um por linha.
- O campo Token recebe o token do webhook da Perfect Pay (passo 2). É opcional; veja a dica abaixo.
- 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.
- Clique em Salvar.
- Copie o endereço completo do campo URL de Postback, no formato
https://<sua-plataforma>/api/postback/perfectpay/<token>. Ele só aparece depois de salvar.
Onde encontrar o código na Perfect Pay
- No menu lateral, clique em Produtos › Meus Produtos.
- Selecione o produto e copie o código dele (geralmente com 8 dígitos) ou o código do plano.
- Repita para cada produto que você vende pela Perfect Pay e quer entregar na sua plataforma.
2. Configure o webhook na Perfect Pay
- No menu lateral, clique em Ferramentas › Postback - Webhook.
- Crie uma nova configuração e selecione os produtos desta entrega.
- Em Eventos, selecione Todos os Eventos.
- Cole a URL de postback copiada da entrega.
- Se quiser usar o token, copie o Token mostrado na Perfect Pay, cole no campo Token da entrega e salve a entrega.
- Clique em Salvar na Perfect Pay.
O token é opcional. Quando preenchido, a venda só é aceita se esse mesmo valor vier no envio da Perfect Pay. 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
- Na tela do webhook, clique no ícone </> (enviar teste), escolha Aprovada e salve. O teste traz dados fictícios, então costuma aparecer em Vendas › Vendas, na aba Com erro. Se apareceu, a URL está certa.
- Faça também uma compra real com um e-mail que não seja de administrador da plataforma.
- 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.
- Se precisar ajustar a entrega, corrija e clique em Reprocessar na venda.
A plataforma reconhece os campos mais comuns do envio da Perfect Pay (e-mail, código da venda, status e códigos do produto e do plano). 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.