Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

Customers click Buy and the Paddle checkout does not open

Short answer

Paddle's checkout opens only when its script is on the page and initialised with a client-side token. For links sent to customers, Paddle also needs a default payment link on a domain approved for live payments. Check those items, and that you did not mix sandbox and live settings.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • Clicking Buy does nothing, or the page just reloads.
  • The checkout worked in testing and not on the live site.
  • A payment link from Paddle opens a page without a checkout.
  • The checkout opens on one page of the site and not on another.
  • It stopped after the site was moved, redesigned or put on a new domain.

Why does this happen?

  1. The Paddle script is missing, or not started

    Paddle's documentation says Paddle.js is loaded from its own address and then initialised with a client-side token. Initialisation is needed on the pages where you show prices or open a checkout. A redesign or a page builder that drops the script from some pages stops checkout there.

  2. The token belongs to the other environment

    The documentation says client-side tokens starting with test_ are for the sandbox and those starting with live_ are for production. A test token on the live site, or the reverse, points the checkout at the wrong place.

  3. There is no default payment link

    Paddle's guide says a default payment link must be set in the dashboard before transactions can be created, including invoices, that sandbox and live are configured separately, and that the page at that link should include Paddle.js.

  4. The domain is not approved for live

    For live payments, Paddle says the host of the payment link must match an approved domain exactly, or its www version. The domain is added under website approval in the dashboard and must be approved. Sandbox does not require approval, which is why testing can pass while live fails.

  5. Code on the page overrides the link

    Paddle says that if the page calls the open-checkout function on load, with items or a transaction, that takes priority over the parameter in the link.

What can I do about it today?

  1. Test in a private windowOpen the live page in a private or incognito window with extensions off, click Buy and note exactly what happens. Add a screenshot.
  2. Check the Paddle dashboard, not the siteLook for the default payment link, its domain and the website approval status, for live and for sandbox separately. Do not change them yet; write down what you see.
  3. Compare with the last working dateNote when it last worked and what changed since: a new theme, a new domain, a plugin or a cache setting.
  4. Do not share secret keysPaddle's documentation says never to use an API key in frontend code and to revoke one that was. If your developer asks for a client-side token, that is the public kind. Never email a secret API key.
  5. Offer another way to pay for nowIf you can, put an email address or a message form beside the Buy button, so a customer who cannot check out can still reach you.

When should I bring someone in?

  • Live payments fail while the sandbox works.
  • The site was moved to a new domain or a new host and approval has to be redone.
  • The checkout shows an error code you do not understand.

How do I handle it?

  1. Reproduce it in the browserI open the page with developer tools and check whether the script loads, initialises and what the console reports on click.
  2. Check the Paddle settings side by sideI compare token, default payment link and approved domain for live and sandbox, because a mismatch between them is the usual cause.
  3. Fix the page codeScript placement, initialisation on each page and the call that opens the checkout are corrected, with no duplicate calls fighting each other.
  4. Test a real purchase pathIn the sandbox I run the full path from the Buy button to the completed transaction, then confirm the live settings line up with it.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Why does it work in the sandbox only?

Paddle says sandbox does not require domain approval, while live needs the link's host to match an approved domain. Sandbox and live also have separate default payment links.

Can an ad blocker stop the checkout?

Paddle's page I read does not say. A private window with extensions off is a quick way to rule it out.

Is the fix on Paddle's side?

Usually the cause is in the site settings or the page code. Paddle decides domain approval, so I cannot promise how fast that step goes.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.