Atenção! O BTG tem duas conexões: a do BTG original e a conexão para clientes enterprise da instituição. Para clientes enterprise, estão disponíveis operações de boleto e Pix. O processo de criação é o mesmo — basta escolher a conexão adequada e as credenciais pedidas.
Antes de começar
Para concluir a conexão, você vai precisar de:
Acesso de administrador à conta PJ no BTG (Internet Banking).
Permissão para criar e ativar conexões na Qive.
Um lugar seguro para guardar o certificado e as credenciais geradas pelo banco.
Gere as credenciais no BTG
Acesse a página de desenvolvedores do BTG e desça até encontrar a opção Integrações.
Clique em Ir para Developers e, em seguida, em Criar aplicativos.
Na tela seguinte, clique em Criar Aplicativos e preencha os dados do aplicativo.
💡 Como o ambiente de Sandbox é voltado apenas para testes simulados, certifique-se de que a chave no canto superior direito esteja selecionada como Produção para habilitar a conexão real.
Preencha e clique em Continuar:
Nome do aplicativo: API-Qive
Descrição do aplicativo: Conexão de API entre Qive e BTG.
URLs de redirecionamento: https://app.kobana.com.br/callbacks/oauth
Modelo de integração: First party - Consumir recursos de contas próprias
Tipo: Confidencial
Na tela de escopos, selecione todas as opções que contemplem Pagamentos e clique em Continuar.
Após o processamento, a nova aplicação aparecerá na lista. Clique nos três pontinhos ao lado direito para abrir os detalhes. Confirme que os escopos abaixo estão marcados:
Banking: Saldo e Extrato
Banking: Pagamentos e Transferências (
brm:btg:empresas:banking:paymentsebrm:btg:empresas:banking:payments.readonly)
Na aba Chaves, guarde o Client ID e o Client Secret.
Com o certificado, o Client ID e o Secret em mãos, você já pode configurar a conexão na Qive.
Insira o certificado na Qive
Caso a empresa já tenha um certificado digital cadastrado e válido na plataforma, siga para a próxima etapa.
Se o certificado ainda não estiver cadastrado, siga as orientações abaixo:
Siga as etapas abaixo para realizar a integração:
No menu superior, clique no seu Perfil e selecione Detalhes da Conta.
Acesse a aba Certificados & Agendamentos.
Localize o quadro de Certificado A1 e clique no botão Escolher Arquivo.
Navegue em seu computador e selecione o arquivo do certificado.
No campo logo abaixo, digite a senha do certificado.
Dica: Certifique-se de que o Caps Lock não está ativo, pois a senha diferencia maiúsculas de minúsculas.
Clique no botão azul Enviar Certificado com segurança.
Crie a conexão na Qive
No menu lateral esquerdo, acesse Contas a Pagar e clique em Bancos.
Observação: se ainda não houver bancos configurados, a tela de configuração também é exibida ao clicar no botão Pagar.
Selecione o Banco Inter e clique em Iniciar configuração. Preencha os quatro blocos da tela:
Uma tela de configuração irá aparecer e alguns dados deverão ser preenchidos corretamente para que a conexão seja bem sucedida.
Dados da empresa: informações cadastrais da empresa responsável pela conta bancária. Se houver apenas um CNPJ selecionado na listagem de Contas a Pagar, os campos vêm preenchidos automaticamente; se estiver em "Todas as empresas", selecione o CNPJ manualmente.
Dados bancários: agência, conta corrente e tipo de conta que será integrada.
Certificado Digital A1: mantenha a opção "O Certificado Digital A1 presente na Qive é o mesmo do meu banco" se já for o mesmo cadastrado; caso contrário, desmarque e clique em Importar Certificado Digital. O certificado precisa ser o mesmo cadastrado no banco, nos formatos .pfx ou .p12.
Dados de configuração bancária: insira o Client ID e Client Secret gerados no Passo 1.
Clique em concluir configuração. Uma mensagem confirmará que a conexão foi realizada com sucesso e o botão Pagar ficará habilitado para o Banco Inter na Qive.
Nota: caso ocorra algum erro, uma mensagem será exibida e você deve retornar à tela e revisar os dados fornecidos.
As informações solicitadas podem variar de acordo com o banco. Tenha em mãos os dados necessários para continuar a configuração.