Autenticação
A API de autenticação do BS2 é baseada no protocolo basic auth, e as demais APIs do PIX são baseadas no protocolo Bearer authentication.
Para iniciar, vá em Primeiros Passos e cadastre as APIs do PIX que você deseja utilizar.
Gerar chave de acesso às APIs
Para realizar requisições nas APIs PIX Direto, é necessário gerar uma chave de acesso (access_token) por meio de uma requisição no endpoint de geração de token Gerando Access Tokens.
A validade da chave de acesso é obtida no objeto expires_in, em segundos.
É necessário que o parceiro realize a gestão da chave de acesso para garantir que todas as requisições nas APIs PIX Direto serão realizadas utilizando uma chave válida.
Importante:
Quando um novo access_token é gerado, caso haja uma chave existente, esta será automaticamente invalidada.
Gerar token
- Com a API Key, API Secret e Scope prepare uma requisição HTTP do tipo POST para o endpoint Gerando Access Tokens;
- Utilize no header Authorization o tipo
Basic Auth
e insira suas credenciais em base64; - No Body, utilize o parâmetro
scope
com valor igual ao scope obtido junto às credenciais; - No Body, utilize o parâmetro
grant_type
com valor igual aclient_credentials
; - Realize a requisição e obtenha o access_token.
Nota:
O access_token obtido na geração do token deverá ser utilizado nas demais requisições das APIs PIX Direto.
Updated about 1 month ago