Como solicitar os dados necessários

Passo 1 - Acesso ao portal de desenvolvimento Santander: 

1: Certifique-se que o usuário do cliente é o Usuário Master* da conta.

2: Acessar o portal de desenvolvimento do Santander através do link: 
https://developer.santander.com.br - Nesse acesso deve ser logado o usuário master da

3: Clique em “Entrar”;

4: Clique em “Acesse com sua conta PJ" 

*OBS: Somente o Usuário Master, Secundário ou um usuário convidado pelo Master conseguem realizar a criação de
aplicações em Produção 

5: Inserir "Agência";

6: Inserir "Conta";

7: Inserir "Usuário";

8: Inserir "Senha";
9: Clicar em "Login".  

Passo 10: Uma vez logado no portal de desenvolvedor como Usuário Master acesse ícone de opções de usuário (no canto superior direito) e clique em “Minhas aplicações” 

Passo 2 - Criação da aplicação: 


1: Selecionar o marcador "Sou desenvolvedor";

2: Crie um nome para o aplicativo (a sua escolha);

3: Encaminhar o certificado para validação do banco (Padrão A1 - deverá ser emitido por um órgão autorizado e ser de 2048 bits)**;

4: Descrição da aplicação (opcional)

5: Busque pela API "Emissão de boletos" e "Geração de QRCode" (podem estar listados como API-PIX e API-Cobranca)

6: Selecione as 2 API's

7: Clique em Enviar 

Após o envio no Passo 7, será encaminhado um e-mail ao endereço vinculado ao Usuário Master, confirmando a criação da aplicação

** ▪ O certificado deve possuir o atributo “Key Usage” habilitado para “Digital signature” ou “Key agreement",
“Enhanced Key Usage” deve ser no mínimo “Client Authentication (1.3.6.1.5.5.7.3.2)”.
▪ Certificado com repasse dos arquivos no formato PEM de uma certificadora autorizada (ACs externas confiáveis).
▪ Tipo x509 v3
▪ Mínimo de 90 dias de validade.
▪ Arquivos a serem repassados ao Santander:
• certificado raiz (root)
• certificado intermediário
• certificado parceiro
• certificado com a cadeia completa (três itens acima)
▪ O certificado não pode ser auto assinado e tem que ser emitido por uma CA externa.

Passo 3 - Acessar as aplicações: 

1: Clique no ícone usuário; 
2: Clique em Minhas aplicações. 

Passo 4 - Coleta das credenciais: 

1: Serão geradas 2 chaves para o cliente (ClientID e ClientSecret); 

2: Para copiar, basta selecionar o botão ao lado de cada uma. 

Criação do Workspace

Passo 1 - Importe a collection em anexo (Final da documentação) no programa Insomnia.

 

Passo 2 - Siga os passos da importação: 

Passo 3 - Com a collection já importada, vá para adicione o certificado na rota host

Host: https://trust-open.api.santander.com.br/auth/oauth/v2/token 

Passo 4 - Adicione a rota host, selecione o PFX, adicione o arquivo + senha e conclua a inclusão: 

 


Passo 5 - Realize a autenticação pela rota "Token" gerando o "access_token": 

Passo 6 - Realizar a criação do Workspace na rota "Criar Workspace" informando o "access_token" no header: 

JSON de exemplo: 

{
"type": "BILLING",
"description": "Workspace de Cobrança",
"covenants": [
{
"code": "Número do convênio"
}
]
}

Envio:

Feito isso o status de sucesso esperado é "201" com uma estrutura de retorno semelhante com a que segue abaixo: 

{
"id": "eb30250f-1228-439c-ac9f-29fe72ba39b5", 
"status": "ACTIVE, INACTIVE ou SUSPENDED",
"TYPE": "",
"covenants": [
{
"code": "Número do convênio" - Deve ser definido o número de convênio
}
]
}

Passo a passo em vídeo: 

Como configurar as credenciais no PlugBoleto

Após obter os dados necessários, (client_id e client_secret) e um certificado dinâmico (client certificate), tais dados deverão ser cadastrados no PlugBoleto.

1) Cadastrar credencias no convênio

Na página de convênios você irá encontrar o campo "Registro instantâneo", esse campo é onde você habilita o uso desse recurso no seu convênio.

Quando o campo Registro instantâneo for ativado deve aparecer logo abaixo dois novos campos o  campo "API - ID", onde deve ser informado o client_id informado pelo Santander, e o campo "Segredo" onde deve ser informado o client_secret.

Exemplo do cadastro das credenciais no portal do Plugboleto:

2) Fazer o upload do client certificate

Após o preenchimento das informações clicar em Salvar para realizar o upload do certificado.

Para visualizar ou trocar o certificado, após o cadastro, edite novamente o convênio e o certificado será exibido como na imagem abaixo: