¶ BTG Pactual
A integração com o banco BTG Pactual tem como objetivo principal, a emissão e compensação de boletos bancários. Através de APIs, o HubSoft irá se comunicar com o banco BTG Pactual para:
- Emitir Boletos
- Alterar Vencimento de Boletos
- Cancelar Boletos
- Verificar Pagamentos
¶ Gerar Credenciais - Painel BTG Pactual
Para realizar a integração, o primeiro passo é realizar a abertura de sua conta BTG Pactual (clique aqui)
- Com a sua conta aberta, faça a liberação do painel do desenvolvedor para seu usuário, e acesse o mesmo: https://console.developers.empresas.btgpactual.com/.
Obs:. Também é possivel criar os aplicativos direto no painel do banco.
- Ao acessar o painel, clique em Aplicativos > Aplicativos
- Altere para Produção, basta marcar a chave marcada, e clique em Criar Aplicativo:
Em Dados do aplicativo, preencha os dados e continue, digite:
- Nome do aplicativo: nome da sua preferência
- Tipo: Confidencial
- Descrição aplicativo: nome da sua preferência
- Modelo de integração: First party
Em Escopos utilizados, escolha todos marcados da imagem abaixo, sendo eles:
- Perfil do usuário
- Banking: Boleto Cobrança
Irá mostrar um resumo do que foi selecionado, clique em continuar para salvar:
Agora na aba Aplicativos, irá mostrar o aplicativo criado, para visualizar os dados, clique em 3 pontinhos > Detalhes:
Clique na aba Chaves e copie o Client ID e Secret, eles são necessários para cadastrar a integração.
¶ Cadastrar Integração - HubSoft
Agora, com todos os dados em mãos, vamos até o HubSoft para cadastrar a Integração.
O primeiro passo é acessar no HubSoft o Menu lateral > Configuração > Integrações > Pagamento, conforme imagem abaixo
Clique em Adicionar, para inserirmos os dados da Integração.
Nessa etapa, escolha o Gateway de Pagamento como BTG Pactual, e vamos precisar do Client ID e Client Secret, que você coletou no painel do BTG.
Preencha os parâmetros desejados da imagem acima, os obrigatórios são:
- client_id: client_id coletado no painel do BTG
- client_secret: secret coletado no painel do BTG
- id_conta: ID da conta esta vinculada no BTG. O ID da Conta é composto por CNPJ-CODIGOBANCO-AGENCIA-CONTA. Código do Banco é 208. (Exemplo: 29507487000185-208-50-005568035)
Feito isso clique em Salvar
- Após a integração ser criada, agora precisamos coletar o Callback URL que foi gerado e vincula-lo nas chaves no painel do BTG, copie a que foi gerada conforme a imagem marcada abaixo:
¶ Atualizar Credenciais - Painel BTG Pactual
Após feito o processo acima, acesse o painel do BTG novamente, vá no Aplicativo que foi criado, e clique em Detalhes:
Clique em Editar Aplicativo:
Adicione no campo URl’s de redirecionamento a URL que copiou no sistema Hubsoft e clique em continuar. Na aba de Escopos, basta clicar também em continuar:
No Resumo, será possível visualizar que agora possui URL de Redirecionamento, veja se ficou correto e clique em continuar, irá solicitar uma mensagem, digite a mensagem da sua preferencia e clique em confirmar.
¶ Adicionar URL Webhook - Painel BTG Pactual
Ainda no painel do BTG, vá na aba Webhooks, e clique em Adicionar Webhook:
Adicione a URL que foi copiada na HubSoft, adicione uma descrição e clique em Adicionar Eventos:
Clique em Boletos para abrir as opções, selecione bank-splits.paid, e clique em Adicionar eventos:
Para Salvar, clique em Adicionar Webhook:
¶ Gerar Authorization Code - HubSoft
O BTG adota um método de autenticação distinto do usual, exigindo que uma autenticação seja realizada diretamente no banco para permitir a emissão de boletos. Para prosseguir, é essencial primeiro verificar se as credenciais fornecidas já foram aceitas. O processo só poderá continuar uma vez que o status da última versão do aplicativo esteja configurado como «Ativo».
Antes de prosseguir, verifique se o BTG não alterou o client_id e client_secret no painel depois de ter atualizado versões.
Credencias estando corretas e o Status do Aplicativo estando Ativo, vá na integração e clique em Ações > Gerar Authorizations Code:
Com isso você será encaminhado para uma tela de login no banco:
Logue no BTG com seu acesso, CPF e Senha:
Selecione os checkbox que tiverem, para liberar a api para conseseguir consultar sua conta:
Ao confirmar na tela do banco, você será encaminhado para uma nova tela, ela informa que deu sucesso a geração do CODE, e o mesmo já foi vinculado na integração, pode fechar essa aba.
Agora com o Code já vinculado na integração, basta testar a integração para ver se deu tudo certo. No sistema, Menu lateral > configuração > Integrações > Integração de Pagamento > Ações > Testar Integração:
A autenticando dando sucesso, esta tudo certo, integração configurada com sucesso!
¶ Configurar Forma de Cobrança - HubSoft
Agora vamos configurar a Forma de Cobrança, que será associada a integração BTG Pactual para vínculo aos seus clientes.
Então, no menu lateral acesse o menu Configuração > Financeiro > Forma de Cobrança, conforme imagem abaixo
Clique em Adicionar uma Forma de Cobrança e preencha o Banco como BTG Pactual e selecione a Integração que foi recém adicionada.
Feito isso, acesse a aba Configuração e preencha os dados conforme a imagem abaixo:
Feito isso, está tudo pronto para você iniciar a emitir seus boletos no HubSoft de forma integrada ao BTG Pactual.
¶ BOLETO + PIX
Também é possível emitir o Boleto + Pix direto, para isso, na integração, basta adicionar o parametro boleto_pix como true, pois quando um boleto for registrado, o mesmo terá os dados do QRCODE gerado, lembrando que para ativar essa funcionalidade, é preciso ter uma chave pix registrada na sua conta.
Nessa modalidade, ao emitir um boleto bancário, automaticamente já é emitido um PIX com os mesmos dados do boleto. Dessa forma, em um único boleto, o cliente conseguirá pagar utilizando o código de barras ou QR Code do PIX.
¶ WEBHOOK
O Webhook é configurado no painel do BTG, ele foi configurado na etapa «Adicionar URL Webhook - Painel BTG Pactual» , sendo assim, assim que um boleto constar como pago no sistema do BTG, eles automaticamente enviam para hubsoft o informe daquele pagamento.
Por mais que o Banco BTG Pactual envie Webhooks para o sistema, é importante ter a Rotina de VERIFICA COBRANÇA GATEWAY adicionada, para assim, nenhum boleto ficar sem seu devido recebimento.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados ao BTG Pactual. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ A integração com o BTG Pactual, transmite baixas automaticamente?
Sim, caso a forma de cobrança permita baixas e na integração tenha o parâmetro transmite_baixa com valor true indica se a integração irá transmitir as baixas de títulos, por exemplo: recebimentos na empresa, descontos totais, ou seja, situações onde o título deverá ser baixado no BTG. Valores aceitos (true|false). O não preenchimento desse atributo, faz com que o sistema não transmita as baixas para o BTG.
¶ Por que o boleto do cliente não registrou via API?
Neste caso, por se tratar de erros que podem ser muito específicos referentes a algum dado do cliente ou a comunicação entre sistema e Gateway de Pagamento, recomendamos o contato com nossa equipe de suporte para que possamos lhe auxiliar da melhor forma possível a solucionar esta questão.