Autenticação
A BSPAY autentica todas as rotas via OAuth2 Bearer (Authorization).
A BSPAY autentica todas as rotas via OAuth2 Bearer (Authorization).
Bearer Token (OAuth2 Client Credentials)
Quatro passos pra ficar autenticado:
- Crie uma credencial de API no Dashboard — você recebe
client_ideclient_secret - Aguarde a ativação pelo administrador da conta
- Gere um access token via
POST /v2/oauth/token - Envie o token no header
Authorization: Bearer {token}em cada requisição
Gerar token
POST /v2/oauth/token
Envie suas credenciais codificadas em Base64 no header Authorization e grant_type=client_credentials no body:
Após 5 tentativas erradas seguidas, o IP é bloqueado por 5 minutos (
IP_BLOCKED_TEMPORARILY). Rate limit do endpoint: 30 reqs/min/IP.
Usar o token
Inclua o token em todas as requisições:
Ciclo de vida
| Propriedade | Valor |
|---|---|
| Validade | 1 hora (3600 segundos) |
| Renovação | Gere um novo token com as mesmas credenciais |
| Múltiplos tokens | Cada chamada a /oauth/token gera um token independente |
| Revogação | Tokens expiram automaticamente — não há endpoint de revogação |
Nunca exponha credenciais no frontend. O client_secret e o access_token devem ser usados exclusivamente em chamadas servidor-a-servidor. Exposição no client-side compromete a segurança da sua conta.