Tarjetas guardadas y cobros masivos

Irreversible

Qué 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.

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.

Herramientas#

Listar grupos de cobro

Sólo lectura

tilopay_saved_cards_list_groups

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

Operación del API: POST /api/v1/collect/get/groups

Parámetros

Sin parámetros.

Devuelve

{ result }

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

Listar afiliados con tarjeta almacenada

Sólo lectura

tilopay_saved_cards_list_affiliates

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

Operación del API: POST /api/v1/collect/get/affiliates

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

Sólo lectura

tilopay_saved_cards_list_collections

Lista los cobros masivos realizados con tarjetas almacenadas en Tilopay.

Operación del API: POST /api/v1/collect/get/massive

Parámetros

Sin parámetros.

Devuelve

{ result }

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

Detalle de un cobro masivo

Sólo lectura

tilopay_saved_cards_collection_detail

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

Operación del API: POST /api/v1/collect/get/massive/detail

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

Sensible

tilopay_saved_cards_create_payments

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

Operación del API: POST /api/v1/collect/set/payments

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`.

Última verificación: 2026-09-02 · Responsable: equipo-integraciones

Ver como Markdown crudo