Mercury - Obtener Transferencias

Descripcion

Este modulo permite obtener las transferencias salientes de una cuenta Mercury, con filtros por estado, fecha y paginacion. Puede consultar una transferencia especifica o listar todas.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercury
account_id	string	Sí	ID de la cuenta
transfer_id	string	No	ID de transferencia específica
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

Transferencia específica

{
  "success": true,
  "transfer": { ... },
  "transfer_id": "txn_abc123",
  "status": "sent",
  "amount": 5000.00,
  "payment_method": "ach",
  "created_at": "2024-01-15T10:30:00Z",
  "message": "Transferencia txn_abc123 obtenida (sent)"
}

Lista de transferencias

{
  "success": true,
  "transfers": [ ... ],
  "total": 45,
  "account_id": "abc123",
  "message": "45 transferencias encontradas"
}

Estados

Estado	Descripción
pending	Pendiente de envío
sent	Enviada al banco
cancelled	Cancelada
failed	Fallida

Ejemplo de Uso

{
  "credentials_id": "mercury_cuenta",
  "account_id": "abc123",
  "status": "sent",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31"
}

API Utilizada

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

Notas

• Solo se muestran transferencias salientes (externalTransfer)
• Las transferencias ACH pueden tardar hasta 3 dias en reflejarse
• Los wires domesticos se procesan el mismo dia

Nodos relacionados

• MercuryCreateTransfer - Crear nuevas transferencias
• MercuryGetRecipients - Ver destinatarios de las transferencias
• MercuryGetAccounts - Obtener ID de cuenta para consultar
• MercuryGetTransactions - Ver todas las transacciones incluyendo transferencias