⚠️ Requires X-Cart 5.5.1 or later.

Table of Contents

Apple Pay + PayPal via X-Payments

Previously, we explained how to set up Apple Pay in X-Payments for various payment methods. Setting it up for PayPal, however, requires a few extra steps due to its unique verification process. Let’s walk through each step in this guide.

Before you start

Create an X-Payments Cloud Account via your X-Cart Admin.

Enabling Apple Pay

To set up Apple Pay to work with PayPal via X-Payments, you’ll need to follow these steps:

Download Apple Domain Verification file 📄 from your PayPal account.
Upload the verification file to the correct directory on your server 🌐.
Verify the files in PayPal to activate Apple Pay.

Existing users will also need to re-enable PayPal in X-Payments. Below we'll go through each step in detail.

What is Apple Domain Verification file 📄?

This file proves to Apple that you own the website. If your domain isn’t verified, the Apple Pay button won’t show up on checkout.

💡Learn more ›

1. Downloading Apple Domain Verification file

At this point you should have PayPal account connected to X-Payments.

I don’t have a PayPal account

Go to Store › Payment Methods
Find X-Payments Cloud and click ⚙️ Settings.
Click Add payment gateway selector, pick PayPal.
Click Add .
On the next page, click Connect PayPal account .
Follow sign-in instructions on the screen.

I have a PayPal account but haven’t connected it to X-Payments yet

Follow these instructions to add PayPal as a payment method in X-Payments.

After connecting your PayPal account, go to the Register Your Website with Apple Pay page in PayPal. You can access thus page in one of two ways:

Via the PayPal website.
Through a direct link in your X-Payments admin.

Accessing Apple Pay Settings via the PayPal Website

Click your profile picture 👤 in the top-right corner.
Select Account Settings from the menu.
At the bottom of the sidebar on the left, select the Payment Methods tab.
Click Manage Apple Pay to open the Apple Pay Settings page.
Click Add Domain .

After clicking Add Domain , you'll see the Register Your Website with Apple Pay page:

In Step 1, enter your website address in the required field.
In Step 2, click the file link ⬇️ to download the Apple Domain Verification file.

⚠️ Do not click Register Domain yet. Close the page for now.

Apple Pay Settings on PayPal Website

Accessing Apple Pay Settings Through a Direct Link in X-Payments

You can find a direct link to the Register Your Website with Apple Pay page in the PayPal Payment Configuration Details section within both the X-Payments Dashboard and X-Cart Admin. Here's how to find it:

Via X-Cart Admin

Go to Store › Payment Methods
Find X-Payments Cloud and click ⚙️ Settings.
Under Payment Method, pick PayPal.

Via X-Payments Dashboard

Open your X-Payments Dashboard (Example.xpayments.com/admin.php).
Go to Settings › Payment Processing.
Under Payment Method, pick PayPal.

Once you’re on the PayPal Payment Configuration Details page, click the link labeled 'page' 🖇️.

Link to access Register Your Website with Apple Pay page

After clicking page link, you'll see the Register Your Website with Apple Pay page:

In Step 1, enter your website address in the required field.
In Step 2, click the file link ⬇️ to download the Apple Domain Verification file.

⚠️ Do not click Register Domain yet. Close the page for now.

2. Adding Domain Association File to your Store

The file you downloaded should not have a file extension. If your computer added one automatically, rename the file to remove it.

Now, you need to place the domain verification file in the following path for each domain you’re registering with PayPal:

https://[DOMAIN_NAME]/.well-known/apple-developer-merchantid-domain-association

📋 Note: Ensure the file is in place before you click Register Domain in Step 1.

🧑🏻‍💻 We Can Help You!

If your website is hosted on X-Cart servers, our support team can handle this step for you. Just reach out at support@x-cart.com.

3. Verifying the Domain in PayPal

After adding the Apple Domain Verification file to your store, you’ll need to confirm the connection in PayPal to activate Apple Pay.

To do this, return to the Register Your Website with Apple Pay page in your PayPal account, either through:

The PayPal website (after Step 5), or
The direct link in X-Payments (go back to Step 4).

Once there:

Step 1: Re-enter your website address in the required field.
Step 2: Click Register Domain to complete the verification.

Registering Domain in PayPal

Re-enabling PayPal in X-Payments (for existing users)

If you used PayPal via X-Payments prior to October 8, 2024, you'll need to reconnect it after verifying your domain. This step is needed because X-Payments doesn’t yet have the necessary permissions for Apple Pay to work.

To reconnect PayPal, follow these steps:

Open the X-Payments Dashboard (or go through X-Cart Admin Area).
Go to Settings › Payment Processing › PayPal.
Click the Status selector 🕹️.
Select Disconnect PayPal Account and accept the changes.
Click the Status selector 🕹️ again and select Connect PayPal Account.
Follow the on-screen instructions to complete the process.

Re-connecting PayPal in X-Payments

This will authorize Apple Pay for your PayPal account in your store. It only needs to be done once, and no further action will be required afterward.

Customer Experience

Once set up, customers using Apple devices and Safari will see Apple Pay as a new payment option at checkout, on the product page, and in the mini-cart.

Apple Pay on the Storefront

Learn how to activate Google Pay for PayPal in X-Payments ›

Set up Apple Pay for other Payment Methods in X-Payments ›

Can't find answers you're looking for?

Email us at support@x-cart.com. We will be happy to help ✨!