Paddle Checkout in WooCommerce: Overlay, Inline or Hosted?
Paddle’s docs describe an overlay, an inline and a hosted checkout. Two run inside a website and one is for mobile apps. This post shows what the buyer sees in each, which ones PimiPay, the Paddle gateway for WooCommerce, supports, and how to choose.
The three at a glance
| Overlay | Inline | Hosted | |
|---|---|---|---|
| Where it opens | A popup over your page | A frame inside your page | A new browser window |
| Items and totals | Inside the popup | On your own page | – |
| Made for | Websites and apps | Websites and apps | Mobile apps |
| In PimiPay | Yes, the default | Yes, one setting | No |
Overlay: a popup over your page
Paddle calls the overlay the quickest way to add its checkout to a website. It opens on top of the page and handles the whole payment: the items list, the totals and the payment form are all inside it.
With PimiPay, the customer fills in the WooCommerce checkout and clicks Place order. WooCommerce creates the order as pending and moves to the order-received page. There the overlay opens by itself. If the customer closes it, the Pay Now button under “Complete Your Payment” opens it again.
Inline: a frame inside your page
Inline checkout puts the same Paddle payment form in a frame on your own page. Nothing pops up. The trade-off is in Paddle’s docs: the inline frame does not include a breakdown of items or totals, so your page has to show them.
In PimiPay, inline is the Checkout Display setting. The flow is the same as the overlay up to the order-received page; there the form appears in the “Complete Your Payment” box, not in a popup. If the element the form renders into is missing from the page, the overlay opens instead. If the form does not load, Pay Now opens the overlay. The inline checkout post covers the details.
Hosted: for mobile apps
Paddle’s hosted checkout is a different thing. Paddle describes it as a way to let mobile app users pay outside the app: a button opens a new browser window with Paddle Checkout, and after payment the customer is sent back to a screen in the app. On a live account it needs additional approval from Paddle.
PimiPay does not use it. A WooCommerce store is already a website, so the checkout opens there.
What stays the same
Overlay and inline differ in where the form sits and who shows the order summary. The rest is shared. In PimiPay, both:
- open on the order-received page, and on the order-pay page for a pending order,
- use the Checkout Theme (light or dark) and Checkout Language settings,
- charge the same items, and complete the order the same way.
Paddle lists both as working with all its supported payment methods. Both also need a default payment link in your Paddle account, on an approved domain once you go live.
How to pick
Start with the overlay. It is the default, it shows the order summary by itself, and it is what Paddle recommends if you are new to Paddle.
Switch to inline when a popup does not fit the page design. Then check that the order’s items and total are on the same page as the form, because the inline frame does not show them. Switching back is the same dropdown.
Both settings are described in the checkout docs, and the rest of the screen in configuration.
The plugin is $59 a year, with a 30-day money-back guarantee: buy it here.
FAQ
What types of Paddle checkout are there?
Paddle’s docs describe overlay, inline and hosted. Overlay opens in a popup over your page. Inline sits in a frame inside your page. Hosted checkout opens in a new browser window and is made for mobile apps.
Which Paddle checkout works with WooCommerce?
With PimiPay, overlay and inline. Overlay is the default, and the Checkout Display setting switches to inline. Hosted checkout is not used.
Should I use Paddle overlay or inline checkout?
Overlay for most stores: it shows the items and totals itself. Use inline when a popup does not fit your page, and make sure your page shows the order summary.