Skip to content
Blog

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

OverlayInlineHosted
Where it opensA popup over your pageA frame inside your pageA new browser window
Items and totalsInside the popupOn your own page–
Made forWebsites and appsWebsites and appsMobile apps
In PimiPayYes, the defaultYes, one settingNo

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.

Ready to add Paddle for WooCommerce?

Install the WooCommerce Paddle plugin and start accepting payments on your store today.

Buy now