Use Case: Complete Apple Pay Registration

Updated
  • Updated on Jun 9, 2025
  • Published on May 13, 2025
  • 2 minute(s) read
Prev Next

Your Merchants can accept Apple Pay as a payment method from their customers after the parameter is enabled for your portfolio by the Payrix Pro platform. 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.

Objective

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

Audience

  • Partners

Environment

  • Portal (Sandbox)

  • Portal (Production)

Prerequisites

Notes

  • You must have a fully boarded Payrix Pro 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

See the tips below to help you get started.

  • 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

  1. Click Settings under the Admin category in the left navigation panel.

  2. Click Payment Methods under the Business Details box of the Business Settings section.

  3. Click the Enable button for Apple Pay to open the Apple Pay Registration page.

Complete Apple Pay Registration

  1. Download the domain configuration file from the Configure Domain step.

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

  3. Visit each domain being registered to test if the file automatically downloads with the contents matching the original file downloaded from Step 1.

    Note

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

  4. Click Continue.

  5. Download the Bulk Upload Template File CSV from the Enter Domain step.

  6. 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.

  7. Upload your edited template into the file upload prompt and then click Continue.

  8. 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 their customers to add flexibility to payment options.

Conclusion

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

Related articles