Skip to content

Embedded payment form

Off by default. When it’s on, Polar’s checkout opens in a window over your checkout page, and shoppers stay on your site.

  1. Turn on Embedded payment form in the plugin’s settings, and choose Payment window theme: Light or Dark.
  2. In each Polar organization (live and sandbox), add your site’s address under Settings › Preferences › Embedding. The settings panel shows exactly what to add. Until it’s there, Polar won’t open inside your site and shoppers are sent to Polar’s page instead.

If you haven’t changed the payment method’s description, it becomes “Pay securely in a Polar window, without leaving this page.” If you wrote your own and it mentions being redirected, update it.

Your site needs HTTPS, except on localhost. Apple Pay and Google Pay inside the window also need Polar to verify your domain: ask Polar support.

What the shopper does Where they go
Pays Your order-received page
Closes the window The order’s pay page; the order stays payable
The window doesn’t open or report in time Polar’s own checkout page, as usual

It works on the checkout block and the classic checkout. The order-pay page always goes to Polar’s page. The webhook confirms the payment either way.

Checked against Payments via Polar for WooCommerce 1.2.3 on main, 19 October 2026.