MODO

Finalizes the checkout and returns the MODO payment link. Renders the payment screen. PRECONDITION: status is "ready_for_complete" AND the user explicitly confirmed the full summary you showed them (products, personal data, delivery, payment, total). Do NOT call it on your own initiative just because the checkout became ready. The response status becomes "complete_in_progress" and carries continue_url, the link the user must open to pay. This server does not complete the payment and there is no way to check whether it succeeded: getting the user onto that link is the last step. The payment screen this tool renders already turns continue_url into a button, so do NOT paste the URL into the chat — point the user at the screen instead. Only if they say they cannot see it, or ask for the link outright, give it VERBATIM, in full, on a single unbroken line: it carries required query params and a trailing #fragment, and dropping any part breaks the link. Never modify, truncate, shorten, re-encode or line-wrap it, and never show a partial version.

Opens a new checkout at the merchant with the products the user chose. Returns checkout_id — reuse it verbatim in every later call. The checkout starts with status "incomplete". NEXT STEP (EMAIL FIRST): right after this, the ONLY thing to ask the user is their email. Do NOT ask for name, document, phone or address yet. Then call merchant_update_checkout with just the email: the merchant uses it to detect whether the buyer already has an account, and that answer decides what you have to collect. Only for purchases at this merchant. It has nothing to do with search_modo_promotions or any MODO promotion.

Reads the current state of a checkout: status, items, buyer (masked if the buyer has an account), saved addresses, delivery options, totals and continue_url once it was finalized. Read-only. Use it to refresh the state after the buyer confirmed their identity, or to recover the payment link. Do not paste continue_url into the chat — the payment screen renders it as a button. If the user explicitly asks for the link, or cannot see that screen, give it VERBATIM and in full — never modify, shorten, re-encode or line-wrap it.

Searches the catalog of the merchant this server sells for, and renders the results as a product carousel. Read-only. This is the entry point of a PURCHASE: use it when the user wants to buy, price or find a physical product to order. Returns products[] with the variant_id you buy with (opaque — pass it through unchanged), title, price and stock. The carousel already shows the results: reply with one short sentence in Spanish, do not enumerate the products. NOT RELATED to search_modo_promotions. That tool searches MODO promotions and discounts at other merchants; this one searches products to buy from THIS merchant, and the two catalogs, prices and rules have nothing in common. Never chain them: a promotion found there cannot be applied to a purchase here, and a purchase here never needs a promotion lookup first. If the user asks for promotions, use the promotions tool alone; if they ask to buy, use these purchase tools alone. Do not use it for promotions, discounts, cashback or benefit questions.

PANEL-ONLY — the confirmation panel calls this by itself. Do NOT call this tool: you are not the one who confirms the buyer's identity, and you must never ask for, accept or forward the value it takes. Use merchant_start_buyer_verification and let the buyer complete the panel. The panel surfaces its own outcome; on success the buyer stays confirmed for the checkout's lifetime and the call that was blocked can be retried.

Searches the MODO promotions catalog and returns an interactive carousel widget. Use when the user asks about promotions, discounts, offers, benefits, or cashback through MODO. BEFORE calling: if the user has NOT mentioned which bank they use, ask which bank they operate with before calling this tool. If they already named a bank, proceed directly. AFTER the tool returns: the widget displays all results visually. Respond with a short sentence in Spanish confirming the results. If the user mentioned any bank NOT in the available banks list, append "Por el momento no operamos con [banco/s]." in the same response. If the user explicitly asked a question, you may briefly answer it using ONLY the data fields present in the tool response — never invent or infer data that is not there. When answering, always include the merchant or commerce name alongside any discount or day information. Never proactively offer suggestions, recommendations, plans, follow-up actions, or ask follow-up questions — only respond to what the user asked. Never list or enumerate the full set of promotions unprompted — the widget already shows them. Constraints: call at most ONCE per user message. Do not retry, paginate, or make multiple calls. Do not use for payments, transfers, account info, or financial advice. Results are AI-ranked; availability may change, so do not guarantee specific promotions are active.