Mercury - Get Transfers

Description

This module allows getting the outgoing transfers from a Mercury account, with filters by status, date, and pagination. It can query a specific transfer or list all.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercury credentials
account_id	string	Yes	Account ID
transfer_id	string	No	Specific transfer ID
status	select	No	Filter by status
start_date	string	No	Start date (YYYY-MM-DD)
end_date	string	No	End date (YYYY-MM-DD)
limit	number	No	Results limit (default: 50)
offset	number	No	Offset for pagination

Credentials

This module requires Mercury type credentials with the following fields:

Field	Description
api_key	Mercury API Key (obtained in Settings > API)

Output

Specific transfer

{
  "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)"
}

Transfer list

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

Statuses

Status	Description
pending	Pending to send
sent	Sent to bank
cancelled	Canceled
failed	Failed

Usage Example

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

API Used

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

Notes

• Only outgoing transfers (externalTransfer) are shown
• ACH transfers may take up to 3 days to be reflected
• Domestic wires are processed the same day

Related Nodes

• MercuryCreateTransfer - Create new transfers
• MercuryGetRecipients - View transfer recipients
• MercuryGetAccounts - Get account ID to query
• MercuryGetTransactions - View all transactions including transfers