用途:在 iOS 应用中集成 Apple Pay 支付和 Apple Wallet 凭证,适用于实物商品、线下服务、捐赠与周期订阅等收款场景,目标为 Swift 6.3 / iOS 26+。
主要能力:检测设备是否支持 Apple Pay;使用官方支付按钮;构建 PKPaymentRequest 汇总商品与总价;通过 PKPaymentAuthorizationController 授权支付并获取令牌;创建 .pkpass 并添加到 Wallet。
必要用法:需在 Xcode 开启 Apple Pay 能力并配置 Merchant ID(如 merchant.com.example)。渲染结账控件前应先调用 canMakePayments(usingNetworks:capabilities:) 校验,返回 true 时按 HIG 须将 Apple Pay 作为主要支付方式。按钮必须使用官方 PayWithApplePayButton(SwiftUI)或 PKPaymentButton(UIKit),不得自绘。支付请求需设置 merchantIdentifier、countryCode、currencyCode、supportedNetworks、merchantCapabilities 与 paymentSummaryItems;最后一项必须是总额且标签为商家名称。授权时在委托中把 payment.token.paymentData 发送至支付网关(如 Stripe、Adyen),并在关闭面板前调用 completion 处理器。Wallet 侧用 PKPass(data:) 创建凭证,通过 PKPassLibrary 判断是否已存在,再用 PKAddPassesViewController 呈现添加界面。
限制:单个 PKPaymentRequest 最多只能指定一种可选高级请求类型(周期、自动充值、延迟、Apple Pay Later 或多令牌),需要多种模式时须拆分多个请求。国家与货币须使用匹配商户账户的 ISO 3166 与 ISO 4217 代码,不得硬编码。禁止自绘 Apple Pay 标志,否则违反 App Store 指南与 HIG。所有代码路径都必须调用授权完成回调。
资料未提及价格、收费、具体平台支持范围或实际效果,暂未提供。