Primeiros Passos

Acesso ao ambiente de homologação

Antes de utilizar as soluções de API do Banco BS2 em seu ambiente de produção, primeiro é preciso realizar o processo de homologação.

Para isso, entre em contato com o Banco BS2 através do e-mail [email protected].

Acesso ao ambiente de produção

O acesso ao ambiente de produção deverá ser solicitado à equipe Comercial após a conclusão dos testes em homologação.

⚠️

Importante:

Em produção, todas as requisições deverão conter um código fornecido pelo Banco BS2 no Header User-Agent. Consulte seu canal de relacionamentos em caso de dúvidas.

Criação das chaves API

As APIs são disponibilizadas para clientes e parceiros do Banco BS2 através de uma chave de acesso. Para cadastrá-la siga as orientações abaixo:

  1. Acesse: BS2 Empresas e realize o login com o usuário master da conta;
  2. Selecione a opção API Banking;
  3. No menu de Aplicações, selecione a opção Novo;
  1. Preencha o nome do app, a descrição e selecione as APIs que deseja utilizar;
  2. Em homologação, adicione o range de IP 0.0.0.0/32**, e, em produção, o seu IP/range de IPs;

  1. Ao finalizar a criação das chaves, serão liberados em tela as Chaves de Acesso à API, o Scope e o Refresh_Token necessários para uso de cada tipo de API.

*Estarão disponíveis apenas APIs contratadas.

**O BS2 realiza bloqueio por IP no ambiente de produção. É necessário que o parceiro configure o IP à máquinas específicas para que o acesso seja concedido. Com isso, garantimos segurança e confidencialidade dos dados.

**O IP 0.0.0.0 é um bypass para o ambiente de testes e homologação.

Obtenção do Token

Se precisar gerar novamente as credenciais, acesse a plataforma BS2 Empresas >> produto API Banking >> clique no comando Obter Credenciais.

⚠️

Importante:

  • A aplicação é vinculada apenas a conta utilizada durante o cadastro;
  • A chave de acesso é necessária para todas as requisições em nossas APIs.