Pular para o conteúdo

Asaas

Veja como conectar a sua plataforma com o Asaas.

Nesta página

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.

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

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.

Esta página ajudou?

Artigos relacionados