Apple Pay 域名验证指南
约 1222 字大约 4 分钟
2025-07-31
1.申请材料
请将申请材料发送给邮箱acq-pmteam@pingpong.com,并抄送到acq-tech@pingpongx.com和 acq-ts@pingpongx.com。
- 商户名称
- 商户 AccId
- 商户 ClientId
- 商户 域名(如果存在多个,请填写多个,注意和accId,clientId保持配对)
域名验证流程
为了在您的网站上启用 Apple Pay 功能,您需要完成 Apple 的域名验证流程,证明您对该域名拥有控制权。以下是详细步骤:
step-1:获取验证文件
- 您将通过邮件收到一个名为
apple-developer-merchantid-domain-association.txt的验证文件。该文件由Apple 预生成,请勿手动修改。 - 此文件包含 Apple 预先生成的唯一字符串,用于验证您对域名的所有权。
- 重要: 请勿修改此文件的内容,任何更改都将导致验证失败。
step-2:部署验证文件
- 在您的 Web 服务器上创建
.well-known目录(如果尚不存在)。 - 将
apple-developer-merchantid-domain-association.txt文件上传到此目录中。 - 确保文件可通过 HTTPS 协议访问。
https://您的域名/.well-known/apple-developer-merchantid-domain-association.txt验证要求
- 文件路径:必须位于
/.well-known/目录下 - 文件名:必须严格为
apple-developer-merchantid-domain-association.txt - 文件内容:必须与 Apple 提供的原始内容完全一致
- 访问协议:必须支持 HTTPS 访问
验证确认
完成部署后,您可以通过以下方式确认验证文件是否正确配置:
- 在浏览器中访问
https://您的域名/.well-known/apple-developer-merchantid-domain-association.txt - 确认返回的内容与您收到的原始文件内容完全一致
- 确认文件能够正常下载且无任何错误
shell 脚本示意
下面通过shell脚本说明域名验证文件的部署过程。
提示
此脚本将检查并部署 Apple Pay 域名验证文件。
脚本只做流程说明和参考,请根据您的实际情况进行修改,请勿直接运行。
#!/bin/bash
# Apple Pay 域名验证文件部署脚本
# 配置变量
DOMAIN="example.com" # 替换为您的域名
WEB_ROOT="/var/www/$DOMAIN" # 替换为您的网站根目录
FILE_PATH="$HOME/Downloads/apple-developer-merchantid-domain-association.txt" # 替换为验证文件的本地路径
# 显示欢迎信息
echo "===== Apple Pay 域名验证文件部署工具 ====="
echo "域名: $DOMAIN"
echo "网站根目录: $WEB_ROOT"
echo "验证文件: $FILE_PATH"
echo "========================================"
# 检查验证文件是否存在
if [ ! -f "$FILE_PATH" ]; then
echo "错误: 验证文件不存在于 $FILE_PATH"
echo "请确保您已下载 Apple 提供的验证文件"
exit 1
fi
# 创建 .well-known 目录
echo "正在创建 .well-known 目录..."
mkdir -p "$WEB_ROOT/.well-known"
if [ $? -ne 0 ]; then
echo "错误: 无法创建 .well-known 目录,请检查权限"
exit 1
fi
# 设置目录权限
echo "设置目录权限..."
chmod 755 "$WEB_ROOT/.well-known"
# 复制验证文件
echo "复制验证文件到目标位置..."
cp "$FILE_PATH" "$WEB_ROOT/.well-known/apple-developer-merchantid-domain-association.txt"
if [ $? -ne 0 ]; then
echo "错误: 无法复制验证文件,请检查权限"
exit 1
fi
# 设置文件权限
echo "设置文件权限..."
chmod 644 "$WEB_ROOT/.well-known/apple-developer-merchantid-domain-association.txt"
# 验证部署
echo "验证文件部署..."
if command -v curl &> /dev/null; then
echo "使用 curl 验证文件访问..."
curl -s -o /dev/null -w "HTTP状态码: %{http_code}\n" "https://$DOMAIN/.well-known/apple-developer-merchantid-domain-association.txt"
echo "验证文件内容(前20个字符):"
curl -s "https://$DOMAIN/.well-known/apple-developer-merchantid-domain-association.txt" | head -c 20
echo "..."
else
echo "curl 未安装,请手动验证文件是否可访问:"
echo "https://$DOMAIN/.well-known/apple-developer-merchantid-domain-association.txt"
fi
echo "========================================"
echo "部署完成!请在浏览器中访问以下地址确认验证文件是否正确部署:"
echo "https://$DOMAIN/.well-known/apple-developer-merchantid-domain-association.txt"
echo ""
echo "如果您能看到文件内容,且内容与 Apple 提供的原始文件完全一致,则表示文件已成功部署。"常见问题
- 404 错误:检查文件路径和名称是否正确
- 内容不匹配:确认文件未被修改,且未出现编码问题
- HTTPS 问题:确保您的域名已正确配置 SSL 证书
完成验证后,Apple 将自动检测您的域名验证状态,验证成功后您将能够在网站上使用 Apple Pay 功能。
注意:域名验证是启用 Apple Pay 的必要步骤,请确保严格按照要求完成配置。
