---
title: Apple Pay Merchant Certificate Configuration
createTime: '2025/06/24 16:01:54'
permalink: /en/notes/paymentMethods/ApplePay/merchantCertificateConfiguration/
description: >-
  This document describes how to configure Apple Pay merchant certificates for websites to achieve non-hosted Apple Pay Web integration. It is suitable for global online merchants who want to provide Apple Pay payment options through the Safari browser. The content covers the entire process from registering an Apple developer account to completing domain verification, including applying for certificates, creating merchant identifiers, and exchanging certificate information with PingPongPay.
---

## Overview

Apple Pay's web integration allows users to complete payments directly through Apple Pay in the Safari browser on web pages. To implement Apple Pay on your website, you need to perform some configuration and development work, including generating necessary keys, creating payment requests, handling payment authorization, etc. Below is a basic step-by-step guide that explains the process of integrating **Apple Pay Web** using the Non-hosted approach. Compared to the Apple Pay Hosted approach, the Non-hosted approach requires developers to implement the interaction flow with Apple Pay UI themselves.

## 1. Register Apple Developer Account

First, you need to have a valid Apple developer account and join the Apple Developer Program. This is a prerequisite for using the Apple Pay Web API.

## 2. Apply for Certificate

Please send the `application materials` to the email address acq-tech@pingpongx.com, and CC to acq-ts@pingpongx.com

1. Merchant name
2. Merchant AccId
3. Merchant ClientId

After PingPong's acquiring team receives the application email and completes the required configuration, they will reply to the merchant with the certificate as an email attachment.

## 3. Create a Merchant Identifier on the Apple Developer Platform
Creating a merchant identifier (Merchant ID) on the Apple Developer Platform is one of the key steps in integrating Apple Pay. The merchant identifier is used to identify your business and ensure payment process security. Below are the detailed steps to create a Merchant ID. If you already have a merchant identifier, you can skip this step.

###  Log in to Apple Developer Account

1. Open the [Apple Developer](https://developer.apple.com/) platform.
2. Log in to your Apple Developer account.
3. Enter the Apple Developer Center.
4. In Apple Developer, select "Identifiers".

<v4-iImage :src="$withBase('/applePay/account.png')" title="3 Apple Developer Center" ></v4-iImage>
<v4-iImage :src="$withBase('/applePay/regIds.png')" title="4-1 Select merchant IDs" ></v4-iImage>
<v4-iImage :src="$withBase('/applePay/merchantIds.png')" title="4-2 Merchant ID list" ></v4-iImage>
<v4-iImage :src="$withBase('/applePay/Certificates.png')" title="4-3 Certificates, Identifiers & Profiles"></v4-iImage>

### Enter Basic Information for Merchant Identifier

1. Enter a descriptive name, which will help you identify different merchant identifiers in your projects. For example: "My Online Store Payment".
2. Enter the Merchant ID identifier, usually starting with merchant., such as merchant.com.example.onlinestore. This identifier needs to be unique and is typically associated with your domain name for consistency.<v4-iImage :src="$withBase('/applePay/Certificates.png')" title="4-3 Certificates, Identifiers & Profiles"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/onlineStore.png')" title="Enter basic information for merchant identifier"></v4-iImage>

At this point, you have successfully created the merchant identifier.

## 4. Add Certificate to Merchant Identifier
1. Return to the merchant identifier list, click on the currently created merchant identifier, and enter the details page.
2. On the details page, click Create Certificate under **Apple Pay Payment Processing Certificate**.
3. Click **chooseFile** 
4. Upload the **certSigningRequest** type file from the email attachment in the previous steps

<v4-iImage :src="$withBase('/applePay/onlineStore.png')" title="Select Merchant ID"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/processingCertificate.png')" title="Select Merchant ID"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/chooseFile.png')" title="Select file"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/certSigningRequestUpload.png')" title="Upload certSigningRequest type file"></v4-iImage>

## 5. Download Your Certificate
1. Click **Download** to download the certificate.
   <v4-iImage :src="$withBase('/applePay/downloadCert.png')" title="Download certificate"></v4-iImage>
2. After the download is complete, you will get a `.cer` type file
<v4-iImage :src="$withBase('/applePay/cer.png')" title="Download successful"></v4-iImage>

## 6. Merchant Domain Verification

::: note  Note
   Domain verification is only required for Apple Pay Web integration. If using Native SDK integration, domain verification is not required.
:::

1. Enter the merchant identifier list, click on the currently created merchant identifier, and enter the details page.
2. Scroll down on the details page
3. Click **Add Domain**
4. Fill in your domain name
5. Click the **Download** button, you will get an `apple-developer-merchantid-domain-association.txt` file, which contains a string pre-generated by Apple. Apple will later request your server to retrieve the content for verification.
6. Upload your file to your server and place it in the location specified by Apple.

::: note  Note
   - As shown in the figure, the domain verification file is placed in the `.well-known` directory under the web service root directory.
   - The filename must be `apple-developer-merchantid-domain-association.txt`.
   - The domain verification file content must match the string pre-generated by Apple.
   - You can access `https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association.txt` in your browser. If the returned content matches, it indicates successful verification.
:::

7. If verification is successful in the browser, you can click **Verify** to verify.
     

<v4-iImage :src="$withBase('/applePay/merchantIDList.png')" title="Merchant ID list"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/merchantIDDetail-2.png')" title="Merchant ID details"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/addDomain.png')" title="Add domain"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/verifyDomain.png')" title="Verify domain"></v4-iImage>

## 7. Exchange Certificate Information with PingPongPay

Please send the following information to the email address `acq-tech@pingpongx.com`, and CC to `acq-ts@pingpongx.com`

- `.cer` file
- Your domain that has been verified

Additionally, please keep the `.certSigningRequest` file for future use.