Stored cards and bulk collections

Destructive

What it covers#

Four read-only tools over collection groups, affiliates with a stored card and bulk collections, plus one sensitive tool that charges those cards. Creating charges moves real money: ask for human confirmation before running it.

These tools wrap the /api/v1/collect/** endpoints, which do not have a reference page in the API portal yet. That is why the rows below do not link to the matching operation.

Tools#

List collection groups

Read only

tilopay_saved_cards_list_groups

Lists the collection groups with stored cards (affiliates) in Tilopay.

API operation: POST /api/v1/collect/get/groups

Parameters

No parameters.

Returns

{ result }

Raw Tilopay API response under the `result` key.

List affiliates with a stored card

Read only

tilopay_saved_cards_list_affiliates

Lists the affiliates (customers with a stored card) of a collection group.

API operation: POST /api/v1/collect/get/affiliates

Parameters

Parameter	Type	Required	Description
`group`	integer	—	Group ID (0 for all)

Returns

{ result }

Raw Tilopay API response under the `result` key.

List bulk collections

Read only

tilopay_saved_cards_list_collections

Lists the bulk collections made with stored cards in Tilopay.

API operation: POST /api/v1/collect/get/massive

Parameters

No parameters.

Returns

{ result }

Raw Tilopay API response under the `result` key.

Bulk collection detail

Read only

tilopay_saved_cards_collection_detail

Returns the detail of a bulk collection. It requires the collection `code` (the `code` field returned by tilopay_saved_cards_list_collections).

API operation: POST /api/v1/collect/get/massive/detail

Parameters

Parameter	Type	Required	Description
`code`	string	yes	Bulk collection code (the `code` field of the collections list)

Returns

{ result }

Raw Tilopay API response under the `result` key.

Charge stored cards

Sensitive

tilopay_saved_cards_create_payments

Creates charges to affiliates and/or groups with stored cards in Tilopay. Sensitive operation: it moves real money.

API operation: POST /api/v1/collect/set/payments

Parameters

Parameter	Type	Required	Description
`reason`	string	yes	Reason for the charge, e.g. "Monthly fee"
`capture`	boolean	—	Capture immediately (true by default)
`users`	array<object>	—	Individual affiliates to charge. Each item: id (string, required), amount (number, required, greater than zero), currency (string, required), date (string "YYYY-MM-DD", empty = immediate)
`groups`	array<object>	—	Groups to charge. Each item: id (string, required), amount per affiliate (number, required, greater than zero), currency (string, required), date (string "YYYY-MM-DD", empty = immediate)

Returns

{ result }

Raw Tilopay API response under the `result` key.

Last verified: 2026-09-02 · Owner: equipo-integraciones

View as raw Markdown