Overview
Apple Pay is a digital payment service that enables users to make secure and convenient transactions using their Apple devices. With Apple Pay, customers can easily pay online or in apps using their stored debit or credit cards in the Wallet app.
This guide outlines the steps required to:
- Enroll and validate your domain for Apple Pay.
- Prepare your Apple test device for end-to-end Apple Pay testing within Unified Checkout.
Part 1: Enrolling in Apple Pay
Before enabling Apple Pay, you must first host a public certificate on your web server and pass your merchant name and domain to Apple. This allows Apple to verify your web pages and register your domain for Apple Pay.
Steps to Validate Your Domain
- Navigate to:
Payment Configuration → Unified Checkout - In the Apple Pay section, click:
Set Up - Download the Certificate
Follow the provided link to download the Apple Pay certificate file. - Upload the Certificate to Your Server
Upload the file named apple-developer-merchantid-domain-association to your web server at the following path:/.well-known/apple-developer-merchantid-domain-association✅ Ensure the file is publicly accessible via HTTPS by visiting:https://<your-domain>/.well-known/apple-developer-merchantid-domain-association - Verify the Domain
Click Verify Domain in your Unified Checkout configuration. - Enter Your Domain Name
Input the domain where the certificate was uploaded.
Once verified, your domain will be registered and ready for Apple Pay.
⚠️ Important:
To perform a full end-to-end test of Apple Pay on Unified Checkout, additional setup is required.
Refer to Preparing a Device for Testing Apple Pay on Unified Checkout.
Part 2: Preparing a Device for Testing Apple Pay on Unified Checkout
To run an end-to-end test of the Apple Pay service, you must prepare a test device by loading Apple Pay test cards from your Apple Developer Sandbox account.
Steps to Prepare Your Test Device
- Ensure Apple Developer Account Configuration
Confirm that your Apple Developer account is properly configured for Apple Pay. - Register Your Apple Pay Test Device
Register the Apple device you’ll be using for testing with Apple. - Load Test Cards onto the Device
Load Apple Pay sandbox test cards onto your device following Apple’s documentation.
Detailed steps are available in Apple’s Sandbox Testing guide. Within the Sandbox Testing guide:- Follow “Create a Sandbox Tester Account” to create your tester profile.
- Follow “Adding a Test Card Number” to load test payment cards into Wallet.
Once completed, your test device will be ready for Apple Pay transaction testing within Unified Checkout.
Summary
You have now:
- Enrolled and verified your domain for Apple Pay.
- Configured your test device for sandbox testing.
Your Unified Checkout environment is now capable of processing Apple Pay transactions securely and efficiently during testing and production phases.