Saltar al contenido principal

Manteca – Usuarios

Endpoints para la gestión de usuarios en Manteca, incluyendo creación de cuenta, consulta de perfil, balances, cuentas bancarias y KYC.

👤 Gestión de usuarios Manteca

Estos endpoints permiten integrar la información KYC del usuario de SwapBits con la plataforma Manteca para habilitar trading y operaciones fiat.

1️⃣ Crear usuario en Manteca​

POST/manteca/create

Crea una cuenta de usuario en Manteca usando los datos KYC del usuario

📤 Respuesta

{
"userId": "manteca_user_id_123",
"status": "ACTIVE",
"externalId": "swp_98808656",
"email": "user@example.com"
}

Condiciones importantes

  • Solo usuarios argentinos pueden crear cuenta en Manteca
  • Los datos KYC deben estar completos
  • Requiere autenticación JWT válida

2️⃣ Obtener usuario de Manteca​

GET/manteca/user

Obtiene los datos completos del usuario en Manteca

📤 Respuesta

{
"success": true,
"data": {
  "userId": "manteca_user_id_123",
  "name": "Juan Pérez",
  "email": "user@example.com",
  "country": "Argentina",
  "status": "ACTIVE",
  "exchangeCountry": "ARG",
  "creationTime": "2024-01-15T10:30:00Z",
  "balance": {
    "ARS": "15000.50",
    "USD": "100.25",
    "DAI": "0.00"
  },
  "lockedBalance": {
    "ARS": "0.00",
    "USD": "0.00"
  }
},
"message": "Usuario obtenido exitosamente de Manteca"
}

3️⃣ Obtener balance del usuario​

GET/manteca/balance

Obtiene el balance actual y fondos bloqueados del usuario

📤 Respuesta

{
"success": true,
"data": {
  "balance": {
    "ARS": "15000.50",
    "USD": "100.25",
    "DAI": "50.00",
    "USDT": "0.00"
  },
  "lockedBalance": {
    "ARS": "0.00",
    "USD": "10.00"
  },
  "totalBalance": {
    "ARS": "15000.50",
    "USD": "110.25"
  }
},
"message": "Balance obtenido exitosamente de Manteca"
}

💰 Información de balances

  • balance: fondos disponibles
  • lockedBalance: fondos retenidos por órdenes
  • totalBalance: suma de ambos

4️⃣ Recuperar cuentas bancarias​

POST/manteca/recover-bank-accounts

Recupera o crea cuentas bancarias faltantes del usuario en Manteca

📤 Respuesta

{
"success": true,
"data": {
  "message": "Proceso de recuperación completado",
  "existingAccounts": ["ARS"],
  "createdAccounts": [
    {
      "coin": "CLP",
      "success": true,
      "result": {
        "id": "clp_account_1",
        "cbu": "999999999999999",
        "description": "Santander Rio"
      }
    }
  ],
  "summary": {
    "totalRequired": 2,
    "alreadyExisting": 1,
    "successfullyCreated": 1,
    "failed": 0
  }
}
}

🏦 Cuentas bancarias

Este endpoint verifica qué cuentas fiat deberían existir según el perfil del usuario y crea automáticamente las faltantes.

5️⃣ Reintentar subida de KYC​

POST/manteca/retry-kyc-upload

Reintenta la subida de documentos KYC a Manteca

📋 Parámetros

forceReuploadboolean

Forzar reenvío de documentos aunque existan

📤 Respuesta

{
"success": true,
"data": {
  "uploaded": {
    "front": true,
    "back": true
  },
  "alreadyExisting": ["DNI_FRONT", "DNI_BACK"]
}
}

🪪 KYC en Manteca

  • Si los documentos ya existen en Manteca, no se reenvían
  • Puede forzarse el reenvío usando forceReupload=true
  • El estado puede ser pendiente o validado

⚠️ Errores comunes​

Errores frecuentes

  • 401 Unauthorized: JWT inválido o KYC inexistente
  • 401 (Nacionalidad): solo usuarios argentinos
  • 404 Not Found: usuario no existe en Manteca
  • 409 Conflict: usuario ya creado previamente

✅ Buenas prácticas​

Recomendaciones

  • Completar KYC antes de crear usuario
  • Consultar balance antes de operar
  • Usar recuperación de cuentas ante inconsistencias
  • Monitorear estado de documentos KYC

Enlaces relacionados​