# Asaas

> Veja como conectar a sua plataforma com o Asaas.

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

:::embreve Integração completa com o Asaas
O aviso de cobrança do Asaas não traz o e-mail do cliente, e a plataforma ainda não consulta a API do Asaas para buscar esses dados. Enquanto isso, as vendas do Asaas chegam em **Vendas**, mas tendem a ficar **Com erro** com o motivo "Venda sem e-mail válido do cliente". Nesse caso, libere o acesso pelo perfil do aluno (aba **Compras**, botão **Adicionar entrega**).
:::

## 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 **Asaas**.
3. Dê um nome à entrega e escolha a **Modalidade de Venda**: **Venda única** ou **Assinatura**.
4. No campo **ID do link de pagamento**, cole o ID do link de pagamento do Asaas. Para achar: no Asaas, abra **Links de Pagamento** no menu lateral, crie ou selecione um link, clique em **Compartilhar** e em **Copiar link**. O ID são os caracteres depois da última barra ( / ) do endereço. Se mais de um ID deve liberar a mesma coisa, coloque um por linha.
5. Deixe o campo **API Token** em branco por enquanto (veja o aviso no fim desta página). Quem autoriza as vendas é o token que vai no fim da URL de Postback.
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 Asaas

1. No Asaas, clique na foto do seu perfil (canto superior direito) e depois em **Integrações**.
2. Abra **Webhook** e clique em **Adicionar Webhook**. Use a versão **V3**.
3. Dê um nome ao webhook (ex.: *Plataforma de cursos*).
4. No campo **URL**, cole a URL de Postback da entrega.
5. Em **Fila de Sincronização Ativa**, escolha **Sim**.
6. Em **Tipo de Envio**, escolha **Sequencial**.
7. Em **Cobranças**, escolha **Todos os eventos**.
8. Clique em **Salvar**.

:::aviso Fila do Asaas
Com envio sequencial, um erro de entrega no Asaas pode travar a fila de webhooks e segurar os envios seguintes. Acompanhe a fila no painel do Asaas: se ela parar, as vendas não chegam à sua plataforma.
:::

## 3. Teste

1. Faça uma cobrança de teste pelo link de pagamento cadastrado na entrega.
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 Asaas 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**.
:::

### Sobre o campo API Token

O campo **API Token** existe na entrega do Asaas, mas a plataforma ainda não usa essa chave para buscar os dados da venda. Se você preencher o campo, a plataforma passa a exigir que esse mesmo valor venha em cada aviso, e as vendas podem ser recusadas com "Token do gateway não confere". Por isso, por enquanto, deixe-o em branco e use a URL de Postback completa.