¶ Inter
A integração com o banco Inter 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 Inter para:
- Emitir Boletos
- Emitir Boletos + PIX
- Cancelar Boletos
- Verificar Pagamentos
- Receber Webhooks Pagamentos
¶ Painel Inter
Para realizar a integração, o primeiro passo é realizar a abertura de sua conta PJ Inter (clique aqui)
-> Com a sua conta aberta, acesse o painel PJ (clique aqui), clique em Conta Digital > Minhas Aplicações:
-> Agora vamos gerar as credenciais, clique em Nova Aplicação, conforme imagem abaixo:
-> Digite o Nome da Aplicação e a Descrição desejada:
-> Selecione os escopos, selecione os da API Cobrança, conforme imagem abaixo:
-> Para visualizar os dados da aplicação, clique em Ações > Detalhes Aplicação:
-> Para visualizar as chaves, é ncessário baixar o certificado, será baixado um zip na sua maquina contendo a chave publica e a chave privada do certificado.
-> Aplicação criada, salve o clientID, clientSecret e o certificado, os mesmo vão ser utilizados para criar a aplicação na HubSoft
¶ No 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
-> Escolhar o Gateway de Pagamento como Inter - API, e nessa etapa vamos precisar do Client ID, Client Secret e do Certificado, que você coletou no painel do Inter.
Preencha os parâmetros desejados da imagem acima, os obrigatórios são:
- versao: Versão que deseja utilizar das API Inter. (v1 - API Cobrança | v2 - API Cobrança + PIX)
- client_id: client_id coletado no painel do Inter
- client_secret: client_secret coletado no painel do Inter
- conta_correte: Sua conta corrente do Inter
- certificado: Colar a chave publica + chave privada do certificado gerado pelo Inter
Feito isso clique em Salvar
Após criar a integração, você pode clicar em Ações para realizar diversas funções, como visualizar, editar, acessar o histórico, testar a integração para garantir que tudo esteja correto e inativá-la, se necessário.
OBS: Depois de salvar a integração, clique em Ações e selecione Testar Integração para confirmar se ela está funcionando adequadamente
Feito isso, agora vamos configurar a Forma de Cobrança, que será associada com o seu Cliente e Boletos
Então, no menu lateral acesse o menu Configuração > Financeiro > Forma de Cobrança, conforme imagem abaixo
Clique em Adicionar e preencha o Banco como INTER - API e selecione a Integração que você acabou de adicionar
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 Inter.
¶ BOLETO + PIX
Também é possível emitir o Boleto + Pix direto, para isso, na integração, basta adicionar o parametro versao como v2, que quando um boleto for registrado, o mesmo terá os dados do QRCODE.
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 é ativado para seu client_id assim que emite o primeiro boleto na hubsoft, sendo assim, assim que um boleto constar como pago no sistema do Inter, eles automaticamente enviam para hubsoft o informe daquele pagamento.
Por mais que o Banco Inter 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 com a Integração de Pagamento com o Inter. 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.
¶ Se ocorrer falha na transmissão dos boletos para o banco Inter, como proceder?
Caso haja alguma falha na transmissão dos boletos, é necessário identificar primeiro a causa do problema nos dados de transmissão da fatura, corrigi-la e, em seguida, aguardar a nova transmissão, que geralmente ocorre após 60 minutos.
¶ Como garantir que os pagamentos da integração com a API do Inter sejam reconhecidos no HubSoft?
Para garantir que os pagamentos da API do Inter sejam reconhecidos no HubSoft, siga estas etapas:
1. Assegure-se de que a integração com a API do Inter está configurada corretamente no HubSoft, preenchendo os campos obrigatórios como client_id e client_secret.
2. Certifique-se de que o Webhook para o seu client_id está ativado, para que as notificações de pagamento sejam enviadas automaticamente ao HubSoft assim que um boleto for pago.
3. Configure a rotina «VERIFICA COBRANÇA GATEWAY» no HubSoft para monitorar periodicamente os recebimentos e registrar todos os pagamentos.
4. Realize testes para confirmar que as credenciais e configurações estão corretas, usando a opção «Ações > Testar Integração».