Autenticação

Toda chamada à API exige um token de acesso (JWT Bearer). A autenticação usa identidade centralizada (Keycloak): uma conta, um login, e os papéis decidem o que cada usuário vê.

Header de autenticação

Toda requisição autenticada

curl -s https://sandbox.api.ddpay.tech/api/v1/bank/wallet/... \
  -H "Authorization: Bearer <access_token>"

Se o token estiver ausente ou inválido, a API retorna HTTP 401 Unauthorized. Se o usuário não tiver o papel necessário para o recurso, retorna HTTP 403 Forbidden.

Ciclo de vida do token

Obtenha o token ao iniciar a sessão (endpoint de sessão).
Use-o em todas as chamadas até a expiração (por padrão, 1 hora).
Quando expirar, refaça o login e obtenha um novo token.