Passar para o conteúdo principal

Conectar a conta ao banco (Open Finance)

Como conectar uma conta bancária pelo Open Finance para o saldo e o extrato chegarem sozinhos, o que cada situação da conexão quer dizer e o que fazer quando ela vence.

Escrito por Bruce Bianchini Batista

Com a conexão, o saldo e o extrato da conta chegam sozinhos à Kamino. Sem ela, o extrato entra por importação de arquivo, um arquivo de cada vez.

Onde conectar a conta ao banco

Em Configurações › Contas e integrações bancárias, no cadastro de cada conta. A conexão é da conta, não da empresa: cada conta bancária se conecta por conta própria.

O formulário de nova conta bancária, com o bloco Integração bancária avisando que a conta precisa de banco, agência e conta completos para conectar

A mesma conta pode ter cadastros em Grupos ou organizações diferentes. Cada cadastro precisa da sua própria autorização do banco; desconectar um deles não encerra os demais.

A conexão Open Finance é opcional e pode ser feita depois — o cadastro da conta não depende dela.

Na lista de bancos, o selo Open Finance marca quem conecta por esse caminho. Banco sem o selo ainda não está disponível para conexão automática, e a tela diz isso: você pode importar o extrato por arquivo enquanto isso.

Como conectar uma conta ao banco pelo Open Finance, passo a passo

  1. No menu, abra Configurações › Contas e integrações bancárias.

  2. Clique na linha da conta, ou no lápis (Editar conta). Abre Editar conta bancária. Para uma conta que ainda não existe, clique em Nova conta e preencha a empresa, o nome, o tipo, o banco, a agência e a conta.

  3. No bloco Integração bancária, no cartão Receba saldo e extrato do banco na Kamino, clique em Conectar.

  4. Numa conta nova, ou com alterações não salvas, a Kamino pergunta Salvar a conta para conectar? ou Salvar as alterações para conectar?. Clique em Salvar e conectar.

  5. Abre a janela do banco. Conclua a autorização ali: com o usuário e a senha do internet banking, ou autorizando o acesso no próprio banco, conforme o banco. A senha é digitada na janela do banco, nunca na Kamino.

  6. O cartão passa a Aguardando o banco enquanto o banco confirma, e depois a Conectada, com a frase Saldo e extrato chegando automaticamente.

Numa conta nova, a tela avisa Conta criada. Aguardando a autorização do banco — você pode sair desta tela. Em Aguardando o banco, você pode sair: a situação aparece no cartão quando você voltar.

Como reconectar uma conta ao Open Finance

Reconecte quando o cartão Receba saldo e extrato do banco na Kamino mostrar Autorização vencida ou Reconexão necessária, por exemplo depois de trocar a senha do internet banking.

  1. Em Configurações › Contas e integrações bancárias, clique na linha da conta.

  2. No bloco Integração bancária, no cartão do extrato, clique em Reconectar.

  3. Na janela do banco, refaça a autorização. Se a senha mudou, informe a nova.

  4. O cartão passa a Aguardando o banco e volta a Conectada.

O histórico já recebido continua na Kamino. Use Reconectar, e não Desvincular: desvincular encerra a conexão.

Como desvincular uma conta do Open Finance

  1. Em Configurações › Contas e integrações bancárias, clique na linha da conta.

  2. No bloco Integração bancária, no cartão Receba saldo e extrato do banco na Kamino, clique em Desvincular.

  3. Na janela Desvincular integração?, clique em Desvincular. Para desistir, clique em Cancelar.

O saldo e o extrato param de chegar sozinhos, e o cartão volta a oferecer Conectar. Para conectar de novo, é preciso uma autorização nova no banco. Na Conta Kamino, peça a desconexão ao suporte.

Como desconectar a integração de pagamentos

  1. Em Configurações › Contas e integrações bancárias, clique na linha da conta corrente.

  2. No bloco Integração bancária, no cartão Pague e cobre pelo seu banco ou Pague e cobre pelo Banco do Brasil, com a situação Ativa, clique em Desconectar.

  3. Na pergunta Desconectar a integração com o banco? (ou Desconectar a integração com o Banco do Brasil?), clique em Sim, desconectar. Para desistir, clique em Manter conectada.

A conta deixa de enviar pagamentos e emitir cobranças por esse caminho. Voltar não é imediato: é preciso pedir a integração de novo e esperar a Kamino ativar, e no Banco do Brasil informar as chaves outra vez.

