Catalog

Includes sensitive operations

What it covers#

You can list your products and services, view their details, create new ones, edit or delete them, and get feeds for other channels. Deleting a product is sensitive: the WhatsApp Assistant asks for confirmation in chat and MCP clients must ask for human confirmation; no email code is required.

Tools#

List catalog of products or services

Read only

tilopay_catalog_list_items

Lists the products or services of the Tilopay catalog (title, price and short link). It can search by name or description (ignoring accents and case). The Tilopay listing may take a few minutes to reflect changes made in the dashboard; whatever is created from here appears immediately and the response of tilopay_catalog_create_item already includes the new item. Use refresh=true to force a fresh read.

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)
`search`	string	—	Text to search in the product name
`page`	integer	—	Page (1 by default)
`refresh`	boolean	—	true to ignore the short-term memory and read again
`include_qr`	boolean	—	Include each item's full base64 QR (false by default; the listing returns only the link and has_qr)

Returns

{ result }

Raw Tilopay API response under the `result` key.

Catalog item detail

Read only

tilopay_catalog_get_item

Gets the detail of a product or service of the Tilopay catalog by its ID. The base64 QR only with include_qr=true.

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
`include_qr`	boolean	—	Include the base64 QR (false by default; use it only if the merchant asks for the QR)

Returns

{ result }

Raw Tilopay API response under the `result` key.

Add a product or service to the catalog

Write

tilopay_catalog_create_item

Creates a product or service in the Tilopay catalog with its price and returns the short payment link and the QR as an image. If the merchant sent a photo on WhatsApp in the last 10 minutes, it uses it as the product image.

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	—	Product or service description
`media_ref`	string	—	Exact reference of the image received over WhatsApp, if known
`use_last_image`	boolean	—	false to create the product without a photo even if there is a recent image

Returns

{ result, linkId, url }

result = the raw API response; linkId = id of the payment link representing the product; url = the product's charge link.

Edit a catalog product

Write

tilopay_catalog_update_item

Edits a product of the Tilopay catalog (name, price, currency, description or photo) without changing its payment link.

Parameters

Parameter	Type	Required	Description
`itemId`	string	yes	Catalog item ID
`name`	string	—	New name (or the same one)
`amount`	number	—	New price (or the same one)
`currency`	string	—	Currency; if omitted, the merchant's country currency
`description`	string	—	New description (or the same one)
`media_ref`	string	—	Exact reference of the image received over WhatsApp, if known
`use_last_image`	boolean	—	false to keep the photo unchanged even if there is a recent image

Returns

{ item, short_link, changed }

item = the updated product; short_link = its payment link (unchanged); changed = the fields that changed. Changing the amount or the currency is owner-only.

Delete a catalog product

Sensitive

tilopay_catalog_delete_item

Deletes a product from the Tilopay catalog and disables its payment link. No email code is required. The WhatsApp Assistant asks for confirmation in chat; in MCP clients, human confirmation is the client's responsibility.

Requires confirmation: Confirmations Tilopay requires

API operation: POST /api/v1/deleteLinkPayment — see the operation page

Parameters

Parameter	Type	Required	Description
`itemId`	string	yes	Catalog item ID

Returns

{ result }

result = API response deleting the payment link representing the product.

Sync the catalog with social networks and search engines

Write

tilopay_catalog_feed

Delivers the synced catalog link and the steps to connect it in Facebook/Instagram, Google Shopping, TikTok or Pinterest (one channel at a time, the one the merchant asks for). With send_email=true it sends it to the merchant's email.

Parameters

Parameter	Type	Required	Description
`platform`	string (facebook \| google \| tiktok \| pinterest)	—	Requested channel. If the merchant did not say which, DO NOT call: ask first.
`send_email`	boolean	—	true if they asked to receive it by email

Returns

{ url, urls, omitted_without_photo, platform }

url = the requested channel's feed; urls = [{ currency, url }] per currency; omitted_without_photo = products omitted for having no photo.

Last verified: 2026-10-20

View as raw Markdown