Express checkout for Apple Pay

What's new?

We've introduced express checkout, a new checkout variant designed for mobile that prioritizes digital wallets for a frictionless, one-click payment experience.

It's available in early access for Apple Pay, using Apple Wallet to capture customer email address, plus geolocation information for address details.

How it works

Express checkout is a new checkout variant that's designed for mobile. It prioritizes Apple Pay, presenting it first to customers, and uses details from Apple Wallet to capture customer email address.

Behind the scenes, Paddle Checkout uses the customer's IP address to estimate the correct tax and pricing before the checkout loads, eliminating the need for customers to enter their address details before opening Apple Pay.

If Apple Pay is unavailable on the customer's device, the checkout automatically falls back to alternative payment methods.

You must verify your domain for Apple Pay in order to offer the one-click experience in express checkout.

Early access program guidelines

Why are we doing this?

Mobile users overwhelmingly prefer digital wallets over card payments. In particular, Apple Pay is deeply integrated into the Apple ecosystem, making it the fastest and most convenient payment method for customers on iPhone.

Express checkout improves conversion rates and customer satisfaction by:

• Surfacing Apple Pay as the first payment method on a compatible device, making it the easiest option for customers to select.
• Using Apple Wallet and geolocation information to capture customer information, eliminating the need for customers to manually enter their email, country, and postal code.

If Apple Pay is unavailable on the customer's device, the checkout automatically falls back to alternative payment methods.

What's included?

For this stage of the early access program, express checkout includes:

• A new express checkout variant in Paddle.js.
• One-click payment flow for Apple Pay, with Apple Pay prominently displayed at the top.
• Automatic location detection using IP address geolocation for tax calculations and address detail capture.
• Use of Apple Wallet information to capture customer email address.
• Fallback to standard payment methods and option to pay another way.
• A new showNonExpressPaymentMethods parameter to determine whether the option to pay another way is shown.
• The ability to override customer and address details by prefilling data before checkout.
• Full transaction webhook support, like standard checkouts.
• Support for one-time purchases and subscriptions.

Are there any limitations?

There are some limitations with express checkout:

• Customers can't input business or tax information.

  There's no option to input tax or VAT information on the inline checkout form. You can pass this information to Paddle.js when opening the checkout using the customer.business parameter. If you pass showAddTaxId: true, it's ignored and checkout is loaded.

• Customers can't add a discount code.

  There's no option to add a discount code on the inline checkout form. You can pass this information to Paddle.js when opening the checkout using the discountId or discountCode parameter. If you pass showAddDiscounts: true, it's ignored and checkout is loaded.

• It's not yet available if you're using a partner for funnels or paywalls.

  If you're using a partner for funnels or paywalls, express checkout for Apple Pay isn't available just yet. We're working with our partners to bring express checkout to their funnels and flows. This doesn't impact users who are only using a partner for fulfillment or entitlements.

What's planned for the future?

In the future, we're planning to add support for:

• An event to detect when the inline checkout frame size changes.

  We'll add a new Paddle.js event when the inline checkout frame size changes, which you can use to dynamically resize an outer container like a sheet or modal.

• Express checkout for other digital wallets.

  Right now, express checkout supports Apple Pay. In later versions of express checkout, we may add support for other digital wallets like Google Pay and PayPal.

What do we need from you?

We're keen to understand how you find express checkout and any feedback from customers about the experience. Your feedback will help shape the feature for general availability.

To share feedback:

• Use the feedback button at the top-right of this page.
• Email us at sellers@paddle.com.

We may reach out during the early access program to discuss your experience and gather specific insights.

What's the timeline for release?

We're releasing express checkout in multiple stages:

These dates are estimates and may change depending on testing and feedback.

Examples

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1import { initializePaddle, Paddle } from '@paddle/paddle-js';
2
3// Initialize Paddle (async)
4const paddleInstance: Paddle | undefined = await initializePaddle({
5  token: 'live_7d279f61a3499fed520f7cd8c08', // replace with a client-side token
6});
7
8if (paddleInstance) {
9  // Open checkout with Express variant
10  paddleInstance.Checkout.open({
11    items: [
12      {
13        priceId: 'pri_01gm81eqze2vmmvhpjg13bfeqg',
14        quantity: 1
15      },
16      {
17        priceId: 'pri_01gm82kny0ad1tk358gxmsq87m',
18        quantity: 1
19      }
20    ],

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1import { initializePaddle, Paddle } from '@paddle/paddle-js';
2
3// Initialize Paddle (async)
4const paddleInstance: Paddle | undefined = await initializePaddle({
5  token: 'live_7d279f61a3499fed520f7cd8c08', // replace with a client-side token
6});
7
8if (paddleInstance) {
9  paddleInstance.Checkout.open({
10    items: [
11      {
12        priceId: 'pri_01gm81eqze2vmmvhpjg13bfeqg',
13        quantity: 1
14      },
15      {
16        priceId: 'pri_01gm82kny0ad1tk358gxmsq87m',
17        quantity: 1
18      }
19    ],
20    customer: {

Summary of changes

Paddle.js parameters

This is a summary of changes to parameters in the Paddle.Checkout.open() and Paddle.Initialize() methods:

Next steps

Access to express checkout for Apple Pay is currently limited to users who are part of the early access program. If you're interested in participating, fill out the form to join the waitlist. We'll reach out when space is available if you meet the program requirements.

To implement:

1. Apply to join the early access program by filling out the form.

2. Make sure your domain is verified for Apple Pay.

3. Update your Paddle.js configuration to pass variant: express as a checkout setting. See the examples for more details.

If you're using a partner for funnels or paywalls, express checkout for Apple Pay isn't available just yet. We're working with our partners to bring express checkout to their funnels and flows. This doesn't impact users who are only using a partner for fulfillment or entitlements.

Related pages