# OnProfit

> Veja como conectar a sua plataforma com a OnProfit.

Com a integração da OnProfit, 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 "OnProfit" no filtro e clique em **OnProfit**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. Em **Conexão com o gateway**, preencha o campo **ID do Produto** com o **ID de entrega** que você vai criar nas ofertas da OnProfit (veja abaixo). Um ID por linha.
5. 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.
6. Clique em **Salvar**.
7. Copie o endereço completo do campo **URL de Postback**, no formato `https://<sua-plataforma>/api/postback/onprofit/<token>`. Ele só aparece depois de salvar.

### Crie o ID de entrega nas ofertas da OnProfit

1. Na OnProfit, clique em **Meus Produtos** e em **Editar** no produto desejado.
2. Abra a aba **Ofertas** e vincule a integração de área de membros.
3. No campo **Entrega** de cada oferta, crie um ID de entrega personalizado. É esse ID que vai no campo **ID do Produto** da sua entrega.

- Se todas as ofertas liberam o mesmo conteúdo, use o mesmo ID em todas (a OnProfit exige editar cada oferta, uma a uma).
- Se uma oferta libera conteúdo diferente, dê a ela um ID próprio e crie outra entrega na sua plataforma com esse ID.
- Ofertas que já existiam também precisam ser editadas para receber o ID.

## 2. Configure o webhook na OnProfit

1. No menu lateral da OnProfit, clique em **Integrações**.
2. Escolha a integração de área de membros por URL de postback e clique em **Integrar › Adicionar Integração**.
3. Cole a URL de postback copiada da entrega no campo indicado.
4. Clique em **Salvar**.

:::aviso Uma URL para cada entrega
A URL de postback leva o token de **uma** entrega e só libera o conteúdo dela. Se a OnProfit mandar vendas de outras ofertas para esse endereço, elas aparecem com erro em **Vendas › Vendas** (você pode usar **Ignorar** nelas). Se várias ofertas liberam o mesmo conteúdo, use o mesmo ID de entrega em todas.
:::

## 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 OnProfit (e-mail, código da venda, status e IDs). 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.
:::