# Tarjetas guardadas y cobros masivos

> Herramientas del MCP para grupos y afiliados con tarjeta almacenada, cobros masivos y su detalle.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-09-02
- url: https://www.tilopay.com/developers/agentes/mcp/tarjetas-guardadas

## Qué cubre [#que-cubre]

Cuatro herramientas de lectura sobre grupos de cobro, afiliados con tarjeta almacenada y cobros masivos, y una sensible que crea cobros a esas tarjetas. La creación de cobros mueve dinero real: pedí confirmación humana antes de ejecutarla.

<Callout type="warn">
Estas herramientas envuelven los endpoints `/api/v1/collect/**`, que todavía no tienen página de referencia en el portal del API. Por eso las filas de abajo no enlazan a la operación correspondiente.
</Callout>

## Herramientas [#herramientas]

### Listar grupos de cobro [#tilopay-saved-cards-list-groups]

- `tilopay_saved_cards_list_groups`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/collect/get/groups`

Lista los grupos de cobro con tarjetas almacenadas (afiliados) en Tilopay.

**Parámetros**

Sin parámetros.

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Listar afiliados con tarjeta almacenada [#tilopay-saved-cards-list-affiliates]

- `tilopay_saved_cards_list_affiliates`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/collect/get/affiliates`

Lista los afiliados (clientes con tarjeta almacenada) de un grupo de cobro.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `group` | integer | — | ID del grupo (0 para todos) |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Listar cobros masivos [#tilopay-saved-cards-list-collections]

- `tilopay_saved_cards_list_collections`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/collect/get/massive`

Lista los cobros masivos realizados con tarjetas almacenadas en Tilopay.

**Parámetros**

Sin parámetros.

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Detalle de un cobro masivo [#tilopay-saved-cards-collection-detail]

- `tilopay_saved_cards_collection_detail`
- Acceso: Sólo lectura
- Operación del API: `POST /api/v1/collect/get/massive/detail`

Obtiene el detalle de un cobro masivo. Requiere el `code` del cobro (campo `code` devuelto por tilopay_saved_cards_list_collections).

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `code` | string | sí | Código del cobro masivo (campo `code` de la lista de cobros) |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.

### Cobrar a tarjetas almacenadas [#tilopay-saved-cards-create-payments]

- `tilopay_saved_cards_create_payments`
- Acceso: Sensible
- Operación del API: `POST /api/v1/collect/set/payments`

Crea cobros a afiliados y/o grupos con tarjetas almacenadas en Tilopay. Operación sensible: afecta dinero real.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `reason` | string | sí | Motivo del cobro, ej. "Cobro mensualidad" |
| `capture` | boolean | — | Capturar de inmediato (por defecto true) |
| `users` | array<object> | — | Afiliados individuales a cobrar. Cada elemento: id (string, requerido), amount (number, requerido, mayor que cero), currency (string, requerido), date (string "YYYY-MM-DD", vacío = inmediato) |
| `groups` | array<object> | — | Grupos a cobrar. Cada elemento: id (string, requerido), amount por afiliado (number, requerido, mayor que cero), currency (string, requerido), date (string "YYYY-MM-DD", vacío = inmediato) |

**Devuelve**

`{ result }`

Respuesta cruda del API de Tilopay bajo la llave `result`.