Conectar a conta pelo Open Finance

O botão Conectar abre a janela do próprio banco. A sua senha é digitada no banco, nunca na Kamino — é assim que o Open Finance funciona, e é por isso que a autorização acontece fora daqui.

A edição de uma conta já cadastrada, com as duas integrações do bloco Integração bancária

Concluída a autorização, a conta passa a Conectada e o saldo e o extrato começam a chegar.

Para conectar, a conta precisa ter banco, agência e número completos no cadastro. Numa conta nova, a Kamino salva a conta com os dados preenchidos antes de abrir a janela do banco.

As situações da conexão Open Finance

A conexão tem mais estados que ligado e desligado, e a diferença entre eles decide o que fazer:

Situação

O que aconteceu

Preparando · Autorizando no banco · Aguardando o banco

passagens — o pedido saiu e o banco ainda não confirmou

Conectada

saldo e extrato chegando

Não conectou

a autorização não foi concluída; em geral Tentar de novo recomeça, e se o bloqueio for no banco, resolva com ele antes

Autorização vencida

o consentimento do Open Finance tem prazo e ele acabou — Reconectar

Reconexão necessária

a conexão parou de trazer saldo e extrato, e precisa ser refeita

Conexão encerrada

acabou de vez; conectar de novo é começar do zero

Indisponível

o banco ainda não conecta automaticamente

Nativa é outra coisa: é a conta Kamino, cuja movimentação a própria plataforma registra. Ela não passa por Open Finance.

Em Aguardando o banco, você pode sair da tela: a situação atualiza sozinha e aparece quando você voltar.

O que confunde na conexão Open Finance

A autorização vence sozinha, e isso não é falha. O consentimento do Open Finance tem prazo legal. Quando ele acaba, a situação vira Autorização vencida e basta Reconectar — o histórico já recebido continua onde está.

"Reconexão indisponível" não se resolve por aqui. Significa que o banco não tem mais aquele acesso registrado. A tela avisa: assim que o banco comunicar, a conexão é encerrada e você poderá conectar de novo. Não adianta insistir no botão.

O banco pode estar esperando você no aplicativo dele. A mensagem o banco está esperando você quer dizer exatamente isso: refaça a conexão e confirme no aplicativo do banco quando ele pedir.

Conta conectada não aceita importar extrato. A Kamino recusa dizendo que o extrato dela já chega pela integração — importar por cima criaria movimentação em dobro.

Conta conectada tem o tipo e os números travados. A conexão foi feita com aqueles dados, então mudá-los exige desvincular antes. O nome da conta continua editável.

Desvincular e arquivar uma conta conectada

Desvincular é reversível, e vem antes de arquivar. Desvincular para o saldo e o extrato de chegarem, e você reconecta quando quiser. Para arquivar uma conta conectada, desvincule antes: a Kamino recusa com Desfaça a integração antes de arquivar. Na Conta Kamino, peça ao suporte a desconexão.

Conta conectada sem a origem do extrato

Uma mensagem específica do extrato vale conhecer: a conta está conectada, mas não registramos de onde o extrato dela vem. Ela aparece no extrato, e significa que um administrador precisa reconectar a conta para o extrato voltar. A conexão existe; o que falta é a origem dela.

Por que a conexão Open Finance falhou, e o que fazer

  • O banco não aceitou os dados de acesso. Tente de novo — sua senha é digitada no próprio banco, nunca aqui. Confira o usuário e a senha na janela do banco.

  • A autorização não foi concluída no banco. Refaça a autorização para liberar o extrato. Conecte de novo e conclua todos os passos na janela do banco.

  • O acesso a esta conta está bloqueado no banco. Resolva com o banco e conecte de novo. O bloqueio é do banco, e só ele libera.

  • O banco está esperando você. Refaça a conexão e confirme no aplicativo dele quando ele pedir. Abra o aplicativo do banco durante a conexão.

  • Não foi possível concluir a conexão agora. Tente de novo em alguns minutos. Espere alguns minutos e tente de novo.

  • Esta conta já tem uma integração ativa. Desvincule a atual antes de conectar outra. Use Desvincular e conecte de novo.

  • Esta conta não tem banco, agência e conta completos, então não pode ser conectada. Complete o cadastro da conta para conectar.

  • Não foi possível abrir a janela do banco. Verifique sua conexão e bloqueadores de anúncio, e tente de novo. Desligue o bloqueador de anúncios para a Kamino e tente de novo.

  • A conexão por Open Finance está indisponível no momento. Tente mais tarde. Enquanto isso, o extrato pode entrar por importação de arquivo.

