Solicitar Actualización de PIN

Verifica el PIN actual y genera un validationToken para confirmar la actualización del PIN.

---

POST/auth/pin/update/request

Inicia el proceso de actualización del PIN

📤 Respuesta

{
"code": 1010,
"message": "PIN update request processed. Use the validation token to confirm.",
"data": {
  "validationToken": "uuid-validation-token",
  "requires2FA": false,
  "message": "PIN update request processed. Use the validation token to confirm."
}
}

---

Headers

Header	Value
Authorization	Bearer <JWT>
Content-Type	application/json

---

Body

{
  "currentPin": "123456"
}

Campos

Campo	Tipo	Requerido	Descripción
currentPin	string	Sí	PIN actual de exactamente 6 dígitos numéricos

---

Response (200)

Solicitud procesada

code 1010 — Se devuelve un validationToken para usar en /auth/pin/update.

data

Campo	Tipo	Descripción
validationToken	string	Token de validación
requires2FA	boolean	Indica si se requiere twoFactorCode en el siguiente paso
message	string	Mensaje descriptivo del estado

Ejemplo (sin 2FA)

{
  "code": 1010,
  "message": "PIN update request processed. Use the validation token to confirm.",
  "data": {
    "validationToken": "uuid-validation-token",
    "requires2FA": false,
    "message": "PIN update request processed. Use the validation token to confirm."
  }
}

Ejemplo (con 2FA habilitado)

{
  "code": 1010,
  "message": "PIN update request processed. 2FA code required for confirmation.",
  "data": {
    "validationToken": "uuid-validation-token",
    "requires2FA": true,
    "message": "PIN update request processed. 2FA code required for confirmation."
  }
}

---

Errores

PIN actual inválido

HTTP 400 — code 4006.

{
  "code": 4006,
  "message": "Current PIN must be exactly 6 digits"
}

PIN no configurado

HTTP 400 — code 4031.

{
  "code": 4031,
  "message": "PIN not configured. Please configure PIN first."
}

PIN actual incorrecto

HTTP 400 — code 4007.

{
  "code": 4007,
  "message": "Current PIN is incorrect"
}

No autorizado

HTTP 401 — Token JWT inválido, expirado o ausente.

{
  "statusCode": 401,
  "message": "Unauthorized"
}

Error interno

HTTP 500 — code 5001.

{
  "code": 5001,
  "message": "Failed to save user to the database.",
  "details": "..."
}

---

Ejemplo (cURL)

curl -X POST 'https://api.swapbits.co/auth/pin/update/request' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -d '{
    "currentPin": "123456"
  }'

---

⚡ Quick Test

POSThttps://api.swapbits.co/auth/pin/update/request

curl -X POST 'https://api.swapbits.co/auth/pin/update/request' \
  -H 'Content-Type: application/json' \
  -d '{
"currentPin": "123456"
}'