Checkout Parameters

Passing additional parameters allows you to modify the behavior of the Paddle checkout, such as pre-filling a buyer's email address or setting a custom message. Either JavaScript parameters or HTML attributes can be used, depending on your integration.

How to pass in parameters

The method of specifying checkout parameters depends on whether you have implemented your checkout using the paddle_button class or are invoking the checkout yourself by calling the Paddle.Checkout.open() method.

If you are using the paddle_button class, checkout properties must be set using data attributes on the button itself (see the HTML Attributes tab in the table below). If you are calling Paddle.Checkout.open(), the properties should be set by specifying parameters in the method call (see JavaScript Attribute column below).

See below for a simple example showing how to pass in a user email to the checkout.

Before you continue make sure you've added your approved domains in your Paddle vendor dashboard under Checkout > Checkout Settings > Approved Domains. Please note, that you don't need this if you're just testing on your localhost. Learn more about approved domains here.

Checkout Properties

A full list of checkout properties is shown below for use either on checkout buttons, or with the Checkout.open() method.