Alterar senha
PUT /passwords/change-password — troca a senha da entidade autenticada.
Alterar senha
Altera a senha da entidade autenticada (PF ou PJ). Exige a senha atual para validação. Aplica-se ao login do dono do JWT — não troca PIN nem credenciais de outros usuários.
PUT/passwords/change-password
Após alterar a senha, tokens JWT já emitidos continuam válidos até expirarem (TTL de 1h). Para invalidar imediatamente uma sessão antiga, peça o logout pelo cliente. currentPassword incorreta retorna 4xx — não há rate-limit documentado, mas evite testes em loop pra não disparar bloqueios do tenant.
Headers
- AcceptObrigatóriostringapplication/json
- Content-TypeObrigatóriostringapplication/json
- AuthorizationObrigatóriostringBearer <token> — JWT de /authenticate.
- X-Tenant-IdObrigatóriostring (UUID)Identificador do tenant.
Body
- currentPasswordObrigatóriostringSenha atual (a mesma usada em /authenticate).
- newPasswordObrigatóriostringNova senha. Deve seguir a política do tenant (mínimo de caracteres, símbolos, etc.).
Exemplo de requisição
bash
curl -X PUT https://baas.staterpay.io/passwords/change-password \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.<payload>.<signature>" \ -H "X-Tenant-Id: 00000000-0000-0000-0000-000000000000" \ -d '{ "currentPassword": "senhaAtual@123", "newPassword": "novaSenhaForte@2026" }'Resposta
- messagestringMensagem de confirmação localizada.
json
{ "message": "Senha redefinida com sucesso."}URL base:
https://baas.staterpay.io