Use Case: Complete Apple Pay Registration

Updated
  • Updated on Jan 5, 2026
  • Published on May 13, 2025
  • 1 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 on 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 describes the required Apple Pay registration process.

Audience: Partner

Complete Apple Pay Registration

Complete all steps in the following sections to begin offering Apple Pay as a payment method on your payment pages.

Prerequisites

Before attempting this tutorial, you must:

  • Meet the general prerequisites described in Get Started with Use Case Tutorials.

  • Have an integrated development environment (IDE) like Microsoft VS Code.

  • Have Apple Pay enabled for your account. Apple Pay is enabled for registration within your portfolio by default.

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.

    Tip

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

  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 domains where your domain configuration file is hosted and merchant IDs for the merchants 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.

Related articles