---
title: Apple Pay 商户证书配置
createTime: '2025/06/24 16:01:54'
permalink: /notes/zh/paymentMethods/ApplePay/merchantCertificateConfiguration/
description: >-
  文档介绍了如何为网站配置Apple Pay商户证书，以实现非托管方式的Apple Pay Web集成。适用于希望通过Safari浏览器提供Apple
  Pay支付选项的全球在线商家。内容涵盖从注册苹果开发者账号到完成域名验证的全过程，包括申请证书、创建商家标识符及与PingPongPay交换证书信息等
---


## 概述

Apple Pay 的网页集成允许用户在网页上通过 Safari 浏览器直接使用 Apple Pay 完成支付。为了在你的网站上实现 Apple Pay，你需要进行一些配置和开发工作，包括生成必要的秘钥、创建支付请求、处理支付授权等。下面是一个基本的步骤指南，
说明了Non-hosted方式集成**Apple Pay Web** 的流程。与Apple Pay Hosted方式相比，Non-hosted方式需要开发者自行实现与Apple Pay UI的交互流程。

## 1.注册Apple开发者账号

首先，你需要拥有一个有效的苹果开发者账号，并且加入 Apple Developer Program。这是使用 Apple Pay Web API 的先决条件。

## 2.申请证书

请将`申请材料`发送给邮箱acq-tech@pingpongx.com，并抄送到acq-ts@pingpongx.com

1. 商户名称
2. 商户 AccId
3. 商户 ClientId

PingPong 收单团队收到申请邮件，完成所需的配置后，会将证书以邮件附件的形式回复商户。

## 3.在Apple开发者平台上创建一个商家标识
在 Apple 开发者平台上创建商家标识符（Merchant ID）是集成 Apple Pay 的关键步骤之一。商家标识符用于标识您的业务，并确保支付过程的安全。以下是创建 Merchant ID 的详细步骤。如果您已有商家标识符，可以跳过这个步骤。

###  登录 Apple 开发者账号

1. 打开 [Apple Developer](https://developer.apple.com/) 平台。
2. 登录您的 Apple 开发者账户。
3. 进入 Apple Developer Center。
4. 在 Apple Developer 选择“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 选择merchant IDs" ></v4-iImage>
<v4-iImage :src="$withBase('/applePay/merchantIds.png')" title="4-2 商户标识列表" ></v4-iImage>
<v4-iImage :src="$withBase('/applePay/Certificates.png')" title="4-3 Certificates, Identifiers & Profiles"></v4-iImage>

### 输入商户标识符基本信息

1. 输入一个描述性的名称，这将帮助您在项目中标识不同的商家标识。例如：“My Online Store Payment”。
2. 输入 Merchant ID 的标识符，通常以 merchant. 开头，例如 merchant.com.example.onlinestore。这个标识符需要是唯一的，并且通常与您的域名相关联以保持一致性。<v4-iImage :src="$withBase('/applePay/Certificates.png')" title="4-3 Certificates, Identifiers & Profiles"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/onlineStore.png')" title="输入商户标识的基本信息"></v4-iImage>

至此，您已经成功创建了商家标识符。

## 4.为商户标识符添加证书
1. 回到商户表示列表，点击当前创建的商户标识符，进入详情页面。
2. 在详情页点击 **Apple Pay Payment Processing Certificate** 下的Create Certificate。
3. 点击 **chooseFile** 
4. 上传前面步骤邮件附件中的 **certSigningRequest**类型文件

<v4-iImage :src="$withBase('/applePay/onlineStore.png')" title="选择Merchant ID"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/processingCertificate.png')" title="选择Merchant ID"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/chooseFile.png')" title="选择文件"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/certSigningRequestUpload.png')" title="上传certSigningRequest类型的文件"></v4-iImage>

## 5.下载您的证书
1. 点击 **Download** 下载证书。
   <v4-iImage :src="$withBase('/applePay/downloadCert.png')" title="下载证书"></v4-iImage>
2. 下载完成之后，您可以得到一个`.cer`类型的文件
<v4-iImage :src="$withBase('/applePay/cer.png')" title="下载成功"></v4-iImage>

## 6.商户域名验证

::: note  提示
   域名验证仅限于 Apple Pay Web 的集成方式。如果Native SDK 集成方式，则不需要进行域名验证。
:::

1. 进入商户标识列表，点击当前创建的商户标识符，进入详情页面。
2. 在详情页将页面往下滚动
3. 点击 **Add Domain**
4. 填写您的域名
5. 点击**下载**按钮,您将得到一个`apple-developer-merchantid-domain-association.txt`文件，内容是Apple预先生成的一个字符串，稍后Apple将会请求您的服务器获取内容进行验证。
6. 将您的文件上传到您的服务器，放入Apple指定的位置。

::: note  提示
   - 如图所示，域名验证文件放在Web服务的根目录下`.well-known`的目录中。
   - 文件名必须为`apple-developer-merchantid-domain-association.txt`。
   - 域名验证文件内容必须与Apple预先生成的字符串一致。
   - 您可以在l浏览器中访问`https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association.txt`，如果返回内容一致，则表示验证成功。
:::

7. 如果在浏览器中验证成功，可以点击**Verify**进行验证。
     

<v4-iImage :src="$withBase('/applePay/merchantIDList.png')" title="商户标识列表"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/merchantIDDetail-2.png')" title="商户标识详情"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/addDomain.png')" title="新增域名"></v4-iImage>
<v4-iImage :src="$withBase('/applePay/verifyDomain.png')" title="验证域名"></v4-iImage>

## 7.与PingPongPay交换证书信息

请将以下信息发送给邮箱`acq-tech@pingpongx.com`，并抄送到`acq-ts@pingpongx.com`

- `.cer`文件
- 您已验证通过的domain

另外，`.certSigningRequest`文件请您自行留存，后续可能会使用