Introdução

Esta página apresenta a integração entre Digital Manager Guru e Asaas, explicando como ela funciona, quais recursos podem ser utilizados e quais configurações são necessárias para iniciar a operação.

A Digital Manager Guru é uma plataforma de checkout e gestão de vendas online utilizada por produtores digitais, negócios de recorrência, empresas de software, lojas de produtos físicos, cursos online, treinamentos, consultorias e operações com afiliados.

Com a integração entre Guru e Asaas, é possível processar pagamentos através do Checkout Guru utilizando os recursos financeiros do Asaas.

O que a integração permite fazer

A integração Guru + Asaas permite:

processar pagamentos de vendas avulsas;
criar e gerenciar assinaturas;
aceitar Pix, boleto bancário e cartão de crédito;
utilizar parcelamento em pagamentos com cartão;
pagar comissões para afiliados e coprodutores utilizando Split de pagamentos;
centralizar a gestão de vendas, assinaturas, campanhas e métricas na Guru.

Quando utilizar

A integração é indicada para empresas que desejam vender online utilizando uma solução pronta de checkout, sem necessidade de desenvolver uma integração própria com a API do Asaas.

Ela pode ser utilizada em cenários como:

venda de produtos digitais;
venda de produtos físicos através de páginas de venda;
cursos, treinamentos e consultorias;
clubes de assinatura;
empresas SaaS;
programas de afiliados;
operações com coprodutores;
eventos e venda de ingressos.

Como funciona o fluxo da integração

Após configurar a integração, a Guru passa a utilizar a conta Asaas informada para processar os pagamentos das vendas realizadas no Checkout Guru.

Uma jornada típica segue o seguinte fluxo:


Criar ou acessar conta Asaas

↓

Gerar API Key de produção

↓

Configurar a API Key no painel da Guru

↓

Cadastrar produtos e ofertas

↓

Vincular a oferta ao Asaas

↓

Divulgar o link de checkout

↓

Receber pagamentos

↓

Acompanhar vendas, assinaturas e comissões

Requisitos para ativação

Antes de iniciar a configuração, é necessário ter:

uma conta Asaas ativa;
uma conta Digital Manager Guru;
API Key de produção do Asaas;
produtos ou ofertas cadastrados na Guru;
definição das formas de pagamento que serão disponibilizadas no checkout.

🚧
Atenção
Não é possível conectar mais de uma conta Guru à mesma conta Asaas.

Formas de pagamento disponíveis

No Checkout Guru integrado ao Asaas, é possível aceitar pagamentos por:

Pix;
boleto bancário;
cartão de crédito.

Também é possível configurar parcelamento para pagamentos com cartão de crédito e descontos para pagamento à vista nas configurações da oferta do produto.

Configurações importantes

Durante a ativação da integração na Guru, alguns campos influenciam diretamente o comportamento do checkout:

Chave API: credencial de produção gerada no Asaas.
Prazo do Pix: prazo de vencimento do Pix, em dias.
Prazo do boleto: prazo de vencimento do boleto bancário, em dias.
Notificações padrão do Asaas: permite o envio de notificações de cobrança ao comprador.
Vendas sem endereço: define se a Guru permitirá vendas sem preenchimento de endereço.
Status ativo: habilita a integração para uso no checkout.

Como obter a API Key no Asaas

Para ativar a integração, é necessário gerar a API Key de produção no Asaas.

Acesse o dashboard do Asaas.
Clique em Minha Conta.
Acesse a aba Integração.
Clique em Gerar API Key.
Copie e armazene a chave gerada em local seguro.

📘
Importante
A API Key permite realizar operações na conta Asaas. Por isso, ela deve ser armazenada com segurança e não deve ser exposta em locais públicos, prints, logs ou ferramentas compartilhadas.

Como ativar a integração na Guru

Após obter a API Key do Asaas:

Acesse o admin da Guru.
Acesse Configurações > Integrações > Checkout Guru > Asaas.

Informe a API Key gerada no Asaas.
Configure os prazos de vencimento para Pix e boleto.
Defina se deseja ativar as notificações padrão do Asaas.
Defina se deseja permitir vendas sem endereço.
Ative a integração.
Clique em Enviar.

Após salvar a configuração, os dados da conta Asaas deverão ser exibidos na aba de detalhes da integração na Guru.

Cadastro de produtos e ofertas

Com a integração ativa, o próximo passo é cadastrar os produtos e suas ofertas na Guru.

Ao configurar uma oferta, é importante:

vincular o produto ao Asaas;
definir se a venda será avulsa ou recorrente;
configurar as formas de pagamento disponíveis;
definir regras de parcelamento, quando aplicável;
gerar e divulgar o link de checkout.

Após a configuração da oferta, o link de checkout poderá ser divulgado para os compradores.

Split de pagamentos

A integração Guru + Asaas permite utilizar Split de pagamentos para distribuir automaticamente valores entre os participantes da venda, como afiliados e coprodutores.

Esse recurso é útil em operações que possuem:

afiliados;
coprodutores;
parceiros comerciais;
divisão de receita entre participantes da venda.

📘
Importante
As regras de comissionamento devem ser configuradas na Guru conforme o modelo operacional da venda.

Comportamentos importantes

Ao operar com a integração Guru + Asaas, considere que:

os pagamentos são processados na conta Asaas configurada na Guru;
vendas avulsas e assinaturas seguem comportamentos diferentes;
prazos de Pix e boleto influenciam o vencimento das cobranças;
notificações podem ser enviadas ao comprador conforme configuração realizada;
alterações em produtos, ofertas e formas de pagamento devem ser feitas na Guru;
a conciliação financeira deve considerar as informações disponíveis no Asaas e na Guru.

Boas práticas

Utilize sempre a API Key de produção da conta Asaas correta.
Armazene a API Key em local seguro.
Valide os prazos de vencimento de Pix e boleto antes de divulgar o checkout.
Teste o fluxo de pagamento antes de iniciar a operação comercial.
Revise as configurações de oferta, parcelamento e descontos.
Confirme se o produto está vinculado ao Asaas antes de divulgar o link.
Valide as regras de comissão antes de utilizar Split de pagamentos.
Mantenha os dados da conta Asaas atualizados.

Erros comuns

API Key inválida ou incorreta

Pode ocorrer quando a chave informada na Guru não corresponde à conta Asaas correta ou foi copiada incorretamente.

Integração inativa

Pode ocorrer quando a configuração foi preenchida, mas a integração não foi ativada na Guru.

Produto não vinculado ao Asaas

Pode impedir que a oferta utilize corretamente o Asaas como processador de pagamento.

Prazo de vencimento incorreto

Pode gerar cobranças Pix ou boleto com vencimento diferente do esperado pela operação.

Configuração incompleta da oferta

Pode impedir a geração correta do link de checkout ou limitar as formas de pagamento disponíveis.

Próximos passos

Após ativar a integração, recomenda-se:

cadastrar ou revisar os produtos na Guru;
configurar as ofertas;
definir formas de pagamento;
revisar regras de parcelamento e descontos;
configurar comissões e Split de pagamentos, quando aplicável;
gerar o link de checkout;
realizar uma venda de teste antes de divulgar o checkout oficialmente.

Fonte: Digital Manager Guru.

Em caso de qualquer dúvida sobre a integração, clique aqui.