Alterar PIN
PUT /passwords/change-pin — etapa 2 do fluxo (consome o código enviado).
Alterar PIN
Etapa 2 do fluxo de alteração do PIN: troca o PIN da entidade autenticada usando o código enviado por e-mail em /passwords/send-forgot-pin-code.
PUT/passwords/change-pin
Etapa 2 de 2. Antes desta chamada, dispare POST /passwords/send-forgot-pin-code (com a senha atual) para receber o code por e-mail. Código expirado ou já consumido retorna 4xx — peça um novo. Após sucesso, entity.hasPin (em /authenticate) passa a true se ainda não estava.
Headers
- AcceptObrigatóriostringapplication/json
- Content-TypeObrigatóriostringapplication/json
- AuthorizationObrigatóriostringBearer <token> — JWT de /authenticate.
- X-Tenant-IdObrigatóriostring (UUID)Identificador do tenant.
Body
- codeObrigatóriostringCódigo numérico recebido por e-mail (6 dígitos).
- pinObrigatóriostringNovo PIN (geralmente 4 dígitos numéricos — pode variar conforme política do tenant).
Exemplo de requisição
bash
curl -X PUT https://baas.staterpay.io/passwords/change-pin \ -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 '{ "code": "123456", "pin": "1234" }'Resposta
- messagestringMensagem de confirmação localizada.
json
{ "message": "PIN redefinido com sucesso."}URL base:
https://baas.staterpay.io