Mercury - Obtener Balance

Descripcion

Este modulo permite obtener el balance actual y disponible de las cuentas Mercury. Puede consultar una cuenta especifica o el balance consolidado de todas las cuentas.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercury
account_id	string	No	ID de cuenta específica (vacío = todas)

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

Balance de cuenta específica

{
  "success": true,
  "account_id": "abc123",
  "name": "Operating Account",
  "type": "checking",
  "current_balance": 125000.00,
  "available_balance": 123500.00,
  "currency": "USD",
  "message": "Operating Account: $123500 disponible"
}

Balance de todas las cuentas

{
  "success": true,
  "balances": [
    {
      "account_id": "abc123",
      "name": "Operating Account",
      "type": "checking",
      "current_balance": 125000.00,
      "available_balance": 123500.00
    },
    {
      "account_id": "def456",
      "name": "Savings",
      "type": "savings",
      "current_balance": 50000.00,
      "available_balance": 50000.00
    }
  ],
  "total_current_balance": 175000.00,
  "total_available_balance": 173500.00,
  "currency": "USD",
  "accounts_count": 2,
  "message": "Balance total: $173500 disponible en 2 cuentas"
}

Diferencia entre Balances

• current_balance: Saldo contable total
• available_balance: Saldo disponible para usar (puede ser menor por transferencias pendientes o retenciones)

Ejemplo de Uso

{
  "credentials_id": "mercury_cuenta",
  "account_id": ""
}

API Utilizada

• API: Mercury API v1
• Endpoint: GET /api/v1/accounts
• Documentacion: https://docs.mercury.com/reference

Casos de Uso

1. Monitoreo de liquidez: Verificar fondos disponibles antes de pagos
2. Alertas de balance bajo: Notificar cuando el balance cae bajo un umbral
3. Reportes financieros: Consolidar balances de multiples cuentas
4. Automatizacion de tesoreria: Transferir fondos entre cuentas segun reglas

Notas

• El current_balance es el saldo contable total
• El available_balance puede ser menor por transferencias pendientes
• Si no se indica account_id, se devuelve el balance de todas las cuentas

Nodos relacionados

• MercuryGetAccounts - Obtener detalles completos de las cuentas
• MercuryCreateTransfer - Crear transferencias verificando fondos
• MercuryGetTransactions - Ver movimientos que afectan el balance