Catalog
Read onlyWhat it covers#
Read only: it lists the products or services the merchant already created as payment links and returns the detail of one.
Tools#
List catalog of products or services
Read onlytilopay_catalog_list_items
Lists the products or services in the payment links catalog.
API operation: GET /api/v1/getLinkPaymentList/{api_key}/{limit} — see the operation page
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | — | Maximum items (50 by default, 500 maximum) |
Returns
{ result }
Raw Tilopay API response under the `result` key.
Catalog item detail
Read onlytilopay_catalog_get_item
Returns the detail of a catalog product or service by its ID.
API operation: GET /api/v1/getLinkPaymentById/{link_payment_id}/{api_key} — see the operation page
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
itemId | string | yes | Catalog item ID |
Returns
{ result }
Raw Tilopay API response under the `result` key.
Create a catalog product or service
Writetilopay_catalog_create_item
Creates a product or service in the Tilopay catalog (it becomes a reusable payment link with its price and description).
API operation: POST /api/v1/createLinkPayment — see the operation page
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Product or service name |
amount | number | yes | Price |
currency | string | — | Currency, e.g. CRC or USD. If omitted, the merchant's country currency is used. |
description | string | yes | Product or service description |
Returns
{ result, linkId, url }
result = the raw API response; linkId = id of the payment link representing the product; url = the product's charge link.
Change a catalog product
Sensitivetilopay_catalog_update_item
Changes the name, price, currency or description of a catalog product. The Tilopay API does not allow in-place editing: the product is created with the new data and the old one is deleted, so the old product's link stops working. Confirm with the merchant before using it.
API operation: POST /api/v1/createLinkPayment — see the operation page
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
item_id | string | yes | ID of the product to change |
name | string | yes | New name (or the same one) |
amount | number | yes | New price (or the same one) |
currency | string | — | Currency; if omitted, the merchant's country currency |
description | string | yes | New description (or the same one) |
Returns
{ result, linkId, url, replaced }
The API does not allow editing a link: the tool creates the new product and deletes the previous one. replaced = id of the product that was replaced; linkId and url = those of the new product.
Delete a catalog product
Sensitivetilopay_catalog_delete_item
Deletes a product or service from the catalog by its ID. Its link stops working. Confirm with the merchant before using it.
API operation: POST /api/v1/deleteLinkPayment — see the operation page
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
item_id | string | yes | ID of the product to delete |
Returns
{ result }
result = API response deleting the payment link representing the product.
Last verified: 2026-08-29 · Owner: equipo-integraciones