Regras e prazos da conexão Open Finance

  • A autorização do Open Finance vence. O prazo é legal, de fora da Kamino. Quando vence, basta Reconectar.

  • A conexão é por conta, e cada cadastro tem a sua. Regra da Kamino: a mesma conta em dois Grupos precisa de duas autorizações.

  • Uma integração ativa por conta. Regra da Kamino: para conectar outra, desvincule a atual.

  • Conta conectada não aceita importar extrato e tem o tipo e os números travados. Regras da Kamino, para não duplicar movimentação.

  • Conta conectada só se arquiva depois de desvincular. Regra da Kamino.

Bancos que conectam o extrato pelo Open Finance

A conexão do extrato está disponível hoje para doze bancos. No cadastro da conta, eles aparecem com o selo Open Finance na lista de bancos. A conexão funciona de dois jeitos, conforme o banco:

  • Com o usuário e a senha do internet banking da empresa, digitados na janela de conexão: Banco do Brasil, Bradesco, Caixa Econômica Federal, Inter, Itaú e Santander. Se a senha for trocada no banco, a conexão para e a situação vira Reconexão necessária. Clique em Reconectar e informe a senha nova.

  • Com a autorização do Open Finance, dada no próprio banco: BTG Pactual, Nubank, Safra, Sicoob, Sicredi e XP. Essa autorização tem prazo. Quando ele acaba, a situação vira Autorização vencida, e basta Reconectar.

A lista é da Kamino e pode crescer. Banco sem o selo não conecta o extrato automaticamente: o cartão do extrato mostra Indisponível, e o extrato entra por Importar extrato, em Contas bancárias.

Integração de pagamentos: pagar e cobrar pelo seu banco

Além do extrato, o bloco Integração bancária de uma conta corrente pode trazer um segundo cartão, para enviar pagamentos e emitir cobranças por aquela conta:

  • Pague e cobre pelo seu banco, para Itaú, Bradesco, Santander, Sicredi e BTG Pactual. Você faz o pedido, e a Kamino acerta o convênio com o seu banco.

  • Pague e cobre pelo Banco do Brasil, para o Banco do Brasil. Você faz o pedido e informa as chaves de API do aplicativo da empresa no portal de desenvolvedores do banco.

Banco que não está nessas duas listas não tem integração de pagamentos na Kamino: o pagamento é feito no próprio banco, e a baixa é registrada na conta a pagar. A Conta Kamino não precisa de integração: ela paga e cobra direto, e o cartão dela diz Nativa.

Quem pode pedir e desconectar a integração de pagamentos: quem tem a funcionalidade Integrações bancárias — Escrita, em Papéis e permissões. Entre os papéis padrão, ela vem com Administrador da Organização e Administrador. O cartão de pagamentos aparece só em conta do tipo Conta corrente: o do Banco do Brasil na conta do Banco do Brasil, e Pague e cobre pelo seu banco nos outros bancos da lista. Com banco, agência ou conta incompletos, o cartão continua na tela, mas Conectar fica desabilitado, com o aviso Esta conta não tem banco, agência e conta completos, então não pode ser conectada. Complete o cadastro para conectar.

Como pedir a integração de pagamentos com Itaú, Bradesco, Santander, Sicredi ou BTG Pactual

  1. No menu, abra Configurações › Contas e integrações bancárias e abra a conta corrente. Para uma conta que ainda não existe, use Nova conta.

  2. No bloco Integração bancária, no cartão Pague e cobre pelo seu banco, clique em Conectar.

  3. Na pergunta Deseja conectar essa conta com o Banco?, clique em Sim, conectar. Numa conta nova, a Kamino salva a conta antes.

  4. O cartão passa a Em análise pela Kamino, com a frase Pedido recebido. A Kamino está acertando os convênios com o seu banco — avisamos quando estiver ativa.

Quando a Kamino termina, o cartão mostra Ativa, e os pagamentos e cobranças da conta passam a sair pelo convênio dela. Para isso, o banco precisa abrir com a Kamino o relacionamento de conexão bancária, que passa pelo gerente da sua conta, e no Itaú a empresa também assina um termo de conectividade. Essas exigências são do banco. Para a Kamino falar com o seu gerente, preencha a seção Gerente do banco no cadastro da conta.

Como conectar a conta ao Banco do Brasil para pagar e cobrar

