Mercury - Crear Destinatario

Descripcion

Este modulo permite crear un nuevo destinatario (recipient) en Mercury para poder realizar transferencias ACH, Wire domestico o Wire internacional.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercury
name	string	Sí	Nombre del destinatario
email	string	No	Email del destinatario
payment_method	select	No	Método de pago (ach, domesticWire, etc.)
routing_number	string	No	Número de ruta (ACH/Wire doméstico)
account_number	string	No	Número de cuenta
account_type	select	No	Tipo de cuenta (checking/savings)
bank_name	string	No	Nombre del banco
swift_code	string	No	Código SWIFT (wire internacional)
iban	string	No	IBAN (wire internacional)
address1	string	No	Dirección del banco
city	string	No	Ciudad
region	string	No	Estado/Región
postal_code	string	No	Código postal
country	string	No	País (código ISO)

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,
  "recipient": { ... },
  "recipient_id": "rec_abc123",
  "name": "Proveedor XYZ",
  "payment_method": "ach",
  "message": "Destinatario Proveedor XYZ creado (rec_abc123)"
}

Ejemplos por Método de Pago

ACH (doméstico US)

payment_method: "ach"
routing_number: "021000021"
account_number: "123456789"
account_type: "checking"
bank_name: "Chase Bank"

Wire Internacional

payment_method: "internationalWire"
swift_code: "DEUTDEFF"
iban: "DE89370400440532013000"
bank_name: "Deutsche Bank"
country: "DE"

Ejemplo de Uso

{
  "credentials_id": "mercury_cuenta",
  "name": "Proveedor XYZ",
  "email": "pagos@proveedor.com",
  "payment_method": "ach",
  "routing_number": "021000021",
  "account_number": "123456789",
  "account_type": "checking",
  "bank_name": "Chase Bank"
}

API Utilizada

• API: Mercury API v1
• Endpoint: POST /api/v1/recipients
• Documentacion: https://docs.mercury.com/reference

Notas

• Los destinatarios deben configurarse antes de poder hacer transferencias
• Para wires internacionales, se requiere SWIFT y opcionalmente IBAN
• El email es opcional pero recomendado para notificaciones

Nodos relacionados

• MercuryCreateTransfer - Crear transferencias al destinatario
• MercuryGetRecipients - Listar destinatarios existentes
• MercuryGetAccounts - Obtener cuentas de origen