Micro-store and orders
DestructiveWhat it covers#
From the products in the catalog the agent builds a micro-store with a cart: a public page with several products where the customer picks quantities and pays for everything at once. Each micro-store has its own link.
The second half of the group is order management: it is set up once (store name, optional logo and the time of the daily reminder), and from then on the merchant can see the summary, list orders by status, see the ones paid but not delivered and mark them as delivered.
Order statuses are pending (awaiting payment), paid (paid, not delivered) and delivered.
Deactivating a micro-store or turning off order management does not delete catalog products or
orders already recorded.
These tools do not call the Tilopay API: they work on the MCP server's own data, except the payment itself, which goes through each product's payment link.
Tools#
Create a micro-store with cart
Writetilopay_store_create
Creates a micro-store link to share with a customer: it shows the catalog products, the customer builds a cart and pays at the end from the same page with a link that includes the cart detail. By default it includes the whole catalog; it can be limited to certain product IDs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | — | Visible store title |
item_ids | array<string> | — | Catalog product IDs to show; if omitted, the whole catalog is shown |
Returns
{ slug, url, items }
slug = the micro-store identifier; url = public store link with cart; items = how many catalog products were included.
List active micro-stores
Read onlytilopay_store_list
Lists the merchant's active micro-stores with their sharing link.
Parameters
No parameters.
Returns
{ stores[] }
stores = active micro-stores with slug, title, public link and the product ids each one includes.
Disable a micro-store
Sensitivetilopay_store_delete
Disables a micro-store by its slug: the link stops opening. Confirm with the merchant before using it.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Store slug (the end of its link) |
Returns
{ slug, active }
Disables the micro-store: the link stops showing products. active is set to false; the catalog products are not deleted.
Turn on or configure order management
Writetilopay_orders_setup
Turns on order tracking for the micro-store and saves the store name, the logo and the time of the daily reminder for paid, undelivered orders. It is also used to change any of that data later. The logo can be an https link to an image or the image the merchant just sent over WhatsApp (pass the reference shown in the message).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
store_name | string | — | Visible store name |
logo | string | — | https link of the logo image, or the reference of the image sent over WhatsApp |
reminder_time | string | — | Local time of the daily reminder in HH:mm format (e.g. "18:00"); empty disables it |
Returns
{ orders_enabled, store_name, has_logo, reminder_time }
Leaves order management on and returns the resulting configuration: the store name customers see, whether a logo is loaded and the time of the daily pending-orders reminder.
View store and order settings
Read onlytilopay_orders_settings
Shows whether order management is on, the store name, whether there is a logo and the time of the daily reminder.
Parameters
No parameters.
Returns
{ orders_enabled, store_name, has_logo, reminder_time }
Current store and order configuration, without changing anything.
Order summary
Read onlytilopay_orders_status
Summary of the micro-stores' orders: how many are pending payment, how many are paid and undelivered (with their amount) and how many were delivered today.
Parameters
No parameters.
Returns
{ pending, paid, delivered, ... }
Order summary: how many are pending payment, paid and undelivered, and delivered, with the period's amounts.
List orders
Read onlytilopay_orders_list
Lists the micro-stores' orders with their code, customer, total and detail. It can be filtered by status (pending = pending payment, paid = paid and undelivered, delivered = delivered) and by the last days.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string (pending | paid | delivered | all) | — | Order status; all by default |
days | integer | — | Only orders from the last N days |
limit | integer | — | — |
Returns
{ orders[] }
orders = orders with code, customer, total, currency, status and date. It can be filtered by status (pending, paid, delivered, all) and by the last days.
Paid, undelivered orders
Read onlytilopay_orders_pending
Lists the orders already paid that have not been delivered yet. This is the tool used by the daily reminder.
Parameters
No parameters.
Returns
{ pending, orders[] }
pending = how many orders are paid and undelivered; orders = those orders with code, customer, total and currency.
Mark an order as delivered
Writetilopay_order_mark_delivered
Marks one or several orders as delivered. It accepts the order code (e.g. "#A3F2", even several in the same message) or the customer name.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | — | Order code, e.g. "#A3F2"; several can be given |
client | string | — | Customer name of the order |
Returns
{ delivered, missing }
delivered = how many orders were marked as delivered; missing = the codes that were not found.
Turn off order management
Sensitivetilopay_orders_disable
Turns off order tracking and cancels the daily reminder. Already registered orders are kept. Ask for an explicit yes before using it.
Parameters
No parameters.
Returns
{ orders_enabled: false }
Turns off order management. Already registered orders are kept.
Last verified: 2026-09-14 · Owner: equipo-integraciones