Apple Pay Registration

Apple Pay is a fast, easy, and secure way to pay accepted by over 85% of retailers in the U.S. Apple Pay enables users to add bank and credit cards to their phones for secure payments at stores. Card numbers are converted to unique, secure numbers stored on the phone's chip for safer transactions. Apple Pay replaces the need for customers to take a physical card or type in personal information during sales.

Apple Pay functionality is built into our existing platform requiring little-to-no development work, with three easy integration options for embedded payment options like PayFrame and PayFields and contactless payment terminals.

Compatibility

Apple Pay is compatible with Apple devices, Windows devices, and other devices in third-party browsers. 

The minimum requirements for testing or accepting Apple Pay are:

• Meeting Apple’s minimum requirements and guidelines.

• Devices compatible with Apple Pay

• Add at least one credit or debit card to the cardholder’s Apple Wallet.

• Domain Registration

Domain Registration

As a Partner, you can register one or multiple Merchants for Apple Pay using the Payrix Pro Portal. Domain registration involves providing each Merchant’s web domain to Apple for server call authorization, enabling transaction verification for Apple Pay. Host a file on your website for Apple to verify your domain, ensuring eligibility for Apple Pay integration.

An acceptable Merchant domain for Apple Pay is a public URL with a valid SSL certificate, using a secure HTTPS protocol.

The following sections guide you through the steps for enabling Apple Pay, including registration and domain whitelisting, for both single-merchant and multi-merchant enablement:

1. Initiate the Apple Pay Registration.

2. Configure the Domains.

3. Provide Merchant Domains for Registration.

4. Register with Apple Pay

Initiate the Apple Pay Registration

Follow these steps to initiate the Apple Pay registration for your Merchants domains linked to each Merchant’s website.

1. Access the Payment Methods page from Settings.

2. Click Enable on the Apple Pay panel to initiate the registration process by configuring the domain.

Configure the Domains

Here, you’ll need to configure each domain and register it with the Apple Pay service. This is a crucial step in validating the Merchant for future transactions, ensuring the security of both the Merchant and the cardholder.

Important!

You must meet the following Apple Pay domain configuration requirements:

• Your website URL must be publicly accessible and cannot be set to localhost.

• Your website must begin with https and have a valid SSL certificate for secure communication.

1. Download the domain association file: Sandbox | Production

2. Host the file here: {baseURL}/.well-known/apple-developer-merchantid-domain-association

Result: After you successfully hosted the domain configuration file and have the domains you need to register with the Apple Pay service, proceed to the Enter Domain section.

Provide Merchant Domains for Registration

After completing the steps above, the Apple Pay service will search each website's specific URL path: (/.well-known/apple-developer-merchantid-domain-association)for the matching file once the registration is initiated from the Payrix Pro Portal.

Consider how your Apple Pay setup is structured before providing the Merchants’ domains. Apple requires each domain that processes Apple Pay payments is linked with the correctly registered merchant ID. The following table outlines common domain and merchant configurations to help you determine which domains to register:

Your domain registration file can include a variety of registration scenarios. The following table provides an example of how domains and merchant IDs can be linked:

In this scenario, one Merchant using one domain, one Merchant using multiple domains, multiple Merchants using one domain.

Bulk Upload (CSV)

Bulk Upload allows you to upload a pre-configured CSV file containing domain and Merchant ID pairings. The registration system selects and registers each merchant listed in the CSV file upon completing the Register the Domains with Apple Pay steps.

To upload your CSV file and register your included merchants for Apple Pay:

1. Select Bulk Upload (CSV) from at the top of the page.

2. Click the Template File Download button for a CSV file to add each applicable domain.

3. Add the applicable Merchant domains to the domain column.

   Important!

   Remove the https:// scheme from any domain column values in your CSV file. Domains that include this scheme fail the registration process.  

4. Using the Template File Upload prompt, upload your completed CSV file to the Payrix Pro Portal.

5. Click Continue to proceed to the Register with Apple Pay section.  

Result: All domains and their associated Merchant IDs have been successfully uploaded to the Payrix Pro Portal and you can now register them with the Apple Pay service.

Tip

We recommend downloading your true domain registration file from the Payrix Pro Portal because it is pre-populated with your portfolio’s Merchant IDs.

For a blank template, download this sample Bulk Upload CSV file:

apple-pay-merchant-domains-template

21 Byte

Register the Domains with Apple Pay

When you click the Register button shown on the Register with Apple Pay section, each domain registration file uploaded to the provided domains is compared against the domains provided to Payrix Pro. Apple Pay verifies each domain by cross-referencing files, which completes within seconds.

After completing registration, an on-screen notification is displayed based on your method of enablement:

Merchant registration process is complete.

Your Merchants are now able to start accepting Apple Pay payments.

Enabled: # | Failed: # | Pending: #

Manage Your Merchant Apple Pay Registrations

When onboarding new merchants to your portfolio, you must register each one for the Apple Pay service. Select Payment Methods from the Settings page to access the Apple Pay Registration management dashboard. This dashboard offers a simplified registration process, allowing you to manage registrations seamlessly without causing any interruptions to the operations of previously registered merchants.