Antes de começar, crie no portal de desenvolvedores do Banco do Brasil um aplicativo da empresa e tenha as três chaves dele em mãos: Developer application key, Client ID e Client secret. No portal do Banco do Brasil, o aplicativo da integração precisa ter liberadas as APIs Pagamentos em Lote, Extratos e Cobranças, e as chaves precisam ser as de produção: envie o aplicativo para produção antes de copiar as chaves e confira, em Credenciais, que a situação é de produção. Chaves de outro ambiente não servem. Essas exigências são do Banco do Brasil, e as APIs só ficam disponíveis depois que a empresa assina os termos de uso no Portal BB Digital PJ.

  1. No menu, abra Configurações › Contas e integrações bancárias e abra a conta corrente do Banco do Brasil.

  2. No bloco Integração bancária, no cartão Pague e cobre pelo Banco do Brasil, clique em Conectar.

  3. Na pergunta Deseja conectar essa conta com o Banco?, clique em Sim, conectar.

  4. O cartão passa a Aguardando as chaves e abre o formulário. Cole Developer application key, Client ID e Client secret e clique em Salvar chaves.

  5. O cartão passa a Em análise pela Kamino, com a frase Chaves recebidas. A Kamino está concluindo a configuração dos convênios com o banco — avisamos quando estiver ativa.

Quando a Kamino termina, o cartão mostra Ativa, e os pagamentos e cobranças da conta passam a sair pelo seu convênio no Banco do Brasil.

As chaves ficam guardadas cifradas e não aparecem de novo. Para trocá-las, use Substituir chaves no cartão. Para desistir enquanto o cartão está em Aguardando as chaves, clique em Cancelar no formulário: o pedido sai da fila da Kamino.

O que cada banco faz pela integração de pagamentos

O que a integração de pagamentos faz depende do banco. É o que a Kamino homologou com cada um:

  • Itaú: Pix, Pix copia e cola, TED, pagar boleto, cobrar por boleto e cobrar por bolepix.

  • Bradesco: Pix, Pix copia e cola, TED, pagar boleto e cobrar por boleto.

  • Sicredi: Pix, Pix copia e cola, TED, pagar boleto e cobrar por boleto.

  • BTG Pactual: Pix, TED e pagar boleto. Pix copia e cola e a cobrança por boleto não estão disponíveis.

  • Santander: Pix, TED, pagar boleto e cobrar por boleto. Pix copia e cola não está disponível.

  • Banco do Brasil: Pix, TED, pagar boleto e cobrar por boleto. Pix copia e cola não está disponível.

Um Pix copia e cola enviado por uma conta Santander, BTG Pactual ou Banco do Brasil é recusado pela Kamino antes de chegar ao banco: a coluna Envio ao banco mostra Falha, com o motivo esta conta não está habilitada para Pix copia e cola. Nenhum dinheiro sai da conta. Para pagar o mesmo título, envie por uma conta Itaú, Bradesco, Sicredi ou pela Conta Kamino, ou pague pela chave Pix do beneficiário.

Depois do envio, o pagamento pode esperar aprovação na plataforma do banco, pelas pessoas que a empresa definiu lá. No Banco do Brasil, o Pix sai sem essa aprovação; TED e boleto passam por ela. O passo a passo do envio e o que cada situação quer dizer estão em "Como enviar pagamentos ao banco".

O que confunde na integração de pagamentos

A integração de pagamentos não traz o extrato. Ela envia pagamentos e emite cobranças. O extrato é o outro cartão do bloco, Receba saldo e extrato do banco na Kamino, pelo Open Finance. Os dois convivem na mesma conta: conecte os dois para pagar pela Kamino e ver o extrato chegar sozinho.

Conta com integração de pagamentos não aceita importar extrato. O botão Importar extrato fica desabilitado. O motivo, ao apontar o botão: Esta conta recebe o extrato pela integração bancária — importar um arquivo duplicaria os lançamentos. Para o extrato dessa conta chegar, conecte o Open Finance. A recusa vale mesmo para a conta que só tem a integração de pagamentos (Itaú, Bradesco, Santander, Sicredi, BTG Pactual ou Banco do Brasil). É uma regra provisória da Kamino: ela vale até a Kamino decidir se essas contas podem importar o extrato por arquivo.

Em análise pela Kamino é trabalho da Kamino, não seu. Depois do pedido, e das chaves no Banco do Brasil, a tela não pede mais nada. Você pode sair: a situação aparece no cartão quando você voltar.

