O que muda ao pagar taxa de processo com cartão de crédito no Aprova
Pagar taxa de processo com cartão de crédito no Aprova significa que o requerente escolhe, na própria sidebar de débitos do processo, entre baixar o boleto tradicional ou parcelar o valor em até 12 vezes no cartão — sem abrir um segundo sistema de pagamento e sem sair da plataforma. A opção só aparece para prefeituras, câmaras e órgãos públicos que têm contrato firmado com o Banco do Brasil e habilitaram a integração BB Pay Arrecadação no cadastro da cidade.
Este guia explica quando essa opção aparece, o que muda no fluxo de confirmação em relação ao boleto e por que o pagamento por cartão não é instantâneo mesmo depois que o requerente conclui a compra.
Por que o pagamento por cartão é diferente do boleto manual
No fluxo padrão, o analista anexa o boleto ao despacho de taxas, o Lume Docs extrai automaticamente código de barras, valor e vencimento, o requerente paga em qualquer canal bancário e depois faz upload do comprovante para o analista conferir — um ciclo que pode levar dias, a depender de quando o requerente decide pagar e anexar o recibo.
Com o BB Pay Arrecadação habilitado, o requerente ganha uma segunda porta de saída dentro da mesma sidebar de débitos: ao clicar em “Visualizar débitos”, ele vê a opção de baixar a guia de arrecadação (o boleto de sempre) ou pagar com cartão de crédito, parcelado em até 12 vezes, no checkout do Banco do Brasil incorporado à própria tela do processo. A partir desse ponto, a interface, a segurança e o processamento dos dados do cartão são de responsabilidade do BB — o Aprova só recebe o resultado da transação.
O que muda na prática
Antes, todo pagamento dependia do requerente ter o boleto em mãos, pagar em um canal externo e lembrar de voltar ao processo para anexar o comprovante — um passo que, esquecido, trava a taxa em “Pendente” mesmo com o pagamento já feito.
Com o cartão habilitado:
- o requerente conclui o pagamento sem sair da tela do processo, sem precisar simular parcelamento em outro app;
- a confirmação não é imediata: como o Banco do Brasil não oferece webhook para pagamento por cartão, o sistema consulta a API do BB a cada 15 minutos, por até 8 tentativas — ou seja, pode levar até duas horas para o status ser atualizado;
- quando o pagamento é aprovado, o sistema gera sozinho um comprovante interno e anexa à taxa, criando um despacho automático na timeline — o requerente não precisa fazer esse upload manual;
- mesmo assim, a taxa não vai direto para “Pago”: ela entra em “Aguardando Confirmação”, e o analista responsável precisa aceitar ou rejeitar o comprovante gerado, exatamente como faria com um comprovante anexado manualmente;
- se o banco recusar o pagamento, a taxa continua “Pendente” e o requerente pode tentar de novo — pelo cartão ou voltando para o boleto.
O fluxo manual — boleto e comprovante anexado pelo próprio requerente — continua sempre disponível, independentemente da integração estar ativa ou não. Cartão de crédito é uma opção a mais, não uma substituição.
Quando usar essa opção — e quando não usar
Faz sentido habilitar quando o órgão público lida com alto volume de taxas de valor baixo a médio (emissão de alvará, licença, certidão) e quer reduzir o número de requerentes que abrem o processo, mas nunca voltam para anexar o comprovante do boleto pago. Também ajuda em taxas mais altas, quando o parcelamento em até 12 vezes reduz a barreira de caixa do contribuinte.
Não é a opção certa quando o órgão não tem contrato com o Banco do Brasil, ou quando a taxa em questão já é isenta (valor R$ 0,00) — nesse caso não há código de barras nem ação de pagamento a configurar, e o requerente segue direto para o anexo do comprovante de isenção.
Como o Aprova resolve isso
- O campo de Pagamentos do despacho extrai automaticamente código de barras, valor e vencimento do boleto anexado, pelo Lume Docs — mesmo mecanismo usado na emissão e baixa de taxa dentro do processo.
- A opção de cartão só aparece quando a flag de integração está habilitada para a cidade — nenhuma configuração aparece para quem não tem o contrato firmado.
- O status da taxa (Pendente, Aguardando Confirmação, Pago, Cancelada) fica visível em tempo real no despacho, sem o servidor precisar abrir o painel do banco para saber se o pagamento entrou.
- Para órgãos que já operam sistema de arrecadação próprio, a mesma lógica de integração por API se aplica sem depender de upload manual de boleto, como descrito em como integrar sistema financeiro ao protocolo eletrônico.
FAQ sobre pagamento de taxa por cartão de crédito
O pagamento por cartão confirma na hora?
Não. A confirmação depende de consulta periódica à API do Banco do Brasil, feita a cada 15 minutos, com até 8 tentativas. O status pode levar até duas horas para mudar de “Pendente” para “Aguardando Confirmação”.
O boleto tradicional deixa de existir quando o cartão é habilitado?
Não. O fluxo de boleto com upload manual de comprovante continua disponível como alternativa, mesmo com a integração de cartão ativa.
Quem decide se o pagamento por cartão fica ativo para a cidade?
É uma configuração de cadastro da cidade, condicionada a contrato firmado com o Banco do Brasil. Não é algo que o requerente ou o analista habilita durante o uso do processo.
Se o pagamento aprovado gera comprovante automático, o analista ainda precisa conferir alguma coisa?
Sim. O comprovante gerado automaticamente segue o mesmo rito de homologação de um comprovante manual: o analista aceita ou rejeita, com justificativa obrigatória em caso de rejeição, antes de a taxa mudar para “Pago”.
Conheça o Aprova
O Aprova concentra emissão de taxa, extração automática de dados do boleto e agora também pagamento por cartão de crédito dentro do mesmo processo, sem exigir que o requerente circule entre sistemas para pagar um documento público. Agende uma demonstração para ver como funciona a integração de pagamentos do Aprova.
Sumário

Redação Aprova
A Redação Aprova produz conteúdos sobre gestão pública, legislação e transformação digital para apoiar prefeitos, secretários e equipes municipais. Os artigos são desenvolvidos com base em fontes oficiais, boas práticas do setor público e a partir da experiência da Aprova no desenvolvimento de soluções para modernizar a administração municipal.