Cobrança automática com a Base de Clientes

Com essa integração, o Groner gera o boleto, o PIX ou o link de cartão direto da parcela do pagamento e dá baixa sozinho quando o cliente paga. Você não precisa emitir cobrança em outro sistema nem conferir extrato para marcar quem pagou.

A configuração leva alguns minutos e é feita uma vez só.

Antes de começar

Você vai precisar de:

• Perfil de Administrador no Groner.
• A chave de API da Base de Clientes, gerada no painel deles, na área de integrações.
• Uma conta bancária cadastrada no Groner, em Financeiro → Cadastros → Contas Bancárias. É nela que a baixa automática credita o dinheiro, e sem ela não dá para ativar a cobrança.
• Seus contatos com CPF ou CNPJ preenchido. A Base de Clientes exige o documento de quem vai pagar; contato sem documento não gera fatura.

⚠️ A Base de Clientes não tem ambiente de testes. Toda cobrança gerada é real e vai para o seu cliente.

Passo 1 — Conectar o provedor

Vá em Configurações → Pagamentos → Cobrança.

No topo da tela está o quadro Conexão com o provedor. Preencha:

Clique em Salvar.

💡 Essa configuração é uma só para a empresa e vale também para o Contas a Receber. Se você usa os dois, não precisa configurar duas vezes.

Passo 2 — Cadastrar o aviso de pagamento

O aviso de pagamento (webhook) é o que faz a Base de Clientes avisar o Groner na hora em que alguém paga. Sem ele, a baixa não acontece sozinha.

Logo abaixo da conexão você vê o campo Aviso de pagamento (webhook) com um endereço e o botão Cadastrar no provedor.

Clique em Cadastrar no provedor. O Groner cria o aviso direto na sua conta da Base de Clientes.

Se aparecer uma mensagem dizendo que não foi possível, não tem problema: significa que a sua conta na Base de Clientes não permite esse cadastro automático. Nesse caso, faça manualmente:

1. Copie o endereço que aparece no campo (use o ícone de copiar).
2. Envie para suporte@clientbase.com.br pedindo a configuração do webhook com:

• esse endereço,
• verbo POST,
• os eventos billing.paid e billing.cancelled,
• e o mesmo token do webhook que você definiu no passo 1.

Passo 3 — Dizer como cada forma de pagamento cobra

Ainda em Configurações → Pagamentos → Cobrança, abaixo da conexão está a lista das suas formas de pagamento.

Forma de pagamento que você não configurar aqui não gera fatura. É assim que você escolhe quais cobranças passam pela Base de Clientes.

Clique na engrenagem da forma que deseja e defina:

⚠️ Se você cobra juros ou multa, ligue "Aceitar pagamento maior que a parcela". Quem paga atrasado paga a parcela mais os acréscimos, ou seja, um valor maior do que o previsto. Com essa opção desligada, o Groner recusa essa baixa e o pagamento não aparece no sistema.

Passo 4 — Gerar a cobrança

Abra o negócio, vá na aba Pagamentos e localize a parcela.

No botão Gerar cobrança, o Groner cria a fatura na Base de Clientes. Não há pergunta de boleto ou PIX: quem responde isso é a configuração que você fez no passo 3.

Depois de gerada, a parcela mostra:

• Ver fatura — abre a página onde o cliente escolhe entre boleto, PIX ou cartão. É esse link que você envia para ele.
• Cancelar cobrança — cancela a fatura na Base de Clientes e libera a parcela para gerar outra.

Se você também usa o Contas a Receber, a mesma cobrança vale para os dois: a fatura é uma só, e quando o cliente pagar a baixa acontece nos dois lugares.

Passo 5 — Acompanhar

Em Configurações → Pagamentos → Avisos do gateway você vê tudo que a Base de Clientes comunicou ao Groner e tudo que o Groner pediu a ela.

Cada linha mostra o que aconteceu, e as que falharam mostram o motivo. Quando a falha é passageira, o Groner tenta de novo sozinho e a linha avisa quando será a próxima tentativa. Quando precisa de você, existe o botão Tentar de novo.

Tentar de novo é seguro. Antes de dar baixa o Groner confere o pagamento direto na Base de Clientes, então nada é lançado duas vezes.

Problemas comuns

O cliente pagou e a parcela não baixou.
Abra Avisos do gateway e procure a fatura. Se o aviso chegou e falhou, o motivo está ali e o botão Tentar de novo resolve. Se nenhum aviso chegou, o webhook provavelmente não está cadastrado — volte ao passo 2.

O cliente pagou atrasado, com juros, e não baixou.
Ligue Aceitar pagamento maior que a parcela na configuração daquela forma de pagamento (passo 3) e use Tentar de novo no aviso correspondente.

O botão "Gerar cobrança" não aparece na parcela.
Ou a forma de pagamento daquela parcela não está configurada (passo 3), ou o seu perfil não tem permissão para cobrar. Fale com o administrador da sua empresa.

Erro dizendo que o cliente está sem CPF/CNPJ.
A Base de Clientes exige o documento de quem paga. Complete o cadastro do contato e gere a cobrança de novo.

Não consigo ativar o gateway.
Só é possível ativar com a conta de liquidação preenchida. Cadastre a conta em Financeiro → Cadastros → Contas Bancárias e volte à tela de Cobrança.

Preciso mudar os juros de uma cobrança que já emiti.
Não é possível alterar juros, multa ou negativação de uma fatura já criada. Cancele a cobrança e gere outra com a configuração nova.

Precisa de ajuda?

Fale com o nosso suporte pelo chat. Se o problema for na conta da Base de Clientes — a chave de API, o cadastro do webhook ou o pagamento em si — o contato é suporte@clientbase.com.br.

Atualizado em: 01/09/2026