Visão geral
A cobrança é o coração do módulo. Você cria uma cobrança com valor, descrição e itens, escolhe o método (PIX, boleto ou cartão via checkout hospedado) e a envia direto na conversa. O cliente recebe um cartão de pagamento na própria janela — com QR Code e copia-e-cola do PIX, a linha digitável do boleto ou o link do checkout — e o status é atualizado quando o gateway confirma.
Há três formas de partir para uma cobrança: avulsa (digita os valores), a partir do catálogo (escolhe produtos prontos) ou a partir de um negócio do CRM (reaproveita o valor já registrado).
Pré-requisitos
- Um gateway conectado e válido (veja Conectar gateway).
- Para cobrar do catálogo, o módulo de Catálogo habilitado e produtos cadastrados.
- Para cobrar de um negócio, o módulo de CRM habilitado e um negócio com valor.
- Um contato com dados mínimos (nome e, idealmente, e-mail e telefone) para o cliente do gateway.
Passo a passo
- Em uma conversa, abra a ação de criar cobrança (ou crie pela área de Pagamentos).
- Escolha a origem do valor:
- Avulsa: informe valor, descrição e, se quiser, itens (linhas de cobrança).
- Catálogo: selecione os produtos; o valor é somado automaticamente.
- Negócio: selecione um negócio do CRM; o valor é reaproveitado.
- Selecione o método de pagamento: PIX, boleto ou cartão (checkout hospedado).
- (Opcional) Aplique desconto ou ajuste o valor — veja Descontos e ajuste de valor.
- Defina o vencimento, quando aplicável.
- Crie a cobrança. A plataforma gera o PIX (QR + copia-e-cola), o boleto (linha digitável) ou o link do checkout, conforme o método.
- Envie na conversa: o cartão de pagamento aparece para o cliente na mesma janela. Em pagamentos PIX, o rótulo e o código aparecem separados para facilitar a leitura; mesmo um código longo permanece dentro do card. Use a ação de copiar para levar o código completo.
- Acompanhe o status mudar de pendente para pago automaticamente quando o gateway confirmar.
Configurações & opções
Cobrar uma empresa (PJ)
- Escolha o contato responsável. Na conversa, esse contato permanece como contexto do atendimento.
- Em Pagador, escolha Empresa e selecione uma empresa vinculada ao contato. Essa escolha é explícita: o vínculo do CRM ou um produto do catálogo não define sozinho quem paga.
- Confira o cadastro da empresa: razão social e CNPJ, além de e-mail, telefone e endereço exigidos pelo gateway e pelo método. Os dados fiscais do pagador vêm da empresa escolhida; os dados pessoais do contato não substituem esse cadastro.
- Se a lista estiver carregando ou falhar, aguarde ou use Tentar novamente. A plataforma não transforma uma falha de carregamento em ausência de empresas. Empresa sem cadastro obrigatório completo não deve ser faturada como contato para contornar o erro.
A criação em contexto de conversa continua exigindo o contato responsável. Uma assinatura importada ou registrada sem contato não equivale a um fluxo completo de atendimento na conversa. No Asaas, não presuma que alterar a empresa na plataforma sincroniza automaticamente todos os dados de um cliente já existente: confira razão social, e-mail e endereço também no gateway.
Planos de cobrança e carnê
Um plano de cobrança reúne as parcelas de uma única venda. O total contratado e o valor já recebido são informações diferentes: uma parcela paga não significa que o plano inteiro foi quitado. Cada parcela mantém vencimento, pagamento e histórico próprios.
- Métodos: PIX (QR Code + copia-e-cola), boleto (linha digitável/PDF) e cartão via checkout hospedado — a plataforma nunca pede o número do cartão.
- Itens (linhas de cobrança): descreva cada produto/serviço com quantidade e valor; o total é a soma das linhas.
- Vencimento: data limite para PIX/boleto.
- Opções avançadas do Asaas: multa e juros em percentual e desconto por pagamento antecipado podem ser definidos na cobrança; o envio impresso pelos Correios aparece somente para boleto. Esse desconto é uma condição de pagamento; ele não substitui o desconto comercial aplicado ao valor da cobrança. Deixar um campo em branco não envia uma substituição explícita. Confira o padrão da conexão e o painel do gateway. Zero é um valor explícito; confirme o resultado no gateway antes de prometer isenção de multa ou juros.
- Retorno do Asaas: informe uma URL HTTPS pública para levar o pagador de volta ao seu site. A opção de redirecionamento automático só é enviada quando há uma URL válida.
- Checkout Mercado Pago: no cartão hospedado, escolha o limite de parcelas e, se necessário, informe URLs HTTPS separadas para pagamento aprovado, recusado e pendente. O retorno automático exige a URL de aprovado.
- Gate por conexão: a tela mostra somente recursos anunciados pelo gateway escolhido. A API também recusa uma opção incompatível; esconder um campo não é a única proteção.
- Marcar como pago manualmente: registre pagamentos recebidos por fora (quando o gateway suportar), para manter o histórico coerente.
- Reenviar: é possível reenviar o cartão de pagamento na conversa a qualquer momento.
- Dados do pagador automáticos: quando o pagador é Pessoa/Contato, CPF/CNPJ e endereço vêm dos dados nativos do contato (o documento já vem preenchido para você conferir; endereço de cobrança tem prioridade sobre o principal). Preencha uma vez no contato e nunca mais redigite — veja Dados fiscais e endereço do contato.
Ver detalhes e histórico
Na lista de cobranças, clique no cliente para abrir o detalhe — inclusive em cobranças PIX ou lançadas manualmente, que não possuem uma página hospedada. A ação principal acompanha o que a cobrança realmente permite: copiar o código PIX, abrir boleto/checkout ou, quando o Asaas autorizar e a cobrança estiver aberta, marcar como paga manualmente com justificativa.
O histórico mostra os eventos mais recentes primeiro, identifica operador ou sistema/gateway e exibe a justificativa registrada. Históricos longos são paginados; mudar de página não altera a cobrança. Use essa linha do tempo para conferir criação, atualização, pagamento, atraso, cancelamento e estorno sem depender apenas do status atual.
Pedido nativo do WhatsApp (WhatsApp Pay)
Quando a conexão do gateway está com o pagamento nativo do WhatsApp ligado, a cobrança chega ao cliente pela API oficial como um pedido do WhatsApp, que ele paga sem sair do app. Esse pedido acompanha a cobrança:
- quando o pagamento é confirmado, a plataforma atualiza o pedido no WhatsApp do cliente, que passa a mostrar o selo pago;
- quando a cobrança é cancelada antes do pagamento, o pedido passa a cancelado e deixa de oferecer o pagamento.
A atualização só sai com a janela de atendimento de 24 horas aberta, porque o WhatsApp não aceita esse tipo de mensagem fora dela. Fora da janela, o cartão da cobrança na conversa continua mostrando o status certo.
O cliente recebe um aviso de pagamento, nunca dois: quando o pedido é atualizado para pago, essa atualização substitui a mensagem de confirmação de pagamento. A mensagem de confirmação sai no lugar dela quando o pedido não pode ser atualizado (cobrança sem pedido do WhatsApp, conversa pelo WhatsApp Web ou janela fechada) e também quando a atualização do pedido é recusada pelo WhatsApp. Se o resultado do envio ficar incerto (o WhatsApp não confirmou se a atualização chegou), a plataforma não manda a mensagem de confirmação, para o cliente não receber o aviso duas vezes.
Fora da janela de 24 horas, se o template configurado para enviar cobranças for um template de detalhes do pedido, a plataforma preenche o pedido do template com os mesmos itens, valores e formas de pagamento.
Casos de uso
- Fechar a venda no WhatsApp e mandar o PIX na hora.
- Montar uma cobrança com vários itens a partir do catálogo.
- Cobrar um negócio ganho no CRM sem redigitar o valor.
- Oferecer ao cliente a escolha entre PIX e cartão.
Dicas, limites e boas práticas
- Se a rede falhar depois do envio, tente novamente pela mesma tela sem fechá-la: a tentativa mantém a mesma chave e recupera a cobrança existente em vez de cobrar o cliente duas vezes.
- Valores são em unidades maiores (R$ 49,90 =
49.90); o total é a soma de preço × quantidade das linhas — nunca divida por 100. - O cartão sempre passa pelo checkout hospedado do gateway: zero dados de cartão na plataforma.
- Confirme nome e contato do cliente antes de criar — o gateway usa esses dados para identificar o pagador.
- Não confie na tela de "sucesso": o status real chega pelo webhook.
- Use apenas URLs HTTPS públicas nos retornos. Não coloque tokens, senhas ou outros segredos nelas.
Solução de problemas
- Erro ao criar a cobrança: verifique se o gateway está conectado e se o contato tem os dados mínimos.
- Cliente não recebeu o PIX: reenvie o cartão de pagamento na conversa.
- Pago mas continua pendente: confira a configuração do webhook (veja Reembolsos, webhooks e relatórios).
- Recurso indisponível (ex.: cartão): pode ser uma limitação do gateway escolhido — confira a matriz de recursos em Conectar gateway.
- Trocar a forma de pagamento de uma cobrança pendente: use Editar na lista de cobranças e escolha a nova forma em Forma de pagamento. No Asaas, o Pix, o boleto ou o link de cartão são atualizados, e o código antigo deixa de ser enviado. No Mercado Pago, cancele e crie de novo.
- A cobrança foi criada, mas não chegou à conversa: a plataforma avisa quando só o envio falhou. Não crie outra cobrança; reenvie a existente pela lista.