2.1 - Token OAuth2

 As APIs são protegidas utilizando o protocolo OAuth2. Para chamar as APIs, você deve enviar um token OAuth2 válido com os níveis de autorização necessários.

2.2 - Parâmetros para geração do token OAuth2

 Para gerar um token OAuth2, é necessário possuir uma credencial ativa, que pode ser obtida após o preenchimento do "formulário de acesso". Caso ja tenha preenchido o formulário com sucesso, você pode consultar sua credencial no menu "Login".

  Os parâmetros utilizados para gerar um token OAuth2 são:

 • username = Campo UserName recebido na credencial
 • password = Campo KeyValue recebido na credencial
 • grant_type = "password"

2.3 - Gerar token OAuth2

 Para gerar um token OAuth2, deve-se fazer uma request GET para o endpoint https://dev.pinbank.com.br/services/api/token informando os parâmetros do item 2 acima no formato x-www-form-urlencoded

Exemplo POSTMAN

Retornos

 • access_token = Token de autenticação para ser enviado no campo Authorization do header de cada request.
 • token_type = "bearer"
 • expires_in = Tempo de expiração do token em segundos. Enquanto o token estiver válido, ele poderá ser utilizado para chamar quantas requests forem necessárias. Por questões de segurança, este tempo pode mudar sem aviso prévio, portanto, recomenda-se a geração de um novo token ao receber mensagem de token inválido.