Saltar al contenido principal

Manteca - Fiat

Endpoints para gestión de depósitos y retiros fiat en Manteca.

1. Obtener Depósitos Fiat​

GET /manteca/fiat/deposits

Obtiene el historial de depósitos fiat del usuario.

Query Parameters:

  • page (number, opcional): Número de página (default: 1)
  • limit (number, opcional): Elementos por página (default: 10, max: 100)
  • startDate (string, opcional): Fecha de inicio (formato: YYYY-MM-DD)
  • endDate (string, opcional): Fecha de fin (formato: YYYY-MM-DD)

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de Solicitud:

GET /manteca/fiat/deposits?page=1&limit=10&startDate=2024-01-01&endDate=2024-01-31

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "totalCount": 25,
    "pageCount": 3,
    "pageSize": 10,
    "page": 1,
    "lastPage": 3,
    "data": [
      {
        "id": "deposit_123",
        "amount": "5000.00",
        "currency": "ARS",
        "status": "COMPLETED",
        "createdAt": "2024-01-15T10:30:00Z",
        "completedAt": "2024-01-15T11:00:00Z",
        "reference": "DEP20240115001"
      }
    ]
  },
  "message": "Depósitos fiat obtenidos exitosamente. Página 1 de 3"
}

2. Obtener Retiros Fiat​

GET /manteca/fiat/withdrawals

Obtiene el historial de retiros fiat del usuario.

Query Parameters:

  • page (number, opcional): Número de página (default: 1)
  • limit (number, opcional): Elementos por página (default: 10, max: 100)
  • startDate (string, opcional): Fecha de inicio (formato: YYYY-MM-DD)
  • endDate (string, opcional): Fecha de fin (formato: YYYY-MM-DD)

Headers:

Authorization: Bearer <JWT_TOKEN>

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "totalCount": 15,
    "pageCount": 2,
    "pageSize": 10,
    "page": 1,
    "lastPage": 2,
    "data": [
      {
        "id": "withdrawal_456",
        "amount": "2000.00",
        "currency": "ARS",
        "status": "PENDING",
        "cbu": "banco.galicia.ars",
        "createdAt": "2024-01-15T09:00:00Z",
        "reference": "WTH20240115001"
      }
    ]
  },
  "message": "Retiros fiat obtenidos exitosamente. Página 1 de 2"
}

3. Obtener Retiro Fiat Específico​

GET /manteca/fiat/withdraw/:withdrawalId

Obtiene los detalles de un retiro fiat específico.

Parámetros:

  • withdrawalId (string): ID del retiro

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de Solicitud:

GET /manteca/fiat/withdraw/456

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "id": "456",
    "amount": "2000.00",
    "currency": "ARS",
    "status": "PENDING",
    "cbu": "banco.galicia.ars",
    "userId": "manteca_user_id_123",
    "createdAt": "2024-01-15T09:00:00Z",
    "reference": "WTH20240115001",
    "estimatedCompletionTime": "2024-01-16T09:00:00Z"
  },
  "message": "Retiro fiat 456 obtenido exitosamente"
}

Respuesta de Error (404):

{
  "message": "Retiro fiat con ID 456 no encontrado",
  "error": "Not Found",
  "statusCode": 404
}

4. Crear Retiro Fiat​

POST /manteca/fiat/withdraw

Crea un nuevo retiro fiat.

Headers:

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

Body:

{
  "coin": "ARS",
  "cbu": "banco.galicia.ars",
  "amount": "5000"
}

Respuesta Exitosa (201):

{
  "success": true,
  "data": {
    "numberId": "789",
    "amount": "5000",
    "currency": "ARS",
    "status": "PENDING",
    "cbu": "banco.galicia.ars",
    "createdAt": "2024-01-15T10:30:00Z",
    "reference": "WTH20240115002",
    "estimatedCompletionTime": "2024-01-16T10:30:00Z"
  },
  "message": "Retiro fiat de 5000 ARS creado exitosamente. ID: 789"
}

Respuesta de Error (400):

{
  "message": "Todos los campos son requeridos: coin, cbu, amount",
  "error": "Bad Request",
  "statusCode": 400
}

💰 Estados de Transacciones​

Depósitos​

  • PENDING - Esperando confirmación
  • PROCESSING - En proceso de verificación
  • COMPLETED - Completado exitosamente
  • FAILED - Falló el procesamiento
  • CANCELLED - Cancelado por el usuario

Retiros​

  • PENDING - Esperando procesamiento
  • PROCESSING - En proceso de transferencia
  • COMPLETED - Transferido exitosamente
  • FAILED - Falló la transferencia
  • CANCELLED - Cancelado por el usuario o sistema

🏦 Cuentas Bancarias Soportadas​

Argentina (ARS)​

  • CBU válido de 22 dígitos
  • Bancos principales argentinos
  • Validación automática de CBU

Estados Unidos (USD)​

  • Account Number
  • Routing Number
  • Solo para usuarios verificados

📊 Paginación​

Parámetros​

  • page: Número de página (mínimo: 1)
  • limit: Elementos por página (mínimo: 1, máximo: 100)
  • startDate: Fecha inicio (formato: YYYY-MM-DD)
  • endDate: Fecha fin (formato: YYYY-MM-DD)

Ejemplo​

GET /manteca/fiat/deposits?page=2&limit=20&startDate=2024-01-01

🔍 Filtros de Fecha​

Formato​

  • startDate: YYYY-MM-DD (ej: 2024-01-01)
  • endDate: YYYY-MM-DD (ej: 2024-01-31)

Reglas​

  • Si solo se proporciona startDate, se obtienen todas las transacciones desde esa fecha
  • Si solo se proporciona endDate, se obtienen todas las transacciones hasta esa fecha
  • Ambas fechas son inclusivas

⚠️ Errores Comunes​

  • 400 Bad Request: Campos faltantes o formato de fecha inválido
  • 404 Not Found: Retiro no encontrado
  • 401 Unauthorized: Token JWT inválido
  • 403 Forbidden: Límites de retiro excedidos

📝 Notas Importantes​

  • Los depósitos se procesan automáticamente al detectar la transferencia
  • Los retiros requieren validación manual para montos grandes
  • Las referencias son únicas por transacción
  • Los tiempos estimados son aproximados y pueden variar
  • Solo se soportan ARS para depósitos/retiros fiat en Argentina