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.

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.

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