# Perfect Pay

> Veja como conectar a sua plataforma com a Perfect Pay.

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

1. No painel, acesse **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, digite "Perfect" no filtro e clique em **Perfect Pay**.
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 ou Plano** o código do produto ou do plano na Perfect Pay (veja abaixo). Um por linha.
5. O campo **Token** recebe o token do webhook da Perfect Pay (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/perfectpay/<token>`. Ele só aparece depois de salvar.

### Onde encontrar o código na Perfect Pay

1. No menu lateral, clique em **Produtos › Meus Produtos**.
2. Selecione o produto e copie o código dele (geralmente com 8 dígitos) ou o código do plano.
3. Repita para cada produto que você vende pela Perfect Pay e quer entregar na sua plataforma.

## 2. Configure o webhook na Perfect Pay

1. No menu lateral, clique em **Ferramentas › Postback - Webhook**.
2. Crie uma nova configuração e selecione os produtos desta entrega.
3. Em **Eventos**, selecione **Todos os Eventos**.
4. Cole a URL de postback copiada da entrega.
5. Se quiser usar o token, copie o **Token** mostrado na Perfect Pay, cole no campo **Token** da entrega e salve a entrega.
6. Clique em **Salvar** na Perfect Pay.

:::dica Sobre o campo Token
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

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