# Braip

> Veja como conectar a sua plataforma com a Braip.

Com esta integração, cada venda aprovada na Braip 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 **Braip**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **Código do Produto ou Plano**, cole o código do produto ou do plano na Braip. Para achar: no painel da Braip, clique em **Produtos › Meus produtos**. O código do produto aparece logo abaixo do nome. Para o código do plano, abra o produto, vá na aba **Planos** e copie a coluna **Código**. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. No campo **Token**, cole a **Chave única** da Braip. Para achar: em **Ferramentas › Postback**, abra a guia **Documentação**. Com o token preenchido, a plataforma confere essa chave em cada venda recebida.
6. 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.
7. Clique em **Salvar**.
8. 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.

## 2. Configure o webhook na Braip

Se você já criou um postback na Braip com a opção de todos os produtos, apontando para esta entrega, pule esta etapa.

1. No painel da Braip, clique em **Ferramentas** e depois em **Postback**.
2. Clique em **Nova Configuração** (botão **+**, no canto superior direito).
3. Em **URL de retorno**, cole a URL de Postback da entrega.
4. Marque os eventos:
  - Pagamento aprovado
  - Cancelada
  - Chargeback
  - Devolvida
5. Se o produto for uma assinatura, marque também os eventos de assinatura:
  - Ativa
  - Atrasada
  - Cancelada pelo suporte
  - Cancelada pelo cliente
  - Cancelada pela plataforma
  - Inativa
  - Vencida
6. Em **Método HTTP**, escolha **POST**.
7. Clique em **Salvar**.

:::dica Um postback por produto
Se você não entrega todos os produtos da Braip pela sua plataforma, em **Produto** selecione só os que serão entregues. Lembre de incluir os novos produtos nessa configuração quando começar a entregá-los.
:::

## 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 Braip 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**.
:::