Guia de Integração | Banco Inter
1. Introdução
A integração com APIs Bancárias para a emissão de cobranças representa um avanço estratégico para empresas que buscam automatizar e otimizar sua gestão financeira. Ao conectar diretamente o SGP às instituições bancárias, elimina-se a necessidade de processos manuais, como geração de arquivos de remessa e importação de retornos, reduzindo significativamente erros operacionais e retrabalhos.
Entre os principais benefícios dessa integração destacam-se:
-
Automatização do processo de cobrança: o boleto é emitido e registrado automaticamente no banco a partir do SGP, garantindo maior agilidade e conformidade com as regras bancárias.
-
Redução de erros e inconsistências: a comunicação direta evita falhas comuns em processos manuais, como duplicidade de boletos ou divergências de valores.
-
Maior segurança e confiabilidade: os dados são transmitidos de forma padronizada e segura, minimizando riscos de fraudes ou informações incorretas.
-
Controle centralizado: todas as informações financeiras ficam concentradas no SGP, facilitando o acompanhamento de recebimentos e inadimplência.
-
Agilidade na tomada de decisão: relatórios atualizados permitem uma visão clara da saúde financeira da empresa.
Assim, a integração bancária não apenas simplifica o processo de cobrança, mas também proporciona maior eficiência operacional, segurança e controle estratégico sobre o fluxo de caixa da organização.
Antes de iniciar o processo, consulte nossa FAQ – Atenção à Segurança da sua Integração! para garantir uma implementação mais segura e eficiente.
2. Dados necessários para integrar ao SGP
Nessa etapa é preciso acessar a plataforma do Banco Inter para criar uma aplicação que vai fornecer as credenciais em produção para a integração com o SGP.
Você vai precisar dos seguintes dados:
- Número da Agência
- Número da Conta com Dígito
- Client ID
- Client Secret
- Certificado + Senha
Durante essa etapa, crie a aplicação no Banco Inter seguindo as instruções do suporte do banco.
Atenção: o certificado gerado na plataforma do Banco Inter precisa ser convertido para o formato PFX para ser usado no SGP.
3. Integração do Portador
Mesmo sendo uma integração via API, os dados da conta são necessários para a emissão dos boletos.
- Você será direcionado para a página de cadastro de Portador, onde poderá inserir e configurar os dados necessários.
Na guia Dados Bancários configure:
- Código do Banco: 077 - Banco Inter
- Agência
- Conta Cedente (com dígito na mesma linha)
- Carteira: 0
Em seguida, na guia Relacionamentos da Empresa selecione:
- Empresa beneficiária
- Nome do beneficiário
- CPF ou CNPJ do beneficiário
Confirme essas informações com o cliente para evitar rejeição de boletos por dados incorretos.
Por fim, devemos configurar os Juros e Multa, acessando a guia Juros, Multas, Descontos e Taxas
O Banco Inter aceita apenas as opções:
- Percentual de multa e juros ao mês
- Percentual de multa e juros ao dia
- Isento (valor zero)
Para uma melhor compreensão, recomendamos a leitura da nossa documentação de Configuração de Juros e Multa
4. Ponto de Recebimento (Caixa)
O ponto de recebimento é o local onde os pagamentos de boletos serão registrados.
- Na guia Dados Básicos, defina o Nome do caixa e selecione o Portador padrão.
5. Cadastro do Gateway de Boletos
Agora vamos integrar o Gateway ao SGP para emissão de boletos.
Clique no botão Cadastrar e preencha da seguinte forma:
- Nome da Integração: Banco Inter V3 / Boleto Híbrido
- Descrição
- Usuário: Client ID
- Senha: Client Secret
- Habilite Pagamentos via Boleto
- Selecione o Portador Banco Inter
- URL de Notificação: https://url_do_seu_sgp/ws/inter3/id_do_gateway/notificacao
- Carregue o Certificado A1 no formato PFX e informe a senha
- Caso queira usar o Boleto Hibrido, marque Gerar Boleto/Carnê + Pix.
Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais
Imagem de Referência (API Boleto)
6. Cadastro do Gateway PIX
O caminho de acesso é o mesmo do cadastro de Gateway de Boleto, apenas devemos ajustas os dados preenchidos.
Esse modelo de integração é apenas para emissão de QRCode PIX, caso queira uma integração de Boleto Hibrido, usar o processo da seção anterior!
Clique no botão Cadastrar e preencha da seguinte forma:
- Nome da Integração: Banco Inter V3 / Boleto Híbrido
- Descrição
- Usuário: Client ID
- Senha: Client Secret
- Chave PIX
- Habilite Pagamentos via PIX
- Selecione o Portador Banco Inter ou o Portador criado para emissão do PIX
- URL de Notificação: https://url_do_seu_sgp/ws/inter3/id_do_gateway/notificacao
- Carregue o Certificado A1 no formato PFX e informe a senha
Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais
Imagem de Referência (API PIX)
7. Informações Adicionais
- A URL de notificação deve obrigatoriamente utilizar o protocolo HTTPS. Caso ainda não possua um endereço com HTTPS, entre em contato com o suporte para verificar a possibilidade de aquisição de um subdomínio SGP.
- No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
- Para identificá-lo, siga os passos:
- Crie um gateway deixando o campo “URL de notificação” em branco.
- Anote o ID gerado.
- Em seguida, cadastre a URL de notificação utilizando esse ID.
- Para identificá-lo, siga os passos:
- Para integrações que exijam uma rotina de processamento de retorno, é necessário acionar o suporte para que seja feita a configuração dessa rotina.
-
A seguir, listamos algumas funcionalidades disponíveis para a sua integração:
| Funcionalidade | Banco Inter V3 |
|---|---|
| Boleto - Registro | ✔️ |
| Boleto - Retorno | ✔️ |
| Boleto - Cancelamento | ✔️ |
| Boleto - Tempo de Retorno | Rotina |
| PIX - Emissão | ✔️ |
| PIX - Cancelamento | ✔️ |
| PIX - Tempo de Baixa | Rotina/Webhook |
| PIX Híbrido ou Avulso? | Ambos |
