Mercury - Obtener Transacciones

Descripcion

Este modulo permite obtener el historial de transacciones de una cuenta Mercury, con filtros por estado, fecha y paginacion. Incluye transferencias, pagos con tarjeta, comisiones e intereses.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercury
account_id	string	Sí	ID de la cuenta
status	select	No	Filtrar por estado
start_date	string	No	Fecha inicio (YYYY-MM-DD)
end_date	string	No	Fecha fin (YYYY-MM-DD)
limit	number	No	Límite de resultados (default: 50)
offset	number	No	Desplazamiento para paginación

Credenciales

Este modulo requiere credenciales de tipo Mercury con los siguientes campos:

Campo	Descripcion
api_key	API Key de Mercury (obtenida en Settings > API)

Salida

{
  "success": true,
  "transactions": [
    {
      "id": "txn_abc123",
      "amount": -1500.00,
      "status": "sent",
      "counterpartyName": "Proveedor XYZ",
      "kind": "externalTransfer",
      "createdAt": "2024-01-15T10:30:00Z",
      "postedAt": "2024-01-15T14:00:00Z"
    }
  ],
  "total": 150,
  "account_id": "abc123",
  "message": "50 transacciones encontradas"
}

Estados (status)

• pending: Transacción pendiente de procesamiento
• sent: Transferencia enviada
• cancelled: Transacción cancelada
• failed: Transacción fallida

Tipos de Transaccion (kind)

• externalTransfer: Transferencia externa (ACH/Wire)
• internalTransfer: Transferencia entre cuentas Mercury
• cardTransaction: Transaccion con tarjeta
• fee: Comision
• interest: Intereses ganados

Ejemplo de Uso

{
  "credentials_id": "mercury_cuenta",
  "account_id": "abc123",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "limit": 50
}

API Utilizada

• API: Mercury API v1
• Endpoint: GET /api/v1/account/{id}/transactions
• Documentacion: https://docs.mercury.com/reference

Notas

• Las transacciones se devuelven ordenadas por fecha
• Los montos negativos representan salidas de fondos
• Se puede filtrar por rango de fechas para reportes
• El campo kind indica el tipo de movimiento

Nodos relacionados

• MercuryGetAccounts - Obtener ID de cuenta para consultar
• MercuryGetTransfers - Ver solo transferencias salientes
• MercuryGetBalance - Verificar balance resultante