Geração de Cobrança — Boleto, PIX, Cartão, Carnê
Cobrança é como a
Mensalidade
(ou qualquer débito) se transforma em
algo que o cliente pode pagar — um boleto bancário, código PIX, link de cartão de crédito ou carnê físico. Sem cobrança gerada, o cliente não sabe como pagar.
A cobrança não é criada do nada — depende da
Carteira de Cobrança do contrato (define o banco/gateway/forma) e da
Forma de Pagamento (boleto, PIX, cartão).
Visão geral — fluxo completo
┌─────────────────────────────────────────────────────────────────┐
│ MENSALIDADE GERADA (R$ 100, vence dia 10) │
│ → ainda não tem "boleto pra pagar" │
└─────────────────────────────────────────────────────────────────┘
↓
Cron de Cobrança roda
(Tarefa "Contrato - Criar as Faturas" gera fatura; gateways/bancos registram boletos via APIs/CNAB conforme carteira)
↓
┌─────────────────────────────────────────────────────────────────┐
│ Lê o contrato → identifica: │
│ • CARTEIRA do contrato (qual banco/gateway) │
│ • FORMA DE PAGAMENTO (boleto/PIX/cartão) │
└─────────────────────────────────────────────────────────────────┘
↓
┌───────────────┴────────────────┐
↓ ↓
Forma BOLETO Forma PIX
→ gera nosso número → gera QR code + chave
→ linha digitável → válido por X horas
→ PDF do boleto → registra no banco
↓ ↓
└───────────────┬────────────────┘
↓
COBRANÇA registrada no banco (REMESSA CNAB ou API)
↓
Cliente recebe e paga
↓
RETORNO CNAB / Webhook traz a baixa
↓
Mensalidade vira "Paga"
Glossário
| Termo |
Significado |
| Cobrança |
Documento concreto pra cliente pagar — boleto, link PIX, etc. Vem de uma mensalidade/débito |
| Carteira de Cobrança |
Configuração que define: qual banco, qual gateway, qual modelo de boleto/PIX. Cada contrato tem uma carteira |
| Forma de Pagamento |
Tipo: Boleto, PIX, Cartão, Carnê, Débito automático. Cliente pode ter mais de uma |
| Gateway de pagamento |
Serviço externo (Asaas, GerenciaNet, Safe2Pay, ou direto do banco) que processa a cobrança |
| Nosso número |
ID único do boleto no banco — gerado quando emite |
| Linha digitável |
Sequência de números do boleto que pode ser copiada e paga via app banco |
| Remessa |
Arquivo CNAB enviado ao banco com lote de boletos a registrar. Ver Remessa & Retorno
|
| Retorno |
Arquivo CNAB que o banco devolve com baixas de pagamentos |
| Carnê |
PDF com 12+ boletos do ano inteiro pra cliente imprimir e pagar mês a mês |
| QR Code PIX |
Código que cliente escaneia no app do banco pra pagar instantâneo |
| BR Code |
Texto da chave PIX que pode ser copiada (alternativa ao QR visual) |
| Débito Automático |
Cliente autoriza o banco a debitar todo mês — sem precisar pagar manualmente |
Métodos de pagamento suportados
| Método |
Como funciona |
Velocidade baixa |
| Boleto Bancário |
Cliente paga em qualquer banco até a data — baixa via retorno CNAB |
1-2 dias úteis |
| PIX |
QR code ou chave Copia&Cola — pagamento instantâneo |
Instantâneo (segundos) |
| Cartão de Crédito |
Cliente preenche dados ou usa cartão salvo — gateway processa |
Imediato (D+1 pro provedor) |
| Cartão Recorrente |
Cartão salvo cobra automático todo mês — sem ação do cliente |
Automático D+1 |
| Carnê |
PDF com vários boletos — cliente paga mensalmente |
1-2 dias úteis cada |
| Débito em Conta |
Cliente autoriza banco a debitar — Quaza envia em arquivo CNAB |
Mesmo dia (se acordado) |
| Dinheiro em Caixa |
Cliente vai presencialmente no provedor pagar — Quaza dá recibo |
Imediato |
Mix recomendado: ofereça PIX como padrão (custo zero, instantâneo) + boleto como alternativa (cliente "antigo" prefere) + cartão recorrente pra reduzir inadimplência (cliente esquece). Carnê está em declínio mas ainda usado em algumas regiões.
1. Carteira de Cobrança — conceito central
Caminho: Financeiro → Carteira de Cobrança
A Carteira é o modelo de cobrança. Ela define:
- Qual banco registra o boleto (Itaú, Santander, Bradesco, etc.)
- Qual gateway processa cartão/PIX (Asaas, GerenciaNet, Safe2Pay, Sicredi, Sicoob, etc.)
- Qual conta corrente recebe o dinheiro
- Qual layout de boleto (logo, instruções, juros, multa)
- Quais formas de pagamento a carteira aceita
Por que ter múltiplas carteiras?
| Cenário |
Solução |
| Provedor com 2 empresas fiscais (multi-CNPJ) |
1 carteira por empresa — banco diferente |
| Cobrança normal vs prepaga |
2 carteiras com regras diferentes (juros, prazo) |
| Cliente residencial vs empresarial |
Carteiras com layout/banco apropriado |
| Teste de novo gateway |
Carteira de testes isolada |
Campos da carteira
| Campo |
O que faz |
| Descrição |
Nome interno (Itaú Principal, PIX Asaas, Cartão Sicredi) |
| Banco |
Qual instituição registra o boleto |
| Agência / Conta |
Onde o dinheiro cai |
| Convênio / Carteira (banco) |
Código específico do banco pra registro |
| Gateway |
Pra PIX/cartão — qual provedor processa (lista no Quaza: Asaas, GerenciaNet, Safe2Pay, Sicredi, Sicoob, MercadoPago, etc.) |
| Credenciais (API/token) |
Auth pra Quaza chamar a API |
| Layout PDF |
Template do boleto (logo, instruções) |
| Juros / Multa |
% aplicados após vencimento (geralmente 1%/2%) |
| Dias tolerância |
Quantos dias após vencimento sem juros |
| Considera dia útil |
Vencimento em sábado → adia pra segunda |
Caminho: Financeiro → Formas de Pagamento
Cadastro de cada tipo de pagamento que o provedor aceita. Permite habilitar/desabilitar e configurar comportamento (gateway, prazos).
Campos da forma de pagamento
| Campo |
O que faz |
| Descrição |
Nome amigável (Boleto Itaú, PIX Quaza, Cartão Visa) |
| Tipo |
Boleto / PIX / Cartão / Carnê / Caixa / Débito |
| Carteira |
Qual carteira processa essa forma |
| Permite parcelamento |
Sim/Não — cartão geralmente permite |
| Aceita no portal |
Cliente pode escolher essa forma no portal? |
| Situação |
Habilitado / Desabilitado |
Relação Carteira × Forma: 1 carteira pode atender N formas (uma carteira "Asaas" suporta boleto + PIX + cartão). 1 forma específica usa 1 carteira. Cliente em contrato com Carteira X usa as Formas habilitadas dessa Carteira.
Quando o sistema gera/regenera cobrança
| Evento |
Cobrança gerada? |
| Mensalidade criada (cron) |
Sim — em seguida que a fatura/mensalidade é criada, o gateway/banco registra a cobrança via API ou CNAB |
| Mensalidade vence sem pagar |
Sim — gera nova cobrança com juros/multa (se configurado) |
| Cliente pede 2ª via no portal |
Não cria nova — reutiliza a existente (mesma linha digitável) |
| Operador clica "Reemitir" |
Sim — cancela cobrança antiga, gera nova (nosso número novo) |
| Mudança de carteira no contrato |
Cobranças futuras com nova carteira; passadas continuam com antiga |
| Renegociação |
Cancela cobranças antigas + gera novas pro acordo. Ver Renegociação
|
Pré-requisitos pra cobrança ser gerada
| Requisito |
Onde verificar |
| Mensalidade existente |
Mensalidade
gerada com valor > 0 |
| Contrato com Carteira |
Contrato → campo Carteira preenchido |
| Carteira ativa |
Carteira → Situação=Habilitada |
| Credenciais válidas |
Gateway/banco com auth funcionando (testar via Configurações) |
| Cliente com dados completos |
CPF/CNPJ válido, endereço (pra boleto) |
| Data de vencimento futura |
Não dá pra gerar boleto pra data já passada (algumas regras) |
Diferença entre Mensalidade × Cobrança: mensalidade é o "valor que cliente deve" (registro contábil). Cobrança é "como ele paga" (boleto/PIX/cartão concreto). Pode haver mensalidade SEM cobrança gerada (ex: carteira inativa) — vira o alerta amarelo "X débitos sem cobrança" no
Painel
.
Pegadinhas frequentes
1. "Débito em aberto sem cobrança"
Mensalidade existe, mas cobrança não foi gerada. Causas comuns: Carteira do contrato desabilitada, credencial do gateway expirou, contrato sem Carteira. Verifique
Painel
→ alerta amarelo +
Verificações → Sem cobrança
.
2. Boleto gerado mas cliente não recebe
Cobrança gerada no Quaza mas registro no banco falhou (Remessa CNAB com erro, gateway lento). Verifique Remessa → Erros. Sem registro no banco, cliente não consegue pagar (boleto "ilegal").
3. Linha digitável trocada — cliente pagou boleto vencido
Cliente pegou boleto antigo, sistema gerou nova cobrança com nova linha. Cliente pagou a antiga (não registra). Solução: configurar "Aceitar pagamento de boleto antigo" no gateway, ou processar manualmente via Lançamento Manual.
4. PIX expirou — cliente não consegue pagar
QR Code PIX tem validade (geralmente 1-24h). Cliente abriu boleto-PIX 2 dias depois, código já expirou. Cliente precisa pedir 2ª via no portal — Quaza gera novo QR válido.
5. Cartão recorrente parou de cobrar
Cartão venceu, bloqueado, ou cliente trocou. Gateway retorna erro → cobrança fica pendente. Configure aviso automático pro cliente em
Comunicação
→ "Cartão recusado". Cliente atualiza dados.
6. Carteira inativa — clientes parados na geração
Operador desabilitou Carteira "Itaú" achando que ninguém usa, mas 200 contratos estavam vinculados. Cron de cobrança para. Solução: trocar Carteira em massa antes de desabilitar (Edição Múltipla → Carteira).
7. Cobrança em moeda errada (multi-país)
Provedor com filial Paraguai (RUC) gera cobrança em R$ por engano. Configure Carteira por Empresa fiscal, e contrato fica vinculado à empresa correta com moeda local.
Galeria de telas
Cob carteiras
Cob formaspag
Cob v01 carteira
Documentos relacionados
Aprofunde-se nos temas conexos:
FAQ
Posso ter mesmo cliente com formas diferentes (boleto + cartão)?
Sim — depende da política. Pode oferecer "qualquer forma" e cliente escolhe no portal. Ou força "só cartão recorrente" pra reduzir inadimplência.
Cliente pagou 2x — o que fazer?
Sistema detecta retorno duplo. Lança crédito na próxima fatura. Se cliente prefere reembolso, há fluxo de devolução em Recebimentos.
Por que boleto demora 1-2 dias pra baixar mesmo após pagar?
Banco processa retorno CNAB em horário fixo (geralmente 1x/dia). Quaza importa depois. Pra baixa imediata, use PIX (instantâneo via webhook do gateway).
Cliente perdeu o boleto — onde acha?
No Portal do Cliente
→ Financeiro → Pegar 2ª via. Sistema reemite o boleto (mesmo nosso número) por email/WhatsApp.
Como configurar PIX próprio (sem gateway)?
Configure Carteira como "PIX Banco" com sua chave PIX. Quaza gera QR Code com seus dados. Sem gateway, baixa não é automática — precisa conciliação manual via extrato.
Mensalidade R$ 100 mas boleto vem R$ 110 — por quê?
Juros + multa após vencimento. Se cliente paga após data, vem com encargos. Configure em Regras
ou Carteira → Juros/Multa.
Como mudar de banco/gateway sem afetar cobranças existentes?
Crie nova Carteira em paralelo, vincule novos contratos a ela. Os antigos continuam na Carteira velha. Migre gradualmente conforme contratos renovam. (Gateways suportados pelo Quaza incluem: Juno, GerenciaNet, Safe2Pay, WidePay, Asaas, GalaxPay, Cielo, Banco do Brasil, Sicredi, Sicoob, Banrisul, Cresol, Santander, MercadoPago.)