Paddle Billing
Search

Overlay checkout

Overlay checkout is the quickest way to integrate Paddle with your website or app. Turn any element into a checkout link, letting Paddle handle the entire checkout process.

Integrate Paddle with a few lines of code using overlay checkout. Customers sign up and pay for subscriptions using an overlay.

Using overlay checkout, you can:

  • Integrate Paddle quickly with a few lines of code.
  • Choose whether to present a one-page or a multi-page checkout experience.
  • Present an optimized checkout experience, where customers can sign up and pay without leaving your site.
  • Create checkout links using HTML data attributes — perfect for CMS-based sites.
  • Use Paddle.js events to build advanced checkout experiences.
Illustration showing an overlay checkout. On the left-hand side is an items list. There are two items for a total of $3600 including tax. On the right-hand side is a payment form. There are buttons for card, PayPal, and Apple Pay. The card button is selected and the card details form is shown underneath. There's a big button that says Pay $3600.

How it works

Overlay checkout works by showing an overlay with all the checkout details. You can turn any element on your page into a button that opens a checkout.

The overlay includes all checkout functionality including the items list, totals, and options for changing what's on the checkout.

Paddle automatically creates a subscription when a checkout completes, ready for you to provision.

Customer journey

  1. Illustration showing the outline of a pricing page. The middle tier is called 'Premium' and costs $200. There is a buy now button in blue.

    Customer launches overlay checkout

    You can turn any element on your page into a Paddle Checkout button, passing items or an existing transaction to Paddle.js to say what the checkout is for.

  2. Illustration of a simplified overlay checkout. The total is $3600. The payment form is presented, showing options for card, PayPal, and Apple Pay. There are fields for email address, country, ZIP code, and card details. There's a blue 'Pay $3600' button at the bottom.

    Customer enters their details on one screen  

    Overlay checkout asks customers for their email, country, and (in some regions) ZIP or postal code. On the same screen, customers are presented with the card payment form, as well as options to pay with PayPal, Apple Pay, Google Pay, or other local payment method.

  3. Illustration of a simplified overlay checkout. It shows a large checkmark, indicating that checkout is completed.

    Checkout completed

    Paddle routes every payment to the best acquirer for that sale to get the best possible chance of success. Customers land on a success page that you can choose.

  4. Illustration showing a created subscription in Paddle. This is an abstract illustration, rather than a representation of an interface. In the background is a sheet with a user icon, recurring amount, MasterCard symbol, and an active tag. It's meant to represent a subscription page in the Paddle web app. In the foreground is a card that says 'webhook received: new subscription for premium plan.' It's meant to represent a subscription.created webhook event.

    Paddle creates a subscription

    Paddle automatically creates a subscription for the customer, ready for you to provision. The payment method the customer used is held on file for renewals or subscription changes.

Next steps