Integrando com Asaas
A Ensinio permite que você utilize o checkout da Asaas para processar suas vendas mantendo a experiência de aprendizado na Ensinio.
Este artigo orienta como fazer as configurações necessárias para essa integração garantindo que o acesso dos alunos seja liberado ou bloqueado automaticamente de acordo com as transações ocorridas na Asaas.
Antes de prosseguir com este artigo, certifique-se de que já criou a integração na Ensinio.
Caso ainda não tenha feito, acesse o artigo: Checkout Externo: Integrando com Outra Plataforma de Vendas
Como configurar a integração na Ensinio
Ao clicar em Criar integração e selecionar a plataforma Asaas serão exibidos campos de preenchimento obrigatório e um link da URL de Webhook.
Nome da entrega
Você mesmo define esse nome, não vem da Asaas
Direto no campo "Nome da entrega", na integração da Ensinio
Identificar essa integração dentro do painel da Ensinio
Na cobrança criada na Asaas - é a "Descrição da cobrança"
No campo "Código do produto na plataforma", na integração da Ensinio
Conectar a cobrança da Asaas ao produto correspondente na Ensinio
Gerada automaticamente pela Ensinio ao criar a integração
No campo "URL" do webhook configurado na Asaas
Permite que a Asaas envie as notificações de pagamento para a Ensinio
Gerado no webhook configurado na Asaas
No campo "Token de autenticação", na integração da Ensinio
Autenticar as notificações recebidas, confirmando que vêm da Asaas
Gerada no painel da Asaas
No campo "Chave da API", na integração da Ensinio
Permitir que a Ensinio se comunique com a conta na Asaas
De acordo com a tabela acima, para configurar a integração com a Asaas na Ensinio é necessário antes obter algumas informações a partir das suas configurações na Asaas:
Código do produto na plataforma
Token de autenticação
Chave da API
O Nome da Entrega é um nome interno para identificar essa integração aqui na Ensinio. Exemplo: Asaas Curso de Marketing.
1. Código do produto na plataforma
Localize a "Descrição" da cobrança configurada na Asaas em Cobranças > Detalhes:
No campo "Código do produto na plataforma", insira a "Descrição" da cobrança.
Diferente de outras plataformas, na Asaas esse campo não é um código gerado automaticamente. Ele precisa ser preenchido com a descrição exata do produto, tal como está cadastrada na sua conta Asaas - qualquer diferença (mesmo de espaçamento ou pontuação) pode impedir que a entrega seja reconhecida corretamente.
2. Token de autenticação
Antes de configurar a integração na Ensinio, é necessário configurar um webhook na Asaas para que ela nos envie notificações referentes aos eventos relacionados às vendas, reembolsos, cancelamentos, chargebacks.
Para criar o webhook e gerar o token de autenticação:
Clique no ícone do seu perfil.
Selecione Integrações.
Nomeie o webhook e selecione uma versão de API que tenha todas as permissões necessárias para cobranças e assinaturas.
Em "Tipo de envio" selecione o "Não sequencial".
Clique em "Gerar Token".
Copie o Token de autenticação assim que for criado porque não é possível visualizá-lo novamente depois.
Cole o Token de autenticação na página da integração na Ensinio.
Aproveite também para copiar o link disponibilizado na página da integração na Ensinio e colar na "URL do Webhook" nas configurações do webhook na Asaas.
Formato da "URL do Webhook" exibida na página de integração na Ensinio:
https://suaplataforma.ensinio.cloud/api/v2/postback/asaas
Adicionando o token de autenticação e a URL do Webhook
Agora falta apenas preencher o campo "Chave da API" na página de integração da Ensinio, mas antes vamos finalizar a configuração do webhook adicionando os eventos necessários.
Quais eventos adicionar no webhook?
Na Asaas, marque os seguintes eventos para que a integração funcione corretamente:
Cobranças
PAYMENT_CONFIRMED
Cobrança confirmada (pagamento efetuado, porém o saldo ainda não foi disponibilizado) - libera o acesso ao curso.
PAYMENT_RECEIVED
Cobrança recebida - libera o acesso ao curso.
PAYMENT_REFUNDED
Cobrança estornada - bloqueia o acesso do aluno ao curso.
PAYMENT_CHARGEBACK_REQUESTED
Chargeback recebido - bloqueia o acesso do aluno ao curso.
Assinaturas (recorrência)
SUBSCRIPTION_CREATED
Geração de nova assinatura.
SUBSCRIPTION_UPDATED
Alteração na assinatura - mantém o acesso ativo.
SUBSCRIPTION_INACTIVATED
Assinatura inativada - cancela a recorrência.
SUBSCRIPTION_DELETED
Assinatura removida - cancela a recorrência.
3. Chave da API
Preencha o campo "Chave da API" com a chave de integração fornecida pela Asaas.
Essa chave é necessária para que a Ensinio consiga se comunicar com a Asaas e validar as informações recebidas.
Clique no ícone de perfil.
Clique em "Integrações".
Em “Chaves de API”, clique em "Gerar chave de API".
Siga todos os passos orientados pela Asaas.
Copie a chave API e cole no campo "Chave da API" na Ensinio:
Configurando a expiração da inscrição
Na seção "Expiração da inscrição", você define por quanto tempo o usuário terá acesso ao conteúdo após a compra.
Se o acesso for vitalício, mantenha a opção "Habilitar expiração da inscrição" desativada.
Se o acesso for por tempo limitado, ative a opção e defina o período de acesso.
Essa configuração é recomendada para venda de produtos de pagamento único, já que o checkout externo não envia a expiração do acesso automaticamente.
Selecionando o grupo que o usuário receberá acesso
Na seção "Grupo que o usuário receberá acesso", clique em "+ Selecionar grupo".
Escolha o grupo ao qual o usuário deverá ter acesso após a compra ser confirmada pela Asaas.
Com tudo preenchido, clique em "Salvar", no canto superior direito, para concluir a configuração.
Você pode criar mais de uma entrega para o mesmo grupo caso o mesmo produto seja vendido em plataformas diferentes.
A integração funcionou?
Faça testes de compra, para verificar se o acesso será criado na Plataforma corretamente.
Checklist rápido: Integração com Asaas
Antes de começar
Na Asaas
Na Ensinio
Por fim
Checkout Externo: Integrando com a Asaas
A Ensinio permite que você utilize o checkout da Asaas para processar suas vendas e, ao mesmo tempo, entregue o acesso ao conteúdo automaticamente na sua plataforma. Assim, você mantém a experiência de aprendizado na Ensinio sem abrir mão da receita de vendas processada pela Asaas.
Antes de configurar a integração na Ensinio
Antes de configurar a integração aqui na Ensinio, é necessário configurar um webhook na Asaas para que ela envie notificações referentes aos eventos de quando um pedido for:
Aprovado - cria a inscrição e libera o acesso ao curso.
Reembolsado/Cancelado - bloqueia o acesso do aluno ao curso.
Sofrer um chargeback - bloqueia o acesso do aluno ao curso.
Caso a venda seja por recorrência, selecione também os eventos de:
Assinatura renovada - mantém o acesso ativo para cursos recorrentes.
Assinatura cancelada - cancela uma recorrência.
Acessando os Checkouts Externos
No "Admin Console", clique no ícone "App Store" no menu lateral esquerdo.
Clique em "Checkouts externos".
Clique em "+ Criar uma integração externa".
Uma janela será exibida com informações sobre a funcionalidade. Leia o aviso e clique em "Entendi, quero continuar" para prosseguir.
A notificação de criação de acesso pode levar entre 3 e 7 minutos após a compra ser aprovada na Asaas. Se quiser que o acesso seja imediato, considere criar a oferta diretamente na Ensinio.
Configurando a entrega
Após clicar em "Entendi, quero continuar", você será direcionado para a tela "Criando uma entrega".
No campo "Nome da entrega", digite um nome para identificar essa integração. Exemplo: Asaas - Curso de Marketing.
No campo "Código do produto na plataforma", insira a descrição exata do produto cadastrado na Asaas.
Diferente de outras plataformas, na Asaas esse campo não é um código gerado automaticamente. Ele precisa ser preenchido com a descrição exata do produto, tal como está cadastrada na sua conta Asaas - qualquer diferença (mesmo de espaçamento ou pontuação) pode impedir que a entrega seja reconhecida corretamente.
Selecionando a plataforma
Na seção "Selecione a plataforma", clique em "Asaas".
Ao selecionar, a plataforma exibirá a confirmação "Você selecionou 'Asaas'", junto com os campos específicos da integração.
URL de postback
Será exibida a URL de postback, no formato:
https://plataformacs.ensinio.cloud/api/v2/postback/asaas
Copie esse link e cadastre-o na Asaas, em Configurações > Webhooks (ou seção equivalente). É por meio dessa URL que a Asaas notificará a Ensinio quando uma venda for aprovada, reembolsada, cancelada ou sofrer chargeback.
Token de autenticação
Preencha o campo "Token de autenticação" com o token gerado na Asaas.
Esse token garante que apenas a Asaas consiga enviar notificações para a sua plataforma Ensinio.
Chave da API
Preencha o campo "Chave da API" com a chave de integração fornecida pela Asaas.
Essa chave é necessária para que a Ensinio consiga se comunicar com a Asaas e validar as informações recebidas.
Tanto o token de autenticação quanto a chave da API são gerados dentro da própria conta Asaas, geralmente em configurações de integração ou API. Consulte a documentação da Asaas caso tenha dúvidas sobre onde encontrar cada um deles.
Configurando a expiração da inscrição
Na seção "Expiração da inscrição", você define por quanto tempo o usuário terá acesso ao conteúdo após a compra.
Se o acesso for vitalício, mantenha a opção "Habilitar expiração da inscrição" desativada.
Se o acesso for por tempo limitado, ative a opção e defina o período de acesso.
Essa configuração é recomendada para venda de produtos de pagamento único, já que o checkout externo não envia a expiração do acesso automaticamente.
Selecionando o grupo que o usuário receberá acesso
Na seção "Grupo que o usuário receberá acesso", clique em "+ Selecionar grupo".
Escolha o grupo ao qual o usuário deverá ter acesso após a compra ser confirmada pela Asaas.
Com tudo preenchido, clique em "Salvar", no canto superior direito, para concluir a configuração.
Você pode criar mais de uma entrega para o mesmo grupo caso o mesmo produto seja vendido em plataformas diferentes.
Last updated