A comunicação via API é a forma mais eficiente de trocar informações com um banco, permitindo que certos retornos sejam feitos até mesmo em tempo real. Neste artigo, vamos mostrar como fazer a conexão com a API do Santander.
1. Acesse a sua conta de PJ no Santander
Para começar, acesse o portal de desenvolvedores do Santander, clique em Entrar e em seguida no botão Acesse com sua conta PJ.
Selecione de que forma você deseja realizar este acesso, se enquanto Desenvolvedor ou Administrador.
O sistema vai pedir as suas informações de acesso, como usuário, conta, agência e senha. Lembrando que existem algumas regras para usar o portal de desenvolvedor do banco:
Somente o Usuário Master consegue criar aplicações em Produção, no Dev Portal;
É necessário que o Usuário Master tenha o ID Santander habilitado;
É necessário que o Usuário Master tenha um e-mail cadastrado associado ao seu usuário;
Para que o Usuário Master tenha acesso a duas ou mais empresas dentro do Dev Portal, é necessário que o mesmo faça o Login PJ para as diferentes empresas. Assim, ficarão associadas à sua conta.
2. Crie um aplicativo em produção
Uma vez logado, você precisa criar um aplicativo em produção, selecionando a opção -Criar aplicação via parceiros- para gerar as credenciais necessárias.
Clique em -Criar aplicação via parceiros-, como na imagem abaixo:
Atenção! Certifique-se de que o check no lado superior direito está em Produção.
No fluxo de criação de credenciais, após escolher a opção -Criar aplicação via parceiros-, busque pelo nome da empresa parceira -Kobana- ou faça uso do cnpj para a identificar -05.813.794/0001-26- e siga o passo a passo de acordo com a imagem abaixo.
Escolha as opções de acordo com a operação que você pretende fazer. É possível fazer opções de recebimentos de Boletos e Pix, extrato e pagamentos.
Insira dados referentes a esta aplicação que possam o auxiliar na identificação da mesma com maior facilidade. Em seguida, clique em -Criar Aplicação-
3. Copie o ClientID e Client Secret
Após o processo ser aprovado, você deve visualizar as informações que vamos precisar, o ClientID e Client Secret.
Ao criar a aplicação fazendo uso da Kobana como parceira, não será necessário que você vincule um certificado à sua conexão ao criá-la na Kobana.
4. Crie a conexão com o Santander
Com as informações que você precisa em mãos, é hora de criar a conexão com o Santander. Escolha a opção da imagem abaixo para iniciar o processo:
Na tela seguinte, preencha as informações pedidas pelo sistema. Primeiro, escolha as permissões que a API terá, ou seja, o que ela poderá fazer, como gerar boletos, fazer transferências e consultar extrato. Nas credenciais, client ID e client Secret, preencha as informações que você copiou no passo 3. Siga sem escolher um certificado, uma vez que você não salvou um junto ao banco ao fazer uso da Kobana como empresa parceira.
Após inserir os dados, clique no botão Validar Conexão para que o sistema possa conferir as credenciais.
5. Associe a nova conexão às operações
Para a conexão de fato funcionar, é preciso associá-la à operação que você quer fazer. Nos links abaixo, você encontra como associar a conexão a cada operação: