Visão geral
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.
Pré-requisitos
Ative Pagamentos, conecte um gateway compatível e confira os dados do pagador. As opções disponíveis dependem da conexão, do método e do ciclo. Asaas oferece parcelamento nativo mensal de boleto/Pix; outras periodicidades usam recorrência limitada quando suportadas. Os planos de boleto/Pix e a recorrência limitada só aparecem quando esse fluxo está liberado para a conexão. O cartão de crédito parcelado mensalmente é uma cobrança única que o gateway divide e continua disponível mesmo sem planos de cobrança. Não há integração direta com novos bancos nesta entrega.
Passo a passo
- Abra Nova cobrança em Pagamentos ou na conversa e selecione cliente, conexão e método.
- Escolha a modalidade parcelada, informe o valor total, a quantidade, o primeiro vencimento e o ciclo disponível.
- Confira o resumo e as condições antes de criar.
- Abra o plano para acompanhar as parcelas emitidas e o progresso.
- Use Baixar carnê para obter o PDF e Enviar carnê na conversa para entregá-lo ao cliente; confira o destinatário antes do envio.
- No menu de cada parcela, Ver cobrança está sempre disponível. Enviar esta parcela na conversa só aparece para parcelas em aberto (pendente, aguardando pagamento ou vencida).
Configurações & opções
O parcelamento nativo mensal emite as parcelas no gateway. A recorrência limitada tem uma quantidade final, mas emite cobranças progressivamente: o cronograma previsto não é um boleto já emitido. O plano de cobrança também é diferente do modelo reutilizável de assinatura disponível em Planos.
Em Condições de pagamento, confira os padrões da conexão e ajuste somente o necessário na cobrança. Um campo vazio não envia uma substituição explícita. As configurações de multa e juros da conta Asaas não podem ser consultadas pela API; confira-as no painel do provedor quando necessário.
No detalhe do plano, configure os avisos de parcela paga e de plano concluído. Por padrão, o aviso de cada parcela paga fica desligado e o de conclusão fica ligado. A escolha vale para esse plano; os canais de e-mail e push continuam sujeitos às preferências de notificação do usuário. Ativar um aviso não dispara novamente os eventos que já ocorreram.
Casos de uso
Use boleto mensal para uma venda em 12 parcelas. Para um serviço com cobranças trimestrais e fim definido, use a recorrência limitada disponível. Uma assinatura sem limite continua sendo uma cobrança recorrente, sem representar uma venda parcelada com total finito.
Dicas, limites e boas práticas
O carnê enviado ao cliente é o PDF da plataforma com a marca da conta. O PDF do Asaas serve para conferência interna. Boleto usa linha digitável e código de barras fornecidos pelo gateway. No Pix, cada parcela sai num cartão próprio com o QR e o código Pix copia e cola completo, sem campos de boleto como agência, carteira ou ficha de compensação. Dados ainda não fornecidos pelo gateway não devem ser inventados.
O carnê mostra a situação atual de cada parcela. Quando uma parcela é paga, cancelada, estornada ou vence, e quando o plano é cancelado ou concluído, a plataforma gera o carnê de novo automaticamente, em poucos segundos. Parcela paga sai com Paga em e a data; parcela cancelada ou estornada sai com a situação em destaque. Nesses casos o carnê não traz QR, código copia e cola, linha digitável nem código de barras, para o cliente não pagar duas vezes. Enquanto o carnê é atualizado, o plano mostra Atualizando o carnê e o envio aguarda a nova versão; o arquivo anterior continua disponível para download.
Um plano cancelado ou concluído não tem mais parcelas a pagar. O carnê continua disponível para consulta, mas Enviar carnê na conversa e Notificações deste plano deixam de aparecer.
Cancelar interrompe o que o gateway permite cancelar; arquivar organiza a visualização e não estorna dinheiro. Excluir um parcelamento nativo no Asaas é irreversível. Ao cancelar uma cobrança parcelada no cartão, todas as parcelas ainda em aberto no gateway são canceladas juntas; parcelas já pagas são preservadas. Parcelas liquidadas exigem o fluxo apropriado de reembolso; não as apague para corrigir um recebimento.
Solução de problemas
Faltam parcelas futuras: em recorrência limitada, consulte o cronograma previsto e aguarde a emissão pelo gateway.
O carnê ainda não está disponível: confira o estado da geração e tente novamente após a atualização das parcelas.
O carnê mostra uma parcela paga como pendente: aguarde alguns segundos enquanto o plano mostra Atualizando o carnê e baixe o PDF de novo. Se o aviso não sumir, ou disser que não foi possível atualizar, use Gerar carnê de novo no plano; o arquivo anterior continua disponível enquanto isso.
Enviar carnê na conversa não aparece: o plano foi cancelado ou concluído, ou o carnê está sendo atualizado. Para cobrar uma parcela específica ainda em aberto, use Enviar esta parcela na conversa no menu da parcela.
Método ou ciclo indisponível: escolha uma combinação oferecida pela conexão. Pix recorrente no Mercado Pago não está disponível.
Parcelamento neste método ainda não está liberado: a conexão ainda não tem o fluxo de planos liberado para boleto ou Pix. Use a cobrança à vista ou o cartão de crédito parcelado.
Parcelas 2 em diante não aparecem na plataforma: no cartão parcelado, a venda fica registrada como uma única cobrança e o gateway controla as parcelas. A conciliação lista essas parcelas como não vinculadas, sem tratá-las como falha.
Carnê indisponível num plano de cartão: carnê só existe para boleto e Pix. No cartão, cada parcela tem a própria página de pagamento.
Aviso "Teste · pagamento não é real": a cobrança ou o plano foi criado numa conexão de teste (sandbox). Tudo é criado e enviado normalmente, mas o pagamento não movimenta dinheiro. Use a conexão de produção para cobrar clientes de verdade.
Total diferente do recebido: confira pagamentos, reembolsos e estornos por parcela. O recebimento cresce conforme cada parcela é liquidada.