Stater Platform

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ó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

  • passwordObrigatório
    string
    Senha 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

  • message
    string
    Mensagem de confirmação localizada.
json
{  "message": "Código de recuperação de PIN enviado com sucesso."}
URL base:https://baas.staterpay.io

On this page