For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/create/max-design/checkout.md.
  • English
  • How do I sell with a checkout, upsell and downsell inside a Max Design site?

    Ask Max in a design-mode conversation: "checkout at the end of the sales page" or "upsell page with accept and decline". Max puts the Clickmax checkout inside the page, on the site's own address. The offer sold is written in the page's code, and payment is processed by Clickmax: card details are typed into a Clickmax field, and the site never receives them.

    Prerequisites: a Max Design project (see How to create a site or page with Max), creator access in the workspace and the offer set up in Products, or a request for Max to create one.

    Ask Max for the checkout

    1. In the project conversation, ask for the checkout, upsell or downsell and say which offer to sell. If the offer does not exist yet, Max creates the product and the offer (it asks for the price if missing) and tells you what it created.
    2. Check it in the preview. It shows the checkout with the offer, price and installments, but does not sell: payment only works on the published site.
    3. Approve publishing. After that, the page goes live and its funnel step gets the purchase triggers.

    You can also ask for the whole funnel at once, for example "capture, sales, checkout, upsell and thank-you". Max builds every step as a page of the same site, picks the offers you already have or creates the missing ones, and makes each page lead to the next: after an approved purchase, to the upsell; after the upsell is declined, to the downsell. It links the pages to the funnel steps while building, before publishing: the funnel shows them as not live yet until you approve publishing the site.

    If you prefer to sell through the Clickmax checkout page, outside the site, just ask: the purchase buttons then lead to it. Without a checkout on the page, buttons can also link to a checkout URL you already have: give Max the link and it adds it to the button.

    Do not paste the checkout on an external page snippet here (the <ClickmaxCheckout /> component). That snippet is for sites hosted outside Clickmax and shows the checkout in a frame (iframe), with the offer chosen on the funnel step. In Max Design, the checkout is part of the site itself.

    Checkout look

    By default, the checkout, upsell and downsell come with the look of the standard Clickmax checkout: light gray background, the product on the left and the form in a white card on the right, with the green Finalizar compra button. The name, image, description, price and installments come from the offer. This also applies when the checkout replaces a block of an existing page, such as the capture form.

    For a checkout that matches the site, ask Max for it, for example "checkout with the site's colors and fonts" or "dark checkout, in one column". Max rebuilds the checkout in the project's look.

    The offer lives in the page's code

    Max puts the offer in the checkout, upsell or downsell, and it is written in the page's code. The offer is not chosen in the funnel.

    • The step of a Max Design page has no Add Products: the offer comes from the code.
    • To sell another offer on a page, ask Max ("sell the Complete Course offer on this page"). It changes the page and publishes the site again, with your approval.
    • The offer must belong to your account. If the code uses an offer from another account or one that does not exist, the publication fails and Max tells you.
    • If the offer is deleted after publishing, the funnel shows a warning on the step until Max changes the offer and the site is published again.

    The price, installments, item name and images, order bumps, timer and coupon field are already in the published page's code, ready for search engines to read and for visitors to see without waiting for the page to load. Buyer data and payment only show up in the browser.

    Order bumps in the checkout

    Ask Max for the order bumps, for example "add the e-book as a required bump and the spreadsheet as optional, titled Add this too". They are written in the page as well, next to the main offer:

    • A required bump is always in the order, shows as included and has no checkbox.
    • Optional bumps show with a checkbox, under the title you choose. Without a title, the checkout uses a default text.
    • Bumps show in the order you ask for.
    • To add, remove or change a bump, ask Max: it changes the page and publishes the site again, with your approval. The bumps of these pages are not set up in the funnel step or in the page editor.
    • If a bump's offer is deleted, it just disappears from the checkout.

    One-click upsell and downsell

    On the site's upsell and downsell, a buyer who just paid by card in the same browser accepts the offer with one click: the checkout uses the card saved in the previous purchase, without asking for the details again. Buyers who paid with Pix or boleto, or who opened the page in another browser, pay for the offer through the page's form.

    The site's checkout talks to Clickmax through the site's own address, on the /__clickmax/payments path. That keeps the main purchase and the upsell on the same domain, so the browser does not block the previous purchase's data. If you put another service in front of your domain (your own proxy or firewall), let that path through.

    Details in How One Click Buy works.

    Protected upsell and downsell

    People who did not buy cannot open the site's upsell or downsell from a direct link. Clickmax checks the purchase before serving the page. Without a recent purchase on that site and in that browser, the visitor goes to the site's first page with a checkout (or to the home page, if there is no checkout), keeping the link parameters, UTMs included. You do not need to ask Max: every page with an upsell or downsell is protected from the start.

    A recent purchase is one completed in the site's checkout, including a generated Pix or an issued boleto. It lasts as long as one-click purchases do. A buyer who switches browsers (from desktop to phone, for example) is also sent to the checkout. Max Design does not use the protection in Funnel Settings, because the pages and the navigation live in the site's code.

    The protection applies to sites published from this version on. A site published earlier becomes protected on its next publication.

    When the offer changes, the site is published again

    Since the offer data is in the page's code, changing the price, installments, name, images, order bumps, timer or coupon of an offer used by a published site makes Clickmax publish that site again, with the same code that is already live. This also applies to an offer used as a bump. Only the offer data changes: edits you made in Max Design and did not publish stay unpublished.

    Before saving, the offer screen and Max show a warning with the sites and pages that use the offer. Choose Save and republish to continue or Cancel to change nothing. Confirming this warning already authorizes the new publication: Max does not ask for another approval for it.

    • The publication starts about 1 minute after the last save. Several changes in a row become a single publication.
    • Each site usually takes 2 to 5 minutes to publish.
    • Meanwhile, visitors already see the new price as soon as the page loads. Only the page's initial code keeps the previous value until the publication finishes.
    • The offer screen shows Republishing your sites during the publication. If it fails, Republishing failed appears with a Try again button. If it keeps failing, publish the site from Max Design.
    • Changes that do not show on the page, such as deliverables, webhook and support email, do not publish the site.
    • If an affiliate sells your offer on a Max Design site, their site is published again too. The warning only shows how many sites from other accounts there are, without their names.

    Purchase triggers in the funnel

    After publication, the page step gets the purchase triggers: Purchase Approved, Purchase Declined, Card Declined, Pix Generated and Boleto Generated on the checkout, Upsell Accepted and Upsell Declined on the upsell, Downsell Accepted and Downsell Declined on the downsell. They count in the funnel metrics and can start an automation, which only runs for purchases of the offer sold on the page. Declined upsells and downsells count in the funnel but do not start automations.

    The arrows between steps are still only a drawing of the funnel: the site itself takes the visitor to the next page.

    If you edit the code

    In Code mode, the checkout is built with the @clickmax/rsbuild-plugin plugin, from the runtime/checkout path. What changes what is sold:

    • The offer is its code (hash), passed in loadCheckout({ offer: '<hash>' }) on the page's route. That is what puts the price in the published code. Without this call, the page only shows the price after loading.
    • Bumps go in the same call: bumps: [{ offer: '<hash>', required: true }, { offer: '<hash>' }], with bumpTitle for the title.
    • On the upsell or downsell route, pass mode: 'upsell' or mode: 'downsell'. Without it, one-click purchase stays off.
    • The component is <Checkout>, <Upsell> or <Downsell>. Do not mix it up with <ClickmaxCheckout /> from the external page snippet.

    Limits

    • Each page has at most one checkout, one upsell or one downsell.
    • Each checkout takes up to 10 bumps, which must be active offers of your account, with no repeats and different from the main offer. If a bump belongs to another account or does not exist, the publication fails and Max tells you.
    • The preview next to the chat does not sell. Test the purchase on the published site.
    • One-click purchase only works for buyers who paid the previous purchase by card, in the same browser.

    If it did not work

    • The publication failed because of the offer: the offer or a bump belongs to another account or does not exist. Ask Max to use an active offer from your account.
    • The page shows an old price: the republication is still running or failed. Check the status on the offer screen and use Try again.
    • The upsell asked for the card again: the buyer paid with Pix or boleto, switched browsers, or the upsell route does not declare the upsell. Ask Max to check it.
    • I cannot buy in the preview: that is expected. Publish and test on the published site.
    • The upsell sent the buyer to the checkout: the purchase was made in another browser, or the visitor cleared cookies. To test, buy and open the upsell in the same browser, on the published site.