Saltar al contenido principal

Manteca - Usuarios

Endpoints para la gestión de usuarios en Manteca.

1. Crear Usuario en Manteca​

POST /manteca/create

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

Headers:

Authorization: Bearer <JWT_TOKEN>
Content-Type: application/json

Respuesta Exitosa (200):

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

Respuesta de Error (401):

{
  "message": "Datos KYC no encontrados",
  "error": "Unauthorized",
  "statusCode": 401
}

Respuesta de Error (401 - Nacionalidad):

{
  "message": "Solo usuarios argentinos pueden crear cuenta en Manteca",
  "error": "Unauthorized", 
  "statusCode": 401
}

2. Obtener Usuario de Manteca​

GET /manteca/user

Obtiene los datos del usuario en Manteca.

Headers:

Authorization: Bearer <JWT_TOKEN>

Respuesta Exitosa (200):

{
  "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"
    },
    "addresses": {
      "BTC": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "ETH": "0x742d35Cc6634C0532925a3b8D4C1dE35000c2345"
    },
    "flags": {
      "isBanned": false,
      "overdrawn": false,
      "isDeleted": false,
      "phoneConfirmed": true
    },
    "bankAccounts": {
      "ARS": [
        {
          "id": "ars_account_1",
          "cbu": "999999999999999",
          "description": "Santander Rio"
        }
      ],
      "USD": []
    }
  },
  "message": "Usuario obtenido exitosamente de Manteca"
}

Respuesta de Error (404):

{
  "message": "Usuario no encontrado en Manteca",
  "error": "Not Found",
  "statusCode": 404
}

3. Obtener Balance del Usuario​

GET /manteca/balance

Obtiene el balance actual del usuario en Manteca.

Headers:

Authorization: Bearer <JWT_TOKEN>

Respuesta Exitosa (200):

{
  "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"
}

4. Recuperar Cuentas Bancarias​

POST /manteca/recover-bank-accounts

Recupera las cuentas bancarias faltantes del usuario en Manteca.

Headers:

Authorization: Bearer <JWT_TOKEN>

Respuesta Exitosa (200):

{
  "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"
        }
      }
    ],
    "errors": [],
    "summary": {
      "totalRequired": 2,
      "alreadyExisting": 1,
      "successfullyCreated": 1,
      "failed": 0
    }
  },
  "message": "Proceso de recuperación de cuentas bancarias completado"
}

5. Reintentar Subida de KYC​

POST /manteca/retry-kyc-upload

Reintenta la subida de documentos KYC a Manteca.

Headers:

Authorization: Bearer <JWT_TOKEN>
Content-Type: application/json

Body (opcional):

{
  "forceReupload": false
}

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "success": true,
    "message": "Los documentos KYC ya están en Manteca (pendientes o validados)",
    "uploaded": {
      "front": true,
      "back": true
    },
    "alreadyExisting": ["DNI_FRONT", "DNI_BACK"],
    "details": "Los documentos no necesitan ser resubidos ya que están en estado pendiente o validado en Manteca"
  },
  "message": "Los documentos KYC ya están en Manteca (pendientes o validados)"
}

⚠️ Errores Comunes​

  • 401 Unauthorized: Token JWT inválido o usuario sin permisos
  • 404 Not Found: Usuario no encontrado en Manteca
  • 409 Conflict: Usuario ya existe en Manteca

📝 Notas​

  • Solo usuarios argentinos pueden crear cuenta en Manteca
  • Los datos KYC deben estar completos antes de crear la cuenta
  • El balance incluye tanto fondos disponibles como bloqueados