Integração com o Asaas
Com o Asaas conectado, você gera cobranças por Pix, boleto ou cartão de crédito direto de um lançamento de receita. O cliente recebe o link de pagamento e, quando ele paga, o lançamento no Mekan Foto é atualizado sozinho.
Conectar a sua conta
- Acesse Configurações › Integrações e abra o card Asaas.
- Ainda não tem conta? Use Criar conta gratuita no Asaas, no quadro Ainda não tem conta? (ele mostra as tarifas de Pix, boleto e cartão).
- Em Conectar sua conta, clique em Abrir chaves de API e gere uma chave no painel do Asaas (Configurações › Integrações › Chaves de API).
- Cole a chave no campo Chave de API e clique em Conectar conta Asaas.
Ao colar, o Mekan Foto mostra de qual ambiente é a chave:
- Produção: as cobranças são reais.
- Chave de sandbox (começa com
$aact_hmlg_): as cobranças vão para o ambiente de testes do Asaas, sem dinheiro real. Use para testar o fluxo antes de cobrar clientes de verdade. Na tela da integração aparece o selo Sandbox, e o Abrir painel do Asaas (assim como o Ver no Asaas das cobranças) leva ao painel do sandbox.
Se a integração cair (chave expirada, desativada ou excluída no Asaas), a tela mostra Integração desconectada com o motivo. Novas cobranças ficam pausadas até você conectar uma chave válida.
Só quem tem a permissão de ver as Integrações acessa essa tela.
Depois de conectado
- Card do Asaas (no topo): mostra o status (Conectado, Requer atenção ou Chave inválida), o e-mail da conta, a chave de API mascarada e o ID da conta, com o botão Abrir painel do Asaas.
- Avisos da chave: se a chave estiver expirando, expirada, desativada ou excluída, um aviso no topo pede para gerar uma nova no Asaas. Clique em Trocar chave de API, cole a nova chave e clique em Salvar nova chave — as preferências e o histórico continuam. Se aparecer Não foi possível verificar a chave, o Asaas só não respondeu à verificação (falha de conexão): a chave continua conectada e não precisa ser trocada.
- Webhook: é o canal pelo qual o Asaas avisa o Mekan Foto sobre pagamentos. Funcionando, aparece Ativo ("Recebendo as notificações de cobranças"). Se aparecer Webhook interrompido pelo Asaas, Nenhum webhook configurado, Webhook não encontrado no Asaas, Webhook desativado no Asaas ou Webhook desatualizado, clique no botão do card (Reativar webhook, Ativar webhook ou Atualizar webhook). Sem webhook, os pagamentos não dão baixa sozinhos e novas cobranças ficam desativadas.
- Preferências:
- Excluir o lançamento quando a cobrança for excluída no Asaas: se você excluir a cobrança no painel do Asaas, o lançamento correspondente também é excluído.
- Silenciar notificações de cobranças no app: desliga os avisos no app sobre pagamentos, exclusões, restaurações etc. O histórico continua sendo registrado.
- Histórico de eventos: lista os eventos recebidos do Asaas (pagamentos, vencimentos, exclusões…), com o lançamento e o cliente.
- Desconectar: pede confirmação e encerra a integração. A chave é apagada do Mekan Foto, o webhook é removido do Asaas e novas cobranças ficam pausadas.
Emissão de notas fiscais, negativação e configuração de juros e multa são feitas diretamente no painel do Asaas.
Gerar uma cobrança
- Crie um lançamento de Receita em Financeiro › Movimentações › Nova Movimentação (ou em Novo Lançamento, no detalhe do contrato).
Criando o contrato por um pacote? Cada lançamento de receita do pacote tem a opção Gerar cobrança no Asaas, e as cobranças saem junto com o contrato. Veja Criar contratos com pacotes.
- Na seção Valor e pagamento, depois do valor, ligue Cobrar via Asaas.
- Escolha a Forma de Cobrança:
- Todas as formas (cliente escolhe)
- Boleto / PIX
- Cartão de Crédito
- Selecione um cliente com CPF/CNPJ cadastrado: sem documento, a cobrança não pode ser criada. O Mekan Foto verifica se o cliente já existe no Asaas; se for um cliente novo lá, você pode marcar Desativar notificações do Asaas para este cliente.
- Preencha valor, vencimento e descrição e clique em Cadastrar Lançamento.
Ao salvar, aparece a confirmação Cobrança Asaas Criada com o link para compartilhar com o cliente.
Algumas regras:
- O vencimento não pode ser anterior a hoje.
- Com a cobrança ligada, a forma de pagamento, a data de pagamento e o campo Informações de Pagamento somem do formulário: quem cuida disso é o Asaas.
- O Asaas cobra tarifas pelo envio de notificações. Consulte antes de criar a cobrança.
Cobranças parceladas
Com Sinal + Parcelas, cada parcela, inclusive o sinal, vira uma cobrança independente no Asaas, com vencimento e link próprios.
Com Parcelado, escolha em Definição das parcelas:
- Parcelas definidas pela Mekan (padrão): cada parcela vira uma cobrança separada, com vencimento e link próprios, na frequência que você escolher. O cliente recebe uma fatura por parcela, e não um único link para pagar em várias vezes.
- Parcelas definidas pelo Asaas: o Asaas gera as faturas mensais e agrupa as parcelas no mesmo link de pagamento. A frequência é sempre mensal.
Em ambos, cada parcela precisa ter pelo menos R$ 5,00 e nenhuma pode vencer antes de hoje. Veja mais em Parcelamento e sinal.
Link de pagamento
Use o link de pagamento quando o cliente não tem CPF/CNPJ cadastrado ou quando você quer que o próprio cliente escolha em quantas vezes pagar. Ele é gerado no lançamento de receita, em Cobrar via Asaas › Como cobrar › Link de pagamento (na edição, Gerar link de pagamento).
Opções:
- Título exibido ao cliente: começa igual à descrição do lançamento; se você editar, passa a ser só do link. A descrição continua interna.
- Formas aceitas: todas, Boleto / PIX ou Cartão de Crédito.
- Parcelamento: até quantas vezes o cliente pode pagar. Cada parcela precisa ter no mínimo R$ 5,00 — para liberar mais opções, aumente o valor do lançamento.
- Prazo do boleto: dias úteis para pagar depois que o cliente gera o boleto.
- Link válido até: opcional. Em branco, o link não expira.
- Desativar notificações do Asaas para quem pagar.
Quando o cliente paga, o lançamento vira as parcelas que ele escolheu (por exemplo, 4x no cartão vira 4 parcelas, com a mesma soma), cada uma com o vencimento e o status do Asaas. No cartão parcelado você recebe um e-mail só. O link é de uso único: depois que o cliente gera a cobrança, ele aparece como Link utilizado e é desativado sozinho no Asaas. No boleto e no Pix, as parcelas ficam pendentes até o pagamento cair.
Enquanto o link está aberto, valor e parcelamento ficam travados no lançamento. Para mudar, clique em Desativar link, ajuste o lançamento e use Gerar novo link.
- Link expirado: use Renovar validade (com nova data ou sem validade).
- Desativado (por você ou no painel do Asaas): use Gerar novo link.
- O cliente pagou e o lançamento não mudou (por exemplo, com a integração desconectada na hora)? Reconecte e clique em Verificar pagamento (link ainda aberto) ou Sincronizar pagamento.
Avisos que podem aparecer:
- Outro pagamento pelo mesmo link (o cliente pagou duas vezes, em duas abas): o segundo fica registrado como aviso para você conferir e estornar no Asaas, sem dividir o lançamento de novo.
- Lançamento já marcado como pago antes do pagamento pelo link: nada é dividido, e o aviso pede para você conferir.
- Pagamento depois que o lançamento foi excluído (o cliente estava na tela de pagamento quando você excluiu o lançamento): a cobrança existe no Asaas, mas não entra no lançamento. Confira no Asaas e estorne, ou registre manualmente. Se você só desativou o link e o cliente pagou logo antes, o pagamento entra normalmente no lançamento.
- Um pagamento pode não ter sido registrado: o Asaas avisou de um pagamento que o Mekan Foto não conseguiu processar. Abra o lançamento com link e clique em Verificar pagamento. Esse aviso chega no máximo uma vez por dia.
Com o link aberto, marcar como pago ou não pago (inclusive em massa e na página do contrato) e redistribuir valores entre parcelas ficam bloqueados: desative o link antes. E se o lançamento foi alterado em outro lugar (outra aba, outro usuário, ou um pagamento que chegou) depois que você abriu o formulário, o Mekan Foto não salva por cima: feche e abra de novo para ver a versão atual.
No portal do cliente, o lançamento com link aberto mostra o botão Pagar fatura. Excluir o lançamento desativa o link no Asaas antes. Quem não tem a permissão Criar cobranças Asaas vê o link existente, mas não gera um novo.
Acompanhar uma cobrança
Abra o lançamento para ver o quadro Cobrança Asaas, com:
- o status (Aguardando pagamento, Vencido, Pagamento confirmado, Recebido, Recebido em dinheiro, Estornado e outros);
- os botões Copiar Link, Abrir Fatura, Abrir Comprovante (depois do pagamento) e Ver no Asaas;
- o ícone Sincronizar status com Asaas, para buscar a situação atual na hora;
- o histórico de eventos daquela cobrança.
Valor, vencimento e data de pagamento passam a ser gerenciados pelo Asaas. Estornos e alterações são feitos no painel do Asaas, e o novo status chega ao Mekan Foto pelo webhook.
Recebeu em dinheiro?
Na tabela de Movimentações, ao marcar como pago um lançamento com cobrança Asaas, aparece Confirmar recebimento em dinheiro?. Escolha a Data do recebimento, decida se quer Notificar cliente pelo Asaas sobre o recebimento e clique em Confirmar no Asaas: o pagamento é registrado como recebido em dinheiro também no Asaas.
Excluir
Ao excluir um lançamento com cobrança, a cobrança é cancelada automaticamente no Asaas. Num parcelamento, você pode excluir todas as parcelas, e as cobranças pendentes do grupo são canceladas.
Cobrar pelo WhatsApp
Na aba Pendências, o botão de WhatsApp pode enviar o link da cobrança usando a variável {link} da mensagem de cobrança. Veja Pendências de pagamento.
Permissões
Em Configurações › Equipe, nas permissões de cada usuário, seção Financeiro:
- Criar cobranças Asaas: libera a opção Cobrar via Asaas nos lançamentos e Gerar cobrança no Asaas nos lançamentos do contrato por pacote.
- Emails de cobrança Asaas: o usuário passa a receber os e-mails sobre as cobranças (o administrador da conta sempre recebe).
As duas vêm bloqueadas por padrão para novos membros.