O tipo e os números da conta ficam travados enquanto a integração está ativa, como na conexão do extrato.

Desconectar a integração de pagamentos

Com o cartão em Ativa, clique em Desconectar e confirme em Sim, desconectar. A conta deixa de enviar pagamentos por esse caminho. No Banco do Brasil, as chaves informadas deixam de valer.

Voltar não é imediato: é preciso pedir a integração de novo e esperar a Kamino ativar, e no Banco do Brasil informar as chaves outra vez. Manter conectada fecha a pergunta sem mudar nada.

Por que a integração de pagamentos falhou, e o que fazer

  • Esta conta já tem uma integração ativa. Remova a atual antes de conectar outra. A conta já tem uma integração de pagamentos. Desconecte a atual antes de pedir outra.

  • Não é possível conectar esta conta agora. Fale com o suporte se o problema continuar. Fale com o suporte.

  • Esta conta não tem banco, agência e conta completos, então não pode ser conectada. Complete o cadastro e tente de novo. Preencha banco, agência e conta e tente de novo.

  • A integração está indisponível no momento. ou A integração com o Banco do Brasil está indisponível no momento. Tente mais tarde.

  • Não foi possível concluir a operação. Tente de novo. Tente de novo. Se continuar, confira se você tem a funcionalidade Integrações bancárias — Escrita.

  • Não foi possível desconectar agora. A integração segue ativa — tente novamente em alguns instantes. A integração continua ativa. Tente de novo em instantes.

  • Não foi possível cancelar agora. O pedido de integração continua aberto, tente de novo em instantes. O pedido ao Banco do Brasil continua na fila. Tente de novo em instantes.

Perguntas frequentes sobre conectar a conta ao banco

Como faço o extrato do banco chegar sozinho na Kamino?

Conecte a conta pelo Open Finance. Em Configurações › Contas e integrações bancárias, abra o cadastro da conta e clique em Conectar. A autorização é feita na janela do banco.

Preciso passar a senha do meu banco para a Kamino?

Não. A senha é digitada na janela do próprio banco, nunca na Kamino.

A conexão aparece como Autorização vencida. O que faço?

Clique em Reconectar. A autorização do Open Finance tem prazo e vence sozinha. O histórico já recebido continua na Kamino.

O meu banco não aparece com o selo Open Finance. E agora?

Esse banco ainda não conecta automaticamente. Enquanto isso, importe o extrato por arquivo, em Contas bancárias.

Por que não consigo importar o extrato de uma conta conectada?

O extrato dela já chega pela integração, e importar por cima duplicaria a movimentação.

Como desconecto a conta do banco?

Use Desvincular no cadastro da conta. O saldo e o extrato param de chegar, e você pode conectar de novo quando quiser. Na Conta Kamino, peça a desconexão ao suporte.

Meu banco conecta com a Kamino?

Para o extrato, conectam pelo Open Finance: Banco do Brasil, Bradesco, BTG Pactual, Caixa Econômica Federal, Inter, Itaú, Nubank, Safra, Santander, Sicoob, Sicredi e XP. Para pagar e cobrar pela Kamino, há integração de pagamentos com Itaú, Bradesco, Santander, Sicredi, BTG Pactual e Banco do Brasil. Banco fora dessas listas usa a importação de extrato por arquivo.

Como faço para pagar e cobrar pelo Itaú, Bradesco, Santander, Sicredi ou BTG Pactual pela Kamino?

Em Configurações › Contas e integrações bancárias, abra a conta corrente e, no cartão Pague e cobre pelo seu banco, clique em Conectar e confirme. A Kamino acerta o convênio com o banco, e o cartão mostra Ativa quando estiver pronto.

Onde consigo as chaves de API do Banco do Brasil?

No aplicativo da empresa no portal de desenvolvedores do Banco do Brasil. São três: Developer application key, Client ID e Client secret. Você cola as três no cartão Pague e cobre pelo Banco do Brasil, depois de clicar em Conectar.

Conectei a conta para pagar. Por que o extrato não chega?

A integração de pagamentos não traz o extrato. Conecte também o cartão Receba saldo e extrato do banco na Kamino, pelo Open Finance.

Troquei a senha do internet banking e a conexão parou. O que faço?

Abra a conta em Configurações › Contas e integrações bancárias e clique em Reconectar no cartão do extrato. A conexão pede a senha nova, e o extrato volta a chegar.

Respondeu à sua pergunta?