Stater Platform

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ório
    string
    application/json
  • Content-TypeObrigatório
    string
    application/json
  • AuthorizationObrigatório
    string
    Bearer <token> — JWT de /authenticate.
  • X-Tenant-IdObrigatório
    string (UUID)
    Identificador do tenant.

Body

  • currentPasswordObrigatório
    string
    Senha atual (a mesma usada em /authenticate).
  • newPasswordObrigatório
    string
    Nova 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

  • message
    string
    Mensagem de confirmação localizada.
json
{  "message": "Senha redefinida com sucesso."}
URL base:https://baas.staterpay.io

On this page