Mercury - Crear Transferencia

Descripcion

Este modulo permite crear una transferencia bancaria desde una cuenta Mercury. Soporta transferencias ACH (gratuitas), Wire domestico y Wire internacional.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercury
account_id	string	Sí	ID de cuenta origen
recipient_id	string	Sí	ID del destinatario
amount	number	Sí	Monto en USD
payment_method	select	No	Método: ach, domesticWire, internationalWire
note	string	No	Nota interna
external_memo	string	No	Memo visible para el destinatario
send_date	string	No	Fecha programada (YYYY-MM-DD)
idempotency_key	string	No	Clave única para evitar duplicados

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,
  "transfer": { ... },
  "transfer_id": "txn_abc123",
  "status": "pending",
  "amount": 5000.00,
  "payment_method": "ach",
  "recipient_id": "rec_xyz789",
  "estimated_delivery_date": "2024-01-18",
  "message": "Transferencia txn_abc123 creada por $5000 (pending)"
}

Tiempos de Entrega

Método	Tiempo Estimado
ACH	1-3 días hábiles
Wire doméstico	Mismo día (antes de 5pm ET)
Wire internacional	2-5 días hábiles

Comisiones

Método	Costo
ACH	Gratis
Wire doméstico	~$5-15
Wire internacional	~$20-40

Ejemplo de Uso

{
  "credentials_id": "mercury_cuenta",
  "account_id": "abc123",
  "recipient_id": "rec_xyz789",
  "amount": 5000.00,
  "payment_method": "ach",
  "note": "Pago factura #1234",
  "external_memo": "Factura 1234 - Enero 2024"
}

API Utilizada

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

Notas

• El destinatario debe existir previamente (usar mercuryCreateRecipient)
• La clave de idempotencia evita transferencias duplicadas
• Las transferencias programadas se procesan a las 9am ET
• Los wires domesticos enviados despues de las 5pm ET se procesan al dia siguiente

Nodos relacionados

• MercuryCreateRecipient - Crear el destinatario de la transferencia
• MercuryGetTransfers - Consultar estado de transferencias
• MercuryGetBalance - Verificar fondos antes de transferir
• MercuryGetAccounts - Obtener ID de la cuenta origen