Confirmar Actualización de PIN

Confirma la actualización del PIN de seguridad usando un validationToken. Si el usuario tiene 2FA habilitado, requiere twoFactorCode.

---

POST/auth/pin/update

Confirma la actualización del PIN usando validationToken

📤 Respuesta

{
"code": 1017,
"message": "PIN updated successfully.",
"data": {
  "updatedAt": "2025-01-20T14:45:00.000Z"
}
}

---

Headers

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

---

Body

{
  "validationToken": "string",
  "newPin": "654321",
  "twoFactorCode": "123456"
}

Campos

Campo	Tipo	Requerido	Descripción
validationToken	string	Sí	Token de validación
newPin	string	Sí	Nuevo PIN de exactamente 6 dígitos numéricos
twoFactorCode	string	No	Código 2FA de 6 dígitos. Requerido si el usuario tiene 2FA habilitado

---

Response (200)

PIN actualizado

code 1017 — PIN updated successfully.

{
  "code": 1017,
  "message": "PIN updated successfully.",
  "data": {
    "updatedAt": "2025-01-20T14:45:00.000Z"
  }
}

---

Errores

Nuevo PIN inválido

HTTP 400 — code 4006.

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

Validation token inválido o expirado

HTTP 400 — code 4032.

{
  "code": 4032,
  "message": "Invalid or expired validation token"
}

PIN no configurado

HTTP 400 — code 4031.

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

2FA requerido

HTTP 400 — code 4034.

{
  "code": 4034,
  "message": "2FA code required for this user"
}

Formato de 2FA inválido

HTTP 400 — code 4003.

{
  "code": 4003,
  "message": "Invalid 2FA code format"
}

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' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -d '{
    "validationToken": "uuid-validation-token",
    "newPin": "654321",
    "twoFactorCode": "123456"
  }'

---

⚡ Quick Test

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

curl -X POST 'https://api.swapbits.co/auth/pin/update' \
  -H 'Content-Type: application/json' \
  -d '{
"validationToken": "uuid-validation-token",
"newPin": "654321",
"twoFactorCode": "123456"
}'