2 - Gerando o token de acesso
username e password/KeyValue) que você obteve no Passo 1, agora vamos gerar um access_token. Pense neste token como uma chave de acesso temporária e segura. Em vez de enviar suas credenciais permanentes a cada chamada, você enviará este token para se autenticar nas APIs do Pinbank.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.
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 já 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
• password = Campo
• grant_type =
UserName recebido na credencial• password = Campo
KeyValue recebido na credencial• grant_type =
passwordGerar token OAuth2
Para gerar um token OAuth2, deve-se fazer uma request POST para a API de autenticação informando os parâmetros do item acima no formato x-www-form-urlencoded
• access_token = Token de autenticação para ser enviado no campo
• token_type =
• 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. O Quando o token expirar ou você receber uma mensagem de token inválido, basta realizar este mesmo processo do Passo 2 novamente para gerar um novo
Exemplo POSTMAN
Retornos
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.
Gerenciamento do ciclo de vida do token
access_token possui um tempo de validade definido em expires_in. Diferente de outros fluxos, não há um refresh_token.access_token. Por questões de segurança, o tempo de expiração pode mudar sem aviso prévio.Modificado em 2026-06-16 00:04:16