Antes de começar
Para realizar a integração, certifique-se de cumprir os seguintes requisitos:
Conta no Portal Developers do Banco do Brasil (crie a sua em developers.bb.com.br/home, caso ainda não tenha).
Acesso de administrador à conta PJ no Internet Banking do Banco do Brasil.
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 Banco do Brasil
Após fazer login na plataforma do banco, acesse a área de notificações ou pendências para assinar os termos de utilização da API. Leia os documentos, marque as caixas de consentimento e avance até concluir.
Na tela de aplicações, clique em Nova Aplicação e preencha:
Nome da aplicação: API-Qive
Descrição da aplicação: Conexão de API entre Qive e Banco do Brasil.
Ícone da aplicação (opcional).
Selecione a opção APIs com contratação online pelo Portal Developers BB e escolha Pagamentos em lote para habilitar a operação via Qive.
Com o aplicativo criado, clique nele e acesse o ícone de avião de papel na barra lateral esquerda para enviar para produção.
Preencha o CNPJ da sua empresa, clique em Pesquisar CNPJ, confira os dados e clique em Próximo.
Nota: você só conseguirá concluir o fluxo se a sua conta do Portal de Desenvolvedor tiver poderes administrativos na conta da empresa. Caso contrário, o administrador deverá autorizar o envio para produção antes.
Leia o Termo de Adesão até o final e assine-o caso esteja de acordo.
Atenção! As credenciais são exibidas apenas uma vez no momento em que são geradas. Copie e salve o Client ID e o Client Secret em um local seguro imediatamente. Se você perder esses dados, será necessário refazer o processo para gerar novas credenciais.
Com o certificado, o Client ID, o Client Secret e Application Key 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, Client Secret e Application Key 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.