# CartPanda

> Veja como conectar a sua plataforma com a CartPanda.

Com esta integração, cada venda aprovada na Cartpanda libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso daquela venda.

## 1. Crie a entrega na sua plataforma

1. No painel, abra **Vendas › Entregas** e clique em **Nova Entrega**.
2. Na tela **Selecione um Gateway**, escolha **Cartpanda**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **ID do Produto ou da Variação**, cole o ID do produto na Cartpanda. Para achar: em **Produtos**, abra o produto e copie o ID que aparece no endereço do navegador. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. Em **Conteúdo entregue**, marque os cursos que a venda libera e defina o **Tempo de acesso** e a **Liberação** de cada um. Se quiser, marque também as **Tags** que o aluno ganha.
6. Clique em **Salvar**.
7. No bloco **Conexão com o gateway**, copie a **URL de Postback**. Ela aparece depois de salvar e termina com o token desta entrega: copie o endereço inteiro.

:::aviso Produtos com variações
Se o produto tem variações (IDs de oferta), cadastre na entrega **os dois**: o ID principal do produto e o ID da variação, um por linha. A Cartpanda manda os dois IDs no mesmo aviso.
:::

## 2. Configure o webhook na Cartpanda

:::perigo Vendas retroativas
Assim que o webhook é salvo, a Cartpanda envia as vendas do dia de forma retroativa. Só conclua esta etapa quando as entregas, os cursos e a plataforma estiverem prontos para receber os alunos.
:::

1. Na Cartpanda, clique em **Notificações** e depois em **Configurar Webhooks**.
2. Clique em **Criar Webhook**. A Cartpanda pede **um webhook para cada evento**. Crie um para cada um destes:
  - Pedido pago
  - Pedido reembolsado
  - Pedido atualizado
  - Produto criado
  - Produto excluído
  - Produto atualizado
3. Em cada um, cole a URL de Postback da entrega no campo **Endpoint**.

## 3. Teste

1. Faça uma compra real de teste do produto.
2. No painel, abra **Vendas › Vendas** e confira se o envio chegou.
3. Se estiver como **Processada**, o acesso foi liberado. Se estiver **Com erro**, clique em **Ver detalhes** e leia o **Motivo do erro**. Corrija a causa (por exemplo, cadastrando na entrega o ID que veio no envio) e clique em **Reprocessar**.

Para a compra de teste, use um e-mail que não seja de um administrador da plataforma: vendas com e-mail de administrador não são processadas.

:::info Integração por leitura automática
A Cartpanda não tem integração dedicada: a plataforma lê o aviso enviado e reconhece sozinha os campos comuns, como e-mail, nome e CPF do cliente, código da venda, IDs de produto ou oferta e o status. Como cada gateway tem seus detalhes, valide com uma venda real antes de abrir as vendas. Se algum dado não for reconhecido, a venda aparece em **Vendas › Vendas** como **Com erro**, com o motivo, e os dados brutos ficam em **Ver detalhes**.
:::
