Manual da integração

Integração Asaas + MeuEcomm

Você fecha o pedido e a cobrança do seu cliente sai junto, sem abrir o banco, sem digitar valor e sem conferir extrato para dar baixa.Atualizado em 23/10/2026

Cobrança · asaas.com

Piloto

O MeuEcomm Connect está em fase de testes, liberado por enquanto apenas para empresas piloto do plano Business. As integrações e as telas ainda podem mudar durante esse período.

Nesta página+

Resumo

Com o Asaas conectado, o pedido fechado no MeuEcomm vira cobrança na sua conta Asaas: uma por parcela, com o vencimento de cada título. Quando o seu cliente paga, o título é baixado sozinho no financeiro do MeuEcomm. Você usa a sua própria conta Asaas, com as suas taxas. O MeuEcomm não passa pelo dinheiro.

O que faz e o que ainda não faz

O que a integração faz

Gera cobrança por PIX, boleto ou cartão para cada parcela pendente do pedido, com o vencimento do título.
Escolhe o tipo de cobrança pela forma de pagamento do pedido (conforme o vínculo que você configura).
Baixa o título no financeiro do MeuEcomm quando o pagamento é confirmado no Asaas.
Personaliza a descrição que o seu cliente vê na fatura.
Anexa o PDF do pedido na cobrança (opcional).
Permite atualizar o status e cancelar a cobrança de cada parcela.

O que ainda não faz

Não gera a cobrança sozinha quando o pedido é finalizado. A geração é pelo botão no pedido.
Não cancela nem bloqueia pedido ou cliente por atraso. Vencimento e estorno só atualizam o status da cobrança; a baixa acontece apenas com pagamento confirmado.
Não configura juros e multa pelo MeuEcomm (valem as regras da sua conta Asaas, veja Juros e multa).

Pré-requisitos

Conta MeuEcomm no plano Business com o Connect liberado.
Conta Asaas própria, com a chave de API.
Cliente do pedido com CPF ou CNPJ válido (o Asaas exige).
Formas de pagamento cadastradas no MeuEcomm com os dias das parcelas (ex.: "30,60,90").

Conectar a conta Asaas

1
No Asaas, vá em Configurações → Integrações, e na seção API clique em Gerar token de API. Copie a chave, que começa com $aact_.
2
No MeuEcomm, abra Conectar › Pagamentos e clique em Conectar no card do Asaas.
3
Cole a chave, escolha o ambiente (Sandbox para testar, Produção para cobrar de verdade) e salve.

Observação: Use o Sandbox para validar o fluxo inteiro antes de cobrar clientes reais. A chave do Sandbox é diferente da de Produção.

Vincular formas de pagamento

Para cada forma de pagamento do MeuEcomm, escolha o tipo de cobrança no Asaas: PIX, Boleto, Cartão ou deixar o cliente escolher na fatura.
Forma sem vínculo gera boleto.
O número de parcelas e os vencimentos vêm da forma de pagamento do pedido: "30/60/90" vira três cobranças, uma por vencimento.

Descrição da cobrança

É o texto que o seu cliente vê na fatura do Asaas. Em branco, vale a descrição do título (ex.: "João da Silva - Parcela 1/3"). Você pode montar o seu formato com estas variáveis:

Variável	O que entra
`{empresa}`	Nome fantasia da sua empresa
`{pedido}`	Número do pedido
`{cliente}`	Nome do cliente
`{documento}`	CPF/CNPJ do cliente
`{parcela}` / `{total_parcelas}`	Parcela atual e total
`{vencimento}`	Vencimento (dd/mm/aaaa)
`{valor}`	Valor da parcela
`{codigo_titulo}`	Código do título
`{forma_pagamento}`	Forma de pagamento

Exemplo: {empresa} | Pedido {pedido} | Parcela {parcela}/{total_parcelas} | Venc. {vencimento} vira Mac Fruit | Pedido 1042 | Parcela 1/3 | Venc. 08/02/2026. Limite de 500 caracteres.

Anexar o PDF do pedido

