Catálogo

Incluye operaciones sensibles

Qué cubre#

Podés listar tus productos y servicios, consultar su detalle, crear nuevos, editarlos o eliminarlos, y obtener feeds para otros canales. Eliminar un producto es una operación sensible: el Asistente de WhatsApp pide confirmación en el chat y los clientes MCP deben pedir confirmación humana; no exige código por correo.

Herramientas#

Listar catálogo de productos o servicios

Sólo lectura

tilopay_catalog_list_items

Lista los productos o servicios del catálogo de Tilopay (título, precio y enlace corto). Permite buscar por nombre o descripción (sin importar acentos ni mayúsculas). El listado de Tilopay puede tardar unos minutos en reflejar cambios hechos en el panel; lo creado desde aquí aparece de inmediato y la respuesta de tilopay_catalog_create_item ya trae el ítem nuevo. Usa refresh=true para forzar lectura fresca.

Operación del API: GET /api/v1/getLinkPaymentList/{api_key}/{limit} — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`limit`	integer	—	Máximo de ítems (por defecto 50)
`search`	string	—	Texto a buscar en el nombre del producto
`page`	integer	—	Página (por defecto 1)
`refresh`	boolean	—	true para ignorar la memoria corta y leer de nuevo
`include_qr`	boolean	—	Incluir el QR completo en base64 de cada ítem (por defecto false; el listado devuelve solo el enlace y has_qr)

Devuelve

{ result }

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

Detalle de un ítem del catálogo

Sólo lectura

tilopay_catalog_get_item

Obtiene el detalle de un producto o servicio del catálogo de Tilopay por su ID. El QR en base64 solo con include_qr=true.

Operación del API: GET /api/v1/getLinkPaymentById/{link_payment_id}/{api_key} — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`itemId`	string	sí	ID del ítem del catálogo
`include_qr`	boolean	—	Incluir el QR en base64 (por defecto false; úsalo solo si el comercio pide el QR)

Devuelve

{ result }

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

Agregar producto o servicio al catálogo

Escritura

tilopay_catalog_create_item

Crea un producto o servicio en el catálogo de Tilopay con su precio y devuelve el enlace corto de pago y el QR como imagen. Si el comercio envió una foto por WhatsApp en los últimos 10 minutos, la usa como imagen del producto (solo en el Asistente de WhatsApp).

Operación del API: POST /api/v1/createLinkPayment — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`name`	string	sí	Nombre del producto o servicio (título del enlace)
`amount`	number	sí	Precio
`currency`	string	—	Moneda, ej. CRC o USD (por defecto la del comercio)
`description`	string	—	Descripción corta
`media_ref`	string	—	Referencia exacta de la imagen recibida por WhatsApp, si la conoce
`use_last_image`	boolean	—	false para crear el producto sin foto aunque haya una imagen reciente

Devuelve

{ result, linkId, url }

result = respuesta del API tal cual; linkId = id del enlace de pago que representa el producto; url = enlace de cobro del producto.

Editar un producto del catálogo

Escritura

tilopay_catalog_update_item

Edita un producto del catálogo (nombre, precio, moneda, descripción o foto) sin cambiar su enlace de pago.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`itemId`	string	sí	ID del ítem del catálogo
`name`	string	—	Nuevo nombre
`amount`	number	—	Nuevo precio
`currency`	string	—	Nueva moneda
`description`	string	—	Nueva descripción corta
`media_ref`	string	—	Referencia exacta de la imagen recibida por WhatsApp, si la conoce
`use_last_image`	boolean	—	false para no cambiar la foto aunque haya una imagen reciente

Devuelve

{ item, short_link, changed }

item = el producto actualizado; short_link = su enlace de pago (no cambia); changed = los campos que cambiaron. Cambiar el monto o la moneda es sólo para el dueño del comercio.

Borrar un producto del catálogo

Sensible

tilopay_catalog_delete_item

Borra un producto del catálogo de Tilopay y su enlace de pago deja de funcionar. No exige código por correo. En el Asistente de WhatsApp pide confirmación en el chat; en clientes MCP la confirmación humana queda a cargo del cliente.

Exige confirmación: Confirmaciones que exige Tilopay

Operación del API: POST /api/v1/deleteLinkPayment — ver la página de la operación

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`itemId`	string	sí	ID del ítem del catálogo

Devuelve

{ result }

result = respuesta del API al borrar el enlace de pago que representa el producto.

Sincronizar catálogo con redes y buscadores

Escritura

tilopay_catalog_feed

Entrega el enlace del catálogo sincronizado y los pasos para conectarlo en Facebook/Instagram, Google Shopping, TikTok o Pinterest (un canal a la vez, el que pida el comercio). Con send_email=true lo manda al correo del comercio.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`platform`	string (facebook \| google \| tiktok \| pinterest)	—	Canal pedido. Si el comercio no dijo cuál, NO llames: pregúntale primero.
`send_email`	boolean	—	true si pidió que se lo mandes por correo

Devuelve

{ url, urls, omitted_without_photo, platform }

url = feed del canal pedido; urls = [{ currency, url }] por moneda; omitted_without_photo = productos omitidos por no tener foto.

Última verificación: 2026-10-20

Ver como Markdown crudo