Saltar al contenido principal

Manteca - Fiat

Endpoints para gestión de depósitos y retiros fiat en Manteca. Incluye listados con paginación, filtros por fecha y creación/consulta de retiros.

🏦 Gestión Fiat (Depósitos y Retiros)

Estos endpoints permiten consultar depósitos/retiros fiat, obtener el detalle de un retiro específico y crear nuevos retiros. Incluyen paginación y filtros de fecha. Requieren autenticación vía JWT.

1) Obtener Depósitos Fiat​

GET/manteca/fiat/deposits

Obtiene el historial de depósitos fiat del usuario

📋 Parámetros

pagenumber

Número de página

limitnumber

Elementos por página (default: 10, max: 100)

startDatestring

Fecha de inicio (YYYY-MM-DD)

endDatestring

Fecha de fin (YYYY-MM-DD)

📤 Respuesta

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

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de solicitud:

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

2) Obtener Retiros Fiat​

GET/manteca/fiat/withdrawals

Obtiene el historial de retiros fiat del usuario

📋 Parámetros

pagenumber

Número de página

limitnumber

Elementos por página (default: 10, max: 100)

startDatestring

Fecha de inicio (YYYY-MM-DD)

endDatestring

Fecha de fin (YYYY-MM-DD)

📤 Respuesta

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

Headers:

Authorization: Bearer <JWT_TOKEN>

3) Obtener Retiro Fiat Específico​

GET/manteca/fiat/withdraw/:withdrawalId

Obtiene los detalles de un retiro fiat específico

📋 Parámetros

withdrawalIdstringrequerido

ID del retiro

📤 Respuesta

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

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de solicitud:

GET /manteca/fiat/withdraw/456

Retiro no encontrado (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

📋 Parámetros

coinstringrequerido

Moneda fiat (ej: ARS, USD)

cbustringrequerido

Destino bancario (CBU/alias o esquema equivalente según país)

amountstringrequerido

Monto a retirar

📤 Respuesta

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

Headers:

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

Body:

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

Campos requeridos (400)

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

💰 Estados de Transacciones​

Estados de Depósitos

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

Estados de 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 de paginación

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

Ejemplo:

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

🔍 Filtros de Fecha​

Formato y reglas

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​

Errores típicos

  • 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​

Consideraciones

  • 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