Com a opção ligada, o PDF do pedido (o mesmo da impressão) é anexado à cobrança, e o cliente baixa direto na fatura.
Opções: anexar só na primeira parcela, e deixar o PDF disponível só depois do pagamento.
Se o anexo falhar, a cobrança continua valendo. O modal mostra o aviso na parcela.

Atenção: O PDF tem itens, valores e dados do cliente, e a fatura do Asaas abre por um link público. Qualquer pessoa com o link consegue ver o anexo.

Juros e multa

As regras de juros e multa por atraso são as da sua conta Asaas e valem automaticamente para as cobranças geradas pelo MeuEcomm. Configure no painel do Asaas, em Configurações › Financeiro.

Configurar o aviso de pagamento (webhook)

É o que faz a baixa ser automática.

1
Na tela do Asaas no MeuEcomm, copie a URL do Webhook e o Token de Segurança.
2
No painel do Asaas, crie um webhook com essa URL e informe o token no campo "Token de autenticação".
3
Habilite os eventos de cobrança: criada, recebida, confirmada, vencida, removida e estornada.

Atenção: Sem o webhook, as cobranças são geradas normalmente, mas o título não é baixado sozinho quando o cliente paga.

Gerar a cobrança no pedido

1
Abra o pedido e clique em Ações › Cobranças (Asaas).
2
Clique em Gerar cobranças no Asaas. Uma cobrança é criada para cada parcela pendente.
3
Para cada parcela, o modal mostra o QR Code e o "copia e cola" do PIX, ou o link do boleto e da fatura, com valor, vencimento e status. Envie ao cliente como preferir.
4
Atualizar confere o status no Asaas na hora. A confirmação do pagamento pode levar alguns instantes.
5
Cancelar remove a cobrança de uma parcela que ainda não foi paga.

Gerar de novo não duplica: a parcela que já tem cobrança mostra a cobrança atual.

Problemas comuns

"O cliente precisa de um CPF/CNPJ válido para gerar a cobrança."

O que fazer:: Complete o cadastro do cliente.

"Nenhum título pendente para cobrar neste pedido."

O que fazer:: As parcelas já estão pagas, canceladas ou o pedido não gerou títulos.

"Não foi possível conectar ao Asaas. Verifique a API Key e o ambiente selecionado."

O que fazer:: A chave é de outro ambiente (Sandbox × Produção) ou foi revogada.

"Integração de pagamento não configurada. Ative em Conectar > Pagamentos."

O que fazer:: Conecte o Asaas no Connect.

Cliente pagou e o título continua em aberto

O que fazer:: Confira o webhook no painel do Asaas e use Atualizar no modal.

Desconectar

Em Conectar › Pagamentos › Asaas, desative a integração. As cobranças já criadas continuam no Asaas; o MeuEcomm deixa de gerar novas e de receber os avisos de pagamento.

Perguntas frequentes

Dúvidas comuns sobre a integração Asaas + MeuEcomm.

O MeuEcomm recebe o dinheiro das cobranças?

Não. As cobranças são geradas na sua própria conta Asaas, com as suas taxas, e o dinheiro cai direto nela. O MeuEcomm só cria a cobrança e recebe o aviso de pagamento para baixar o título.

A cobrança é gerada sozinha quando o pedido é finalizado?

Não. A geração é pelo botão Ações › Cobranças (Asaas) na tela do pedido. Gerar de novo não duplica: a parcela que já tem cobrança mostra a cobrança atual.

Posso testar antes de cobrar clientes de verdade?

Sim. Conecte com a chave do ambiente Sandbox do Asaas, valide o fluxo inteiro e depois troque para a chave de Produção.

A minha chave do Asaas fica segura?

A chave é guardada de forma criptografada e usada só nas chamadas da integração com o Asaas. Desativar a integração interrompe o uso da chave na hora.

Ficou alguma dúvida?

Abra um chamado no suporte do MeuEcomm. Se o problema aparece no Histórico ou numa mensagem da tela, mande o texto junto: ajuda a gente a responder mais rápido. Para participar do piloto do Connect, o caminho é o mesmo.

Falar com o suporte Criar conta grátis

Quer ver todas as integrações? Conheça o MeuEcomm Connect.

Outros manuais do Connect

Cada integração tem o seu manual, no mesmo formato.