Configurar PIN de Seguridad

Configura o actualiza el PIN de seguridad de 6 dígitos del usuario autenticado.

---

POST/auth/pin/configure

Configura o actualiza el PIN de seguridad

📤 Respuesta

{
"code": 1015,
"message": "PIN configured successfully.",
"data": {
  "pinActive": true,
  "configuredAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:30:00.000Z",
  "message": "PIN configured successfully. Token now includes pat claim for authentication."
}
}

---

Headers

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

---

Body

{
  "pin": "123456"
}

Campos

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

---

Response (200)

PIN configurado

code 1015 — PIN configured successfully.

data

Campo	Tipo	Descripción
pinActive	boolean	Siempre true en una configuración exitosa
configuredAt	string	Timestamp ISO 8601 (fecha de creación)
updatedAt	string	Timestamp ISO 8601 (fecha de actualización)
message	string	Mensaje adicional incluido dentro de data

---

Errores

PIN inválido

HTTP 400 — code 4006.

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

Usuario no encontrado

HTTP 404 — code 4001.

{
  "code": 4001,
  "message": "User not found."
}

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/configure' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -d '{
    "pin": "123456"
  }'

---

⚡ Quick Test

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

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