# 01 Autenticacao

Autenticação .................................................................................................... 12 
Autenticação .................................................................................................. 233 
Autenticação: Operação responsável pela autenticação do código de acesso e criação do token de 
autenticação, que permitirá acessar a API de Cobrança. 
b. Solicitação do Access Token de Homologação (Sandbox) 
COBRANÇA BOLETO 1.0.0 ] e a API de Autenticação Parceiros na lista de APIs disponíveis 
[OPEN API – OAUTH - PARCEIROS 1.0.0]. Ao criar uma app você já terá um Client ID gerado 
b. Geração do Access Token de Homologação (Sandbox): após criar a APP de Homologação, 
nome que você criou no passo anterior. Pronto, o seu Acess token será gerado e dentro 
de X dias você poderá visualizar o seu token de homologação no menu ‘minhas apps’, 
b. Solicitação do Access Token de Produção  
3. Visualizando o access token 
b. Geração do Access Token de Produção: Repita os mesmos passos já realizados para a 
geração de token de homologação, mas dessa vez ao abrir o chamado, preencha o campo 
Client ID ou Nome da APP com os dados da APP de produção. O seu token será 
da requisição no campo x-api-key o token de autenticação recebido. Esse token é 
token correspondente ao ambiente que está sendo utilizado.   
na configuração da integração da API, pois esse código gerado é utilizado no recurso de autenticação 
contratado e deseje utilizá-las, precisará gerar o token de autenticação para cada conta específica. 
7.1. Autenticação 
o token de autenticação recebida do Sicredi. Esse token é diferente para o ambiente de Sandbox e 
Produção, deve ser informado o token correspondente ao ambiente que está sendo utilizado. 
A operação POST “token” é responsável por criar uma chave criptografada, denominada 
“access_token”, utilizando o Beneficiário + Cooperativa como usuário (username) e o Código de Acesso 
(password) que foi gerada no Internet Banking. O padrão de autenticação é o OAuth2 e o token utiliza o 
do access_token e do refresh_token, observando os parâmetros “expires_in” (exemplo: 300 segundos) e 
 Para verificar se o acess_token está expirado, deve-se observar o campo “expires_in” que retorna 
a duração do token em segundos. 
O access_token deve ser enviado no cabeçalho das chamadas das próximas operações até que ele 
expire, não deve ser realizado autenticação a cada chamada. Quando o access_token expirar, deve ser 
utilizado o refresh_token para gerar um novo token.  
OBS: Quando da utilização do refresh_token, não será necessário informar os campos 
Quando o refresh_token estiver expirado, deverá ser realizado o fluxo de autenticação normal, com 
Access token 
refresh_token 
autenticação. 
Refresh token 
autenticação 
a refresh_token 
access_token  
Token de autenticação para ser 
token_type  
Tipo do Token 
refresh_token 
novo access_token, sem a 
autenticação com usuário e 
segundos) do Access Token 
segundos) do Refresh Token  
autenticação.  
https://api-parceiro.sicredi.com.br/sb/auth/openapi/token 
https://api-parceiro.sicredi.com.br/auth/openapi/token 
    "access_token": 
Token in the 
    "refresh_token": 
    "token_type": "Bearer", 
