支付方式｜管理支付方式域名

适用场景

注意： 使用嵌入式表单但尚未完成域名注册时，Apple Pay 按钮不会显示在结账页面中。此情况不会触发 Subotiz 后台或 API 的错误提示。

下载 Apple Pay 验证文件

1. 进入域名管理页面： 登录 Subotiz 后台，前往 支付 > 支付方式，点击右上角的 支付方式域名。

2. 打开添加域名窗口： 点击 添加域名，打开域名注册窗口。

3. 下载验证文件： 选择当前用于 Apple Pay 的 支付供应商，点击 Apple Pay 验证文件 下载对应的验证文件。

部署 Apple Pay 验证文件

• 保持文件完整： 不得修改验证文件的名称或内容，也不得添加扩展名。
• 确保公开访问： 验证文件必须能够通过 HTTPS 直接访问，无需登录或其他身份验证。
• 避免页面重定向： 验证文件地址不得跳转至其他页面或域名。
• 持续保留文件： Apple 可能定期重新验证域名，因此需要持续保留验证文件。

注册网站域名

1. 填写网站域名： 在 域名 字段中输入实际展示嵌入式表单的网站域名，例如 www.example.com，无需添加 https:// 或网页路径。

2. 选择支付供应商： 确认所选 支付供应商 与下载的 Apple Pay 验证文件一致。

3. 提交域名注册： 点击 保存，系统将立即向对应的支付供应商提交域名注册请求。

注意： 不同域名及子域名需要分别注册，例如 example.com 和 www.example.com。域名添加后不可编辑或删除，提交前请确认域名及支付供应商填写正确。

查看注册结果及重新注册

1. 查看注册结果： 在列表中查看域名、支付供应商、注册结果及更新时间。也可以使用筛选条件查找指定记录。
   

2. 查看失败原因： 注册结果为 失败 时，将鼠标悬停在失败状态上，查看具体原因。

3. 重新提交注册： 修正验证文件或网站配置问题后，点击 重新注册，重新提交域名验证。重新注册时可以修改域名，但不能更换支付供应商。提交后，可在列表中查看最新的注册结果。

域名记录管理规则

• 不可编辑或删除： 域名添加后，记录不可编辑或删除。
• 仅失败记录可重新注册： 只有注册失败的记录可以点击 重新注册；重新注册时可以修改域名，但不能更换支付供应商。
• 随支付供应商删除： 删除支付供应商时，该供应商下的域名记录会一并删除。

更换支付供应商或网站域名

• 更换支付供应商： 在支付方式页面更换 Apple Pay 的支付供应商时，系统不会自动为新供应商注册域名。请先使用新供应商对应的 Apple Pay 验证文件完成域名注册，确认注册成功后，再切换 Apple Pay 的支付供应商。
• 更换网站域名： 嵌入式表单改为在新域名或子域名中展示时，需要为新域名重新完成域名验证。
• 更新网站配置： 服务器、CDN 或访问规则发生变化时，请确认验证文件仍可通过指定地址访问。

常见问题

1. Apple Pay 按钮没有显示在结账页面

   请确认域名注册结果为 成功、验证文件仍可访问，以及当前 Apple Pay 支付供应商与域名注册记录一致。同时检查设备、浏览器、Wallet 支付卡及交易金额是否符合支付供应商要求。
   对于嵌入式表单，请使用运行 iOS 17 或以上版本的 iPhone，或使用 Safari 17 或以上版本的 Mac 进行测试。测试使用的 Apple ID 不能是中国大陆账户。如果使用多层 iframe，还需确保每层 iframe 正确设置 allow="payment" 属性。

2. 验证文件可以访问，但域名注册仍然失败

   请检查 Cloudflare、CDN 或其他安全规则是否阻止 Apple 访问验证文件，并确认验证文件地址没有发生重定向。

3. 域名已被其他商户注册

   如果系统提示域名已被其他商户注册，请联系 Subotiz 客户经理协助核实。

4. 托管式页面是否需要手动注册域名？

   无需手动注册。Subotiz 会自动处理托管式页面所需的 Apple Pay 域名验证，包括支付链接及已绑定的自定义结账域名。首次启用 Apple Pay 或更换默认结账域名时，系统会自动注册，相关记录同样显示在支付方式域名列表中。

最佳实践

• 提前完成域名验证： 在嵌入式表单正式上线前完成注册，并确认注册结果为成功。
• 注册实际结账域名： 确保注册的域名与客户浏览器地址栏显示的域名一致。
• 保持验证文件可访问： 持续保留验证文件，避免后续验证失败。
• 切换供应商前完成验证： 确认新供应商对应的域名注册成功后，再调整 Apple Pay 配置。