Catálogo

Sólo lectura

Qué cubre#

Sólo lectura: lista los productos o servicios que el comercio ya tiene creados en enlaces de pago y devuelve el detalle de uno.

Herramientas#

Listar catálogo de productos o servicios

Sólo lectura

tilopay_catalog_list_items

Lista los productos o servicios del catálogo de enlaces de pago de Tilopay.

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)

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.

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

Devuelve

{ result }

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

Crear un producto o servicio del catálogo

Escritura

tilopay_catalog_create_item

Crea un producto o servicio en el catálogo de Tilopay (queda como un enlace de pago reutilizable con su precio y descripción).

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
`amount`	number	sí	Precio
`currency`	string	—	Moneda, ej. CRC o USD. Si se omite se usa la del país del comercio.
`description`	string	sí	Descripción del producto o servicio

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.

Cambiar un producto del catálogo

Sensible

tilopay_catalog_update_item

Cambia el nombre, el precio, la moneda o la descripción de un producto del catálogo. El API de Tilopay no permite editar en sitio: se crea el producto con los datos nuevos y se elimina el anterior, así que el enlace del producto viejo deja de funcionar. Confirme con el comercio antes de usarla.

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

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`item_id`	string	sí	ID del producto a cambiar
`name`	string	sí	Nombre nuevo (o el mismo)
`amount`	number	sí	Precio nuevo (o el mismo)
`currency`	string	—	Moneda; si se omite, la del país del comercio
`description`	string	sí	Descripción nueva (o la misma)

Devuelve

{ result, linkId, url, replaced }

El API no permite editar un enlace: la herramienta crea el producto nuevo y borra el anterior. replaced = id del producto que se reemplazó; linkId y url = los del producto nuevo.

Eliminar un producto del catálogo

Sensible

tilopay_catalog_delete_item

Elimina un producto o servicio del catálogo de Tilopay por su ID. Su enlace deja de funcionar. Confirme con el comercio antes de usarla.

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

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`item_id`	string	sí	ID del producto a eliminar

Devuelve

{ result }

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

Última verificación: 2026-08-29 · Responsable: equipo-integraciones

Ver como Markdown crudo