Cenário Positivo – Gerando o access_token 
OBS: Sempre verificar o tempo de expiração do access_token, através do campo “expires_in” (Exemplo: 300 
segundos). Caso esteja expirado, deverá usar o refresh_token para gerar um novo token. 
Cenário Positivo  – Utilizando o refresh_token para gerar um novo token 
OBS: Sempre verificar o tempo de expiração do refresh_token, através do campo “refresh_expires_in” 
(Exemplo: 1800 segundos). Caso esteja expirado, deverá gerar um novo access_token. Quando da utilização 
do refresh_token, não será necessário informar os campos “username” e “password”. 
Access token 
Bearer + Token de 
Autenticação  
access_token 
autenticação.  
autenticação. 
autenticação. 
Token de acesso 
Bearer + Token de 
Autenticação  
Acess token obtido 
na autenticação   
Token in the 
Token de 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
contida no token de 
autenticação (authorization). 
Token de 
Bearer + Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de 
Bearer + Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de 
Bearer + Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de 
Bearer + Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de 
Bearer + Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
contida no token de 
autenticação (authorization). 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
Token de acesso 
Token de 
Autenticação  
Acess token 
autenticação   
Token in the 
beneficiário contido no token 
de autenticação 
Token de acesso 
Bearer + Token 
de Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de acesso 
Bearer + Token 
de Autenticação  
Acess token 
autenticação   
Token in the 
no token de 
autenticação 
token de autenticação 
Token de acesso 
Bearer + Token 
de Autenticação 
Acess token 
autenticação  
Token in the 
token de autenticação 
no token de 
autenticação 
Token de acesso 
Bearer + Token 
de Autenticação 
Acess token 
autenticação  
Token in the 
token de autenticação 
no token de 
autenticação 
Token de acesso 
Bearer + Token 
de Autenticação  
Acess token 
autenticação   
Token in the 
token de autenticação 
contida no token de 
autenticação 
Token de 
Bearer + Token 
de Autenticação  
Acess token 
autenticação   
Token in the 
Token de 
Bearer + Token 
de Autenticação  
Acess token 
autenticação   
Token in the 
qualquer tipo de autenticação. Estamos no processo de discussão e implementação de 
uma autenticação via certificado de segurança que ainda não foi finalizado; 
Autenticação: Operação responsável pela autenticação do código de acesso e criação do 
token de autenticação, que permitirá acessar a API de Contratação Webhook. 
tópico abaixo pode ser ignorado, visto que a autenticação na API 
e. Solicitação do Access Token de Homologação (Sandbox) 
COBRANÇA BOLETO 1.0.0 ] e a API de Autenticação Parceiros na lista de APIs disponíveis [API 
b. Geração do Access Token de Homologação (Sandbox): após criar a APP de Homologação, 
nome que você criou no passo anterior. Pronto, o seu Acess token será gerado e dentro 
de X dias você poderá visualizar o seu token de homologação no menu ‘minhas apps’, 
3. Visualizando o access token 
e. Solicitação do Access Token de Produção  
e. Geração do Access Token de Produção: Repita os mesmos passos já realizados para a 
geração de token de homologação, mas dessa vez ao abrir o chamado, preencha o campo 
Client ID ou Nome da APP com os dados da APP de produção. O seu token será 
da requisição no campo x-api-key o token de autenticação recebido. Esse token é 
token correspondente ao ambiente que está sendo utilizado.   
na configuração da integração da API, pois esse código gerado é utilizado no recurso de autenticação 
contratado e deseje utilizá-las, precisará gerar o token de autenticação para cada conta específica. 
23.1. Autenticação 
o token de autenticação recebida do Sicredi. Esse token é diferente para o ambiente de Sandbox e 
Produção, deve ser informado o token correspondente ao ambiente que está sendo utilizado. 
A operação POST “token” é responsável por criar uma chave criptografada, denominada 
“access_token”, utilizando o Beneficiário + Cooperativa como usuário (username) e o Código de Acesso 
(password) que foi gerada no Internet Banking. O padrão de autenticação é o OAuth2 e o token utiliza o 
do access_token e do refresh_token, observando os parâmetros “expires_in” (exemplo: 300 segundos) e 
 Para verificar se o acess_token está expirado, deve-se observar o campo “expires_in” que retorna 
a duração do token em segundos. 
O access_token deve ser enviado no cabeçalho das chamadas das próximas operações até que ele 
expire, não deve ser realizado autenticação a cada chamada. Quando o access_token expirar, deve ser 
utilizado o refresh_token para gerar um novo token.  
OBS: Quando da utilização do refresh_token, não será necessário informar os campos 
Quando o refresh_token estiver expirado, deverá ser realizado o fluxo de autenticação normal, com 
Access token 
refresh_token 
autenticação. 
Refresh token 
autenticação 
access_token  
Token de autenticação 
token_type  
Tipo do Token 
refresh_token 
um novo access_token, 
uma nova autenticação 
Token 
Token  
autenticação.  
https://api-parceiro.sicredi.com.br/auth/openapi/token 
    "access_token": 
Token in the 
    "refresh_token": 
    "token_type": "Bearer", 
Cenário Positivo – Gerando o access_token 
OBS: Sempre verificar o tempo de expiração do access_token, através do campo “expires_in” (Exemplo: 300 
segundos). Caso esteja expirado, deverá usar o refresh_token para gerar um novo token. 
Cenário Positivo  – Utilizando o refresh_token para gerar um novo token 
OBS: Sempre verificar o tempo de expiração do refresh_token, através do campo “refresh_expires_in” 
(Exemplo: 1800 segundos). Caso esteja expirado, deverá gerar um novo access_token. Quando da utilização 
do refresh_token, não será necessário informar os campos “username” e “password”. 
Access token 
Bearer + Token de 
Autenticação  
access_token 
autenticação.  
autenticação para 
token 
autenticação para 
token 
autenticação. 
autenticação. 
Token de acesso 
Bearer + Token de 
Autenticação  
Acess token obtido 
na autenticação   
token 
Access Token in the 
Access token 
Bearer + Token de 
Autenticação  
access_token 
autenticação.  
autenticação para 
token 
autenticação para 
token 
autenticação. 
autenticação.