Solicitar código de PIN
POST /passwords/send-forgot-pin-code — etapa 1 do fluxo de alteração de PIN.
Solicitar código de recuperação de PIN
Etapa 1 do fluxo de alteração do PIN: envia um código numérico de verificação para o e-mail cadastrado da entidade autenticada. Exige a senha de login atual para autorizar o disparo.
POST/passwords/send-forgot-pin-code
Etapa 1 de 2. O código é enviado para entity.email (visto em /authenticate). Depois de recebê-lo, complete o fluxo com PUT /passwords/change-pin passando { code, pin }. O código tem validade curta — disparar de novo invalida o anterior. password incorreta retorna 4xx.
Headers
- AcceptObrigatóriostringapplication/json
- Content-TypeObrigatóriostringapplication/json
- AuthorizationObrigatóriostringBearer <token> — JWT de /authenticate.
- X-Tenant-IdObrigatóriostring (UUID)Identificador do tenant.
Body
- passwordObrigatóriostringSenha de login atual (a mesma usada em /authenticate).
Exemplo de requisição
bash
curl -X POST https://baas.staterpay.io/passwords/send-forgot-pin-code \ -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 '{ "password": "senhaAtual@123" }'Resposta
- messagestringMensagem de confirmação localizada.
json
{ "message": "Código de recuperação de PIN enviado com sucesso."}URL base:
https://baas.staterpay.io