Use Case: Complete Apple Pay Registration

Your Merchants can accept Apple Pay as a payment method from their customers after the parameter is enabled for your portfolio by Payrix. After the parameter is enabled, you must complete the registration required by the Apple Pay service for each web domain where Apple Pay will be offered. This tutorial walks you through the required Apple Pay registration process.

Partial view of the Payment Methods page displaying the Start Registration button for Apple Pay within the Portal Settings.

Objective

Complete the required Apple Pay registration for offering Apple Pay acceptance to your customers.

Audience

Referrers

Environment

Portal (Sandbox)
Portal (Production)

Prerequisites

Prerequisites:

You must have a fully boarded Payrix account to perform any of the actions described in the use case guides.
You must have an integrated development environment (IDE) like Microsoft VS Code.
Apple Pay must be enabled for your account.

Tips

Tip: You can also manually download the required Apple Pay domain registration file for your environment using the following links:

Tip: Apple Pay will be enabled for registration within your portfolio by default.

Tip: You can use the Bulk Upload CSV Template File to register the specific Merchant(s) you’d like to enable for Apple Pay payment acceptance from one to all.

Additional Resources

Read Apple Pay Registration for more details about the Apple Pay registration process and other ways to implement the payment acceptance method.

Complete Apple Pay Registration

Ensure that you complete all steps in the following sections.

Access the Payment Methods Page

Click Settings under the Admin category in the left navigation panel.
Click Payment Methods under the Business Details box of the Business Settings section.
Click Enable for Apple Pay to open the Apple Pay Registration page.

Complete Apple Pay Registration

Download the domain configuration file from the Configure Domain step.
Host the domain configuration file on your domain or multiple merchant domains at the following endpoint: {baseURL}/.well-known/apple-developer-merchantid-domain-association.

Example: If you register www.example.com, make the file available at https://www.example.com/.well-known/apple-developer-merchantid-domain-association.

Visit each domain being registered to test if the file automatically downloads with the contents matching the original file downloaded from Step 1.
Click Continue.
Download the Bulk Upload Template File CSV from the Enter Domain step.
Add the applicable domain(s) where your domain configuration file is hosted and Merchant IDs for the merchant(s) you want to enable to the template.
Upload your edited template into the file upload prompt and then click Continue.
Click Register to validate your domains with Apple and complete Apple Pay registration.

Result: Your portfolio is now registered to accept Apple Pay payments from your Merchants' customers to add flexibility to payment options.

Next Steps

After completing Apple Pay registration, review the following guides for additional information on related topics:

Enable Google Pay: Enable the Google Pay payment acceptance method for your Referrer portfolios.
Complete Google Pay Registration: Learn how to finish setting up Google Pay by registering in the portal.

Conclusion

After you complete Apple Pay registration, you can begin offering Apple Pay as a payment method on your payment pages.

References

Click the links or items below to access any of the following pages: