Apple Pay

Apple Pay Web 通过苹果的生态系统实现安全便捷的支付，支持 Touch ID、Face ID 认证方式。本综合集成指南涵盖企业级和简化实施策略。

快速导航

• 🚀 快速决策指南 - 2 分钟内选择您的集成路径
• 📋 集成模式对比 - 详细功能对比
• 🔍 支付流程 - 完整的端到端支付流程图（含 Mermaid 时序图）
• 🔧 账号配置 - 证书配置和域名验证（两种模式详解）
• 💻 实施指南 - 分步开发流程
• 🛠 故障排除 - 错误处理和调试（含常见问题）

快速决策指南

根据您的组织特征选择 Apple Pay 集成方式：

🎯 企业组织：

• 拥有现有 Apple Developer 账户？ → 商户自有账户模式
• 需要完全证书控制权？ → 商户自有账户模式
• 管理多个域名？ → 商户自有账户模式

🚀 简化集成：

• 没有 Apple Developer 账户？ → Onerway 代理模式
• 希望简化设置？ → Onerway 代理模式
• 偏好集中维护？ → Onerway 代理模式

Apple Pay 集成概览

Apple Pay Web 集成遵循结构化的四阶段工作流程：

集成阶段

阶段 1：账号配置（证书与域名准备）

• 证书配置和管理
• 域名注册和验证
• 安全要求验证

阶段 2：会话初始化（SDK 加载与设备检测）

• 设备支持检测
• 支付配置获取
• UI 准备和按钮显示

阶段 3：支付请求创建（创建 ApplePaySession）

• ApplePaySession 创建
• paymentRequest 构建
• 支付表单显示

阶段 4：支付授权（处理支付事件）

• 商户验证（onvalidatemerchant 事件）
• 支付处理（onpaymentauthorized 事件）
• 交易完成

完整流程视图

查看 支付流程文档 了解完整的端到端支付流程，包括商户自有模式和 Onerway 代理模式的详细时序图。

集成模式对比

方面	商户自有账户模式	Onerway 代理模式
设置复杂度	自主证书管理	简化域名验证
Apple Developer 账户	必需	不需要
证书控制	完全自管理	Onerway 集中管理
域名管理	直接 Apple 注册	Onerway 管理注册
维护	自管理更新	自动维护
最适合	企业组织	中小企业和快速部署

实施工作流程

模式选择流程

🎯 商户自有账户模式

针对拥有 Apple Developer 账户且需要完全控制的企业：

• 前提条件：有效的 Apple Developer 账户和技术团队
• 设置流程：参见详细的账号配置指南
• 证书管理：自管理支付处理和商户身份证书
• 域名控制：直接在 Apple Developer 控制台注册和验证

🚀 Onerway 代理模式

针对无 Apple Developer 要求的简化集成：

• 前提条件：支持 HTTPS 的域名和 A 级 SSL 评级
• 设置流程：向 Onerway 技术团队提交域名
• 证书管理：由 Onerway 基础设施集中管理
• 域名控制：Onerway 管理注册和自动验证

开发流程

1. 环境设置

   • 完成证书配置（参见账号配置）
   • 验证域名要求和 SSL 合规性
   • 配置开发和测试环境

2. 前端集成

   • 实施设备支持检测（参见会话初始化：ApplePaySession.canMakePayments()）
   • 用适当参数创建 ApplePaySession（参见支付请求创建：paymentRequest 配置）
   • 处理用户交互和支付表单显示

3. 后端集成

   • 配置商户验证接口（参见商户验证：处理 onvalidatemerchant 事件）
   • 用 支付授权 实施支付处理（处理 onpaymentauthorized 事件）
   • 设置异步通知的 webhook 处理程序

4. 测试和部署

   • 跨支持的设备和浏览器测试
   • 验证错误处理场景（参见故障排除：常见问题与解决方案）
   • 执行端到端支付流程验证

技术要求

为避免重复，技术要求与配置验证统一收敛至“账号配置”：

• 安全要求 — 见账号配置
• 常见问题 — 见Apple Pay 故障排查