Banco Inter

objetivo bem vindo à documentação do conector do banco inter , que integra as soluções de pagamentos, pix e cobrança para automatizar operações financeiras, como a gestão de boletos e pagamentos essa documentação tem como objetivo orientar os desenvolvedores na implementação e integração com as apis do banco inter, garantindo uma experiência completa e unificada para mais informações, o portal developers é acessível através do link https //developers inter co/ https //developers inter co/ ou https //developers inter co/docs/introducao/nossas apis https //developers inter co/docs/introducao/nossas apis diretamente introdução o conector do banco inter da fluid api possibilita a integração com três soluções principais pagamentos permite a realização e o acompanhamento de transações de pagamento pix habilita transações instantâneas via pix, incluindo a geração de qr codes e a consulta de operações cobrança oferece ferramentas para a criação, gerenciamento e acompanhamento de cobranças com essa integração, os desenvolvedores podem oferecer aos seus clientes uma experiência completa, utilizando as facilidades e a robustez das apis do banco inter autenticação todas as apis utilizam um mecanismo de autenticação baseado em tokens para iniciar a integração, siga estes passos obtenção das credenciais cadastre sua aplicação no portal do banco inter para receber o client id e o client secret geração do token realize a requisição ao endpoint de autenticação para obter um token de acesso válido, que deverá ser incluído no header de todas as chamadas subsequentes renovação do token verifique a validade do token e implemente a rotina de renovação conforme especificado na documentação do banco inter observação consulte a documentação oficial de autenticação para mais detalhes sobre os parâmetros e fluxos o que é mtls? ​ https //developers inter co/docs/introducao/autenticacao mtls#o que %c3%a9 mtls o tls mútuo, ou mtls, é um método para autenticação mútua o mtls assegura que as partes em cada extremidade de uma conexão de rede são quem afirmam ser, verificando que ambas têm a chave privada correta as informações dentro de seus respectivos certificados tls fornecem a verificação adicional o mtls é frequentemente usado em uma estrutura de segurança zero trust para verificar usuários, dispositivos e servidores dentro de uma organização também pode ajudar a manter as apis seguras zero trust significa que nenhum usuário, dispositivo ou tráfego de rede é confiável por padrão, uma abordagem que ajuda a eliminar muitas vulnerabilidades de segurança como o inter usa o mtls? ​ https //developers inter co/docs/introducao/autenticacao mtls#como o inter usa o mtls 1\ chave pública e privada https //developers inter co/docs/introducao/autenticacao mtls#1 chave p%c3%bablica e privada a tls trabalha utilizando uma técnica chamada criptografia de chave pública, que depende de um par de chaves — uma chave pública e uma chave privada qualquer coisa criptografada com a chave pública pode ser descriptografada apenas com a chave privada qualquer coisa criptografada com a chave privada pode ser descriptografada apenas com a chave pública portanto, um servidor que descriptografa uma mensagem que foi criptografada com a chave pública prova que possui a chave privada qualquer pessoa pode visualizar a chave pública verificando o certificado tls do domínio ou do servidor 2\ certificado tls https //developers inter co/docs/introducao/autenticacao mtls#2 certificado tls um certificado tls é um arquivo de dados que contém informações importantes para verificar a identidade de um servidor ou dispositivo, incluindo a chave pública, uma declaração de quem emitiu o certificado (os certificados tls são emitidos por uma autoridade de certificação) e a data de expiração do certificado 3\ handshake tls ​ https //developers inter co/docs/introducao/autenticacao mtls#3 handshake tls o handshake tls é o processo de verificação do certificado tls e da posse da chave privada pelo servidor o handshake tls também estabelece como a criptografia ocorrerá quando o handshake estiver concluído criando a conexão obs criar conexão docid 1pcvn0mjbfkujhmhj86k nosso passo a passo criar uma conexão estes são os seguintes parâmetros de configuração da conexão banco inter que serão requisitados em sua criação nome identificador da conexão para facilitar sua organização descrição campo opcional para detalhar o propósito da conexão e sua utilização dentro do seu fluxo de integração id do cliente informe o client id da aplicação registrada no banco inter chave secreta do cliente informe o client secret da aplicação certificado público chave pública necessária para autenticação segura com a api do banco inter certificado privado chave privada utilizada para assinar as requisições enviadas à api do banco inter escopo defina os perfis de acesso da conexão, conforme a necessidade da sua aplicação ambiente escolha entre os ambientes sandbox (teste) ou produção url do ambiente informe a url da api do banco inter correspondente ao ambiente escolhido configuração inicial para utilizar o conector, é necessário configurar os seguintes recursos e operações recursos disponíveis boletos operações para emissão, consulta e listagem de boletos pagamentos operações para busca e inclusão de pagamentos utilizando códigos de barras ou linha digitável operações por recurso recurso boletos listar boletos descrição lista boletos cadastrados na conta especificada parâmetros requeridos accountid identificador da conta (obtido via api /v1/accounts ) bankslipid identificador único do boleto parâmetros opcionais offset número de itens a ignorar antes de formar a resposta limit número máximo de itens a retornar recurso pagamentos buscar pagamentos descrição busca pagamentos realizados em um período específico parâmetros requeridos datainicio data de início da pesquisa (formato yyyy mm dd ) datafim data de fim da pesquisa (formato yyyy mm dd ) incluir pagamento com código de barras descrição realiza o pagamento de um título utilizando código de barras ou linha digitável parâmetros requeridos codbarralinhadigitavel código de barras ou linha digitável valorpagar valor a ser pago datavencimento data de vencimento do título (formato yyyy mm dd ) parâmetros opcionais datapagamento data para efetivação do pagamento (se não informado, será feito no mesmo dia; formato yyyy mm dd ) exemplo de configuração pagamento de boleto e pagamento de pix dicas e considerações formato de datas certifique se de utilizar o formato yyyy mm dd para campos de data autenticação a configuração das credenciais da api do banco inter é essencial para a comunicação com os endpoints limites de paginação utilize os parâmetros offset e limit para gerenciar grandes volumes de dados retornados conclusão o conector banco inter oferece uma interface prática e segura para gerenciar operações financeiras, possibilitando maior automação e eficiência em processos críticos com recursos como emissão e pagamento de boletos, é uma ferramenta essencial para integrações financeiras modernas