Mercury - Get Cards

Description

This module allows getting the list of virtual and physical Mercury cards, with filters by status and account. It includes spending limit and status information for each card.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercury credentials
card_id	string	No	Specific card ID
account_id	string	No	Filter by account
status	select	No	Filter by status
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 card

{
  "success": true,
  "card": { ... },
  "card_id": "card_abc123",
  "name": "Marketing Card",
  "type": "virtual",
  "status": "active",
  "last_four": "4242",
  "spending_limit": {
    "amount": 5000,
    "interval": "month"
  },
  "message": "Tarjeta Marketing Card (****4242) obtenida"
}

Card list

{
  "success": true,
  "cards": [ ... ],
  "total": 8,
  "message": "8 tarjetas encontradas"
}

Statuses

Status	Description
active	Active and ready to use
inactive	Inactive (cannot be used)
frozen	Temporarily frozen
closed	Permanently closed

Card Types

• virtual: Virtual card (immediate use)
• physical: Physical card (requires shipping)

Usage Example

{
  "credentials_id": "mercury_cuenta",
  "status": "active",
  "limit": 50
}

API Used

• API: Mercury API v1
• Endpoint: GET /api/v1/cards
• Documentation: https://docs.mercury.com/reference

Notes

• Virtual cards can be created and used immediately
• Each card can have configured spending limits
• Cards can be frozen/unfrozen from the API
• Ideal for separating expenses by department or project

Related Nodes

• MercuryGetAccounts - Get accounts associated with cards
• MercuryGetTransactions - View card transactions
• MercuryGetBalance - Check available funds