Como Homologar Conta Bancária | Boleto Cloud

A homologação é o processo de validação da conta bancária. Ela garante que todos os dados estão corretos e que os pagamentos serão creditados na conta certa.

Obrigatório antes de usar em produção

Você deve homologar a conta bancária antes de emitir boletos para clientes reais. Boletos emitidos por contas não homologadas contêm avisos especiais.

Por que homologar?

• Validar os dados — Confirma que agência, conta, carteira e convênio estão corretos
• Testar o fluxo completo — Emissão, registro, pagamento e conciliação
• Evitar problemas — Pagamentos não identificados ou creditados na conta errada

---

Como identificar uma conta não homologada

O sistema indica contas não homologadas de duas formas:

Na lista de contas

O indicador H indica que a conta ainda não foi homologada.

No boleto

Boletos de contas não homologadas exibem aviso para não serem pagos por terceiros.

---

Pré-requisitos

Antes de iniciar a homologação, você precisa ter cadastrado:

1. Beneficiário — Cadastrar beneficiário
2. Conta bancária — Cadastrar conta bancária
3. Pagador de teste — Cadastrar pagador

Dica

Para a homologação, use um pagador de teste (pode ser você mesmo). Não use dados de clientes reais neste processo.

---

Processo de homologação

O processo completo envolve 5 etapas:

Etapa 1: Emitir boleto de teste

1. Acesse o menu “Boleto > Criar”

   

2. Preencha o formulário com:

   • Conta bancária que será homologada
   • Pagador de teste
   • Valor simbólico (ex: R$ 3,00)
   • Data de vencimento futura

   

3. Clique em Salvar para gerar o boleto

---

Etapa 2: Registrar o boleto

O boleto precisa ser registrado no banco antes de ser pago. Esse processo é feito através do arquivo REMESSA.

Cuidado

O boleto deve ser registrado antes do pagamento. Boletos não registrados podem não ser reconhecidos pelo banco.

1. Acesse “Boleto > Consultar” e localize o boleto criado

   O boleto aparecerá com status de pendente de registro.

   

2. Clique no ícone de registro do boleto para acessar a tela de exportação de arquivo CNAB

3. Crie o arquivo REMESSA clicando em “Criar Arquivo”

   

4. Após a criação, o arquivo ficará pronto para download

   

5. Faça o download clicando em “Baixar Arquivo”

   

6. Importe o arquivo no sistema do banco (internet banking)

7. Após importar no banco, volte ao Boleto Cloud e clique em “Confirmar Envio”

   

---

Etapa 3: Pagar o boleto

Após o registro, faça o download do boleto para pagamento. Na lista de boletos (“Boleto > Consultar”), clique no ícone de download:

Pague o boleto na rede bancária (internet banking, caixa eletrônico ou agência).

Até que a conciliação bancária seja realizada, o sistema exibirá um ícone indicando que está aguardando a confirmação do pagamento através do arquivo de retorno:

Tempo de compensação

A compensação bancária pode levar até 2 dias úteis. Aguarde esse prazo antes de prosseguir.

---

Etapa 4: Conciliar o pagamento

Após a compensação, você precisa informar ao sistema que o boleto foi pago. Existem duas formas:

Opção A: Arquivo de Retorno (Recomendado)

1. Baixe o arquivo de RETORNO no internet banking do seu banco
2. Acesse “Conta > Importar Arquivo CNAB”
3. Importe o arquivo

O sistema atualizará automaticamente o status do boleto para pago.

Opção B: Marcação Manual

Se preferir não usar o arquivo de retorno:

1. Acesse “Boleto > Consultar” e localize o boleto

   O boleto aparecerá aguardando arquivo de retorno.

   

2. Clique no boleto para ver os detalhes

3. Clique em “Marcar como Pago”

   

4. Confirme a operação

   

Após a conciliação, o boleto aparecerá sem pendências:

---

Etapa 5: Confirmar a homologação

Com o boleto pago e conciliado, você pode finalizar a homologação. Acesse o cadastro da conta bancária pelo menu “Conta > Consultar”, pelo aviso de alerta de conta em homologação ou pelo ícone H na lista de boletos:

1. Na tela da conta bancária, clique no botão “Homologar”

2. Preencha o formulário com os dados do boleto pago

   Atenção aos dados

   Utilize os dados exatamente como registrados no sistema, não os dados do comprovante de pagamento. O Nosso Número deve ser informado com todos os zeros à esquerda.

   

3. Confirme a homologação

   

---

Conta homologada

Após a homologação, a conta estará liberada para emitir boletos para clientes reais. O indicador H desaparecerá da lista de contas e os boletos não exibirão mais o aviso de homologação.

---

Problemas comuns

Boleto não reconhecido pelo banco

Verifique se o arquivo REMESSA foi importado corretamente no internet banking antes do pagamento.

Dados da homologação rejeitados

Certifique-se de usar os dados do sistema (não do comprovante) e incluir os zeros à esquerda no Nosso Número.

Pagamento não identificado

Aguarde até 2 dias úteis para a compensação. Se persistir, verifique se o arquivo de RETORNO foi importado.

---

Próximos passos

Perguntas Frequentes Veja como emitir boletos, gerar remessa e outras dúvidas comuns.

Documentação da API Integre a emissão de boletos ao seu sistema.