Mercury - Obtener Tarjetas

Descripcion

Este modulo permite obtener la lista de tarjetas virtuales y fisicas de Mercury, con filtros por estado y cuenta. Incluye informacion de limites de gasto y estado de cada tarjeta.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercury
card_id	string	No	ID de tarjeta específica
account_id	string	No	Filtrar por cuenta
status	select	No	Filtrar por estado
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

Tarjeta específica

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

Lista de tarjetas

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

Estados

Estado	Descripción
active	Activa y lista para usar
inactive	Inactiva (no se puede usar)
frozen	Congelada temporalmente
closed	Cerrada permanentemente

Tipos de Tarjeta

• virtual: Tarjeta virtual (uso inmediato)
• physical: Tarjeta física (requiere envío)

Ejemplo de Uso

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

API Utilizada

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

Notas

• Las tarjetas virtuales se pueden crear y usar inmediatamente
• Cada tarjeta puede tener limites de gasto configurados
• Se pueden congelar/descongelar desde la API
• Ideal para separar gastos por departamento o proyecto

Nodos relacionados

• MercuryGetAccounts - Obtener cuentas asociadas a tarjetas
• MercuryGetTransactions - Ver transacciones de tarjetas
• MercuryGetBalance - Verificar fondos disponibles