钱包与 Apple Pay 的新功能

钱包与 Apple Pay 的新功能

探索“钱包”和 Apple Pay 的最新更新。我们将介绍如何在您的 App 和网站中为“钱包”中的订单提供支持，并借助 Identity Verification API 安全验证用户的年龄和身份。我们还将探索 SwiftUI 的 PassKit 支持，讨论您可以如何利用自动付款优化您的 Apple Pay 体验。

资源
相关视频

WWDC23
- “钱包”和 Apple Pay 的新功能
下载

♪ 柔和乐器演奏的嘻哈音乐 ♪ ♪ Lais Minchillo：嗨我叫 Lais David Silver：我是 David 我们将为您介绍今年钱包和 Apple Pay 的新功能我们在 2014 年推出了 Apple Pay 为在实体店在线商店和 App 内进行快速安全私密的支付设定了新的基准从那时起我们在全球范围内推广了 Apple Pay Apple Pay 现已在 72 个国家和地区提供服务每天处理超过一百万笔交易今天我们将为钱包和 Apple Pay 引入令人兴奋的新功能和 API Lais 会为您具体介绍 Lais ：谢谢您 David 让我们来看看这场讲座的主要议程首先我们将聊一聊快速更新我们增加了在单笔交易中向多个商户支付的支持我们还大大改善了包括订阅服务在内的自动支付的支持通过订单跟踪您可以增强客户的购后体验最后 David 将聊一聊用钱包中的 ID 进行身份验证我们要先分享一些令人振奋的更新内容 iPhone 上的 Tap to Pay 于今年早些时候发布并在美国 iOS 15.4 平台上发布 iPhone 上的 Tap to Pay 提供了一种安全私密便捷的非接触式支付方式您可以轻松地将它集成到您的 App 中无缝且安全地接收非接触式支付这种支付方式包括 Apple Pay 非接触式信用卡和借记卡和其他数字钱包只需在 iPhone 上轻触一下交易就能完成无需额外的硬件或支付终端同时在 macOS 13 中我们重新设计了 Apple Pay 的体验去年 iOS 的付款表单重新设计取得了巨大的成功今年我们将为 macOS 引入类似的体验我们使用了 SwiftUI 来重新设计从而让我们为 macOS 与 iOS 同时引入了新功能我们今天介绍的所有 Apple Pay 功能在 Mac 上也支持我们将引入新的 SwiftUI API 在您的 SwiftUI App 中集成 “添加到 Apple 钱包” 或 “Apple Pay” 按钮会更容易这些新的 API 将大大减少您需要编写的代码量让我们看看如何添加按钮以提示用户添加航空通票首先创建航空通票您应该处理好未成功加载的情况例如航空通票数据不正确或未正确签名就可能发生这种情况接下来使用通票数组调用 AddPassToWalletButton 在这个例子中只有一个元素的数组但是同一个按钮上可以有多个通票结果作为 Bool 传入您可以根据用户是否添加了通票来保存记录或触发 App 中的其他操作在此示例中我将它保存到状态变量这样就完成了您还可以在一组最小值中自定义按钮的大小和样式这是默认尺寸宽 250 高 50 您也可以把按钮变宽
或变高
以上就是如何在 SwiftUI 中添加 “添加到 Apple 钱包”按钮接下来看看如何添加 “使用 Apple Pay 支付”按钮首先使用 PKPaymentRequest 类创建一个支付请求在上面设置您通常的配置然后创建一个 authorizationChange 方法这两个部分完成后就可以添加代码来显示按钮添加对 PayWithApplePayButton 的调用传入标签 paymentRequest 对象和 authorizationChange 方法如果要处理前设备不支持 Apple Pay 的情况通过当前设备您可以传入回退视图就像“添加航空通票”按钮一样您同样可以自定义其大小和样式总共有 17 个不同的标签因此您能够自定义支付按钮以与您的用例保持一致这些适用于 iOS iPadOS macOS 和 watchOS 接下来再来看看多商户支付在 iOS 16 中我们引入了在同一笔交易中为各个不同商户单独请求交易令牌的功能这种功能对于在线市场旅行预订和票务服务等很有帮助我们来详细看看这个例子想象一下 Allison 正在计划一次旅行她访问一家旅行社网站网站方便地为她提供了客户需要预订的一切机票酒店住宿和汽车租赁 Allison 总共只需要支付 500 美元 Allison 向旅行社网站提供了她完整的信用卡信息现在您可能会认为旅行社将从 Allison 的信用卡扣除 500 美元然后支付给其他相关公司但通常情况下旅行社只需简单地将信用卡信息传递给每家公司让各家公司进行各自的收费这行么做得通但是把她的信用卡信息泄露出去对 Allison 的隐私和安全不利现在有了新的多商户支付 API 就可以为交易中涉及的每个商户请求支付令牌有了支付令牌各家公司可以分别向 Allison 收取她授权的相关金额 Allison 现在可以预订并支付旅行费用同时也能享受 Apple Pay 提供的隐私和安全优势付款表已经更新能够向客户显示交易中涉及的子商户明细客户可以点击“总金额” 前往到付款摘要摘要中客户可以看到涉及到交易的所有商户的分类以及每个商户授权的金额现在让我们看看如何在应用中添加多商户支付首先使用 PKPaymentRequest 类创建一个支付请求在上面设置您通常的配置然后为您的付款添加汇总项目包括总额接下来使用新的 PKPaymentTokenContext 类为交易中涉及的每个额外商户创建一个支付令牌 context 提供每个商户的详细信息以及为每个商户授权的金额最后在支付请求上设置支付令牌 contexts 请记住所有支付令牌 context 的金额总和必须小于或等于支付请求本身的总金额此外在 App 中为商家请求支付令牌时您应该始终为同一个商户使用相同的外部标识符要在网页上采用多商户支付的 Apple Pay 请查看 Apple Pay JS API 文档接下来看一看我们对自动支付的改进在 iOS 16 中我们引入了用户可以通过钱包应用查看和管理他们设置的自动向商家支付的功能在这个版本中我们支持两种类型的自动支付定期自动扣除其中包括订阅分期付款或定期计费和自动充值支付例如商店卡余额充值我们将引入新的 API 以让您在提出支付请求时向客户请求设置自动支付我们还推出了 Apple Pay 商户令牌这是一种与客户的 Apple ID 绑定的新型支付令牌可以帮助您在现有基础上更可靠地向客户收费我们来详细看一下 Apple Pay 商户令牌看看它们是如何发挥作用的想象一下 Julie 正在用 iPhone 上的 Apple Pay 支付读书俱乐部的会员费读书俱乐部提出付款请求当 Julie 授权付款时读书俱乐部收到付款令牌每个月俱乐部都可以用付款令牌向 Julie 收取会员资格费用此付款令牌链接到 Julie 的设备用于授权支付但如果 Julie 买了一台新的 iPhone 会怎样？有了新的自动支付功能如果 Julie 的支付网络支持俱乐部会将收到 Apple Pay 商户令牌此支付令牌与 Julie 的 Apple ID 绑定而不是与她的 iPhone 绑定这样就能更好地保证正在进行的授权也就是说如果 Julie 升级了 iPhone 或重置了她当前的手机读书俱乐部依旧能可靠地向 Julie 收取每月的会员资格费用如果您接受 Apple Pay 进行这些类型的付款采用自动支付是一个好主意能够确保您可以持续可靠地向客户收费且能避免服务中的任何中断我们在这个版本中支持的第一种自动支付方式是定期自动扣除定期自动扣除的金额可以是固定或可变的按定期计划收取如每周每月或每年收费这些付款可以在特定日期结束也可以一直持续到取消我们也支持试用期或优惠期定期自动扣除可以完美用于订阅分期付款计划和定期计费让我们看看如何在 App 中用自动支付设置定期自动扣除首先使用 PKRecurringPaymentSummaryItem 类指定自动扣除的金额和持续时间对于定期自动扣除您可以同时指定常规计费周期也可以指定优惠期或试用期您可以使用 startDate 和 endDate 属性来指示试用期何时结束常规计费周期何时开始接下来使用新的 PKRecurringPaymentRequest 类创建一个定期自动扣除请求提供付款说明正常计费周期以及前往网页的管理 URL 客户可以在这个页面上更新或删除定期自动扣除服务您还可以选择提供试用计费期以及计费协议文本以帮助向客户解释付款条款最后您可以选择提供令牌通知 URL 如果发布了令牌您的服务器可以接收关于 Apple Pay 商家支付令牌的生命周期例如如果卡颁发者或用户删除令牌您可以收到通知有关商户令牌生命周期通知的更多信息请参阅 Apple Pay 商户令牌管理 API 文档最后在 paymentRequest 对象上设置定期自动扣除请求关于汇总项目简要说明一下您的定期自动扣除不会自动添加到付款请求的汇总项目上因此请务必将定期自动扣除的项添加到汇总项数组中支付请求的总额应该是向客户收取的第一笔金额所以在这个例子中总金额设置为显示试用期的金额因为这是向客户收取的第一笔金额付款表单将向客户显示定期自动扣除的详细信息他们可以点击“账单详情”部分进一步阅读接下来是我们在这个版本中支持的第二种自动支付方式自动充值支付通过这种付款方式每当余额低于一定阈值金额时就会自动为余额充值自动充值支付非常适合商店卡充值和预付余额之类的付款要请求设置自动充值支付首先使用新的 PKAutomaticReloadPaymentSummaryItem 类指定充值和阈值金额接下来使用新的 PKAutomaticReloadPaymentRequest 类创建一个自动充值支付请求传入支付描述账单和管理 URL 和前文定期自动扣除部分一样您还可以选择提供计费协议文本和一个令牌通知 URL 最后在支付请求对象上设置自动充值支付请求同样请确保在汇总项目中包含自动充值支付项并适当设置支付请求的总额关于在网络页面上使用 Apple Pay 自动支付查看 Apple Pay JS API 文档这是您客户的付款表单自动充值支付是这样显示的最后当您在应用中采用自动支付时您需要记住以下几点以便为客户提供最佳体验记住要包括自动付款的汇总项目因为这些项目不会自动添加付款请求的总金额应该是将向客户收取的第一笔金额计费协议文本应当简短付款单将仅显示前 500 个字符计费协议文本不应当取代您的正常账单和法律协议是否遵守当地的定期自动扣除法规取决于您的主张如果您要向客户展示法律协议请先向客户展示法律协议再展示付款单在单笔交易中您只能请求一种类型的自动付款此外自动支付不能用于多商户支付最后如果您希望接收 Apple Pay 商户令牌的生命周期通知请务必提供令牌通知 URL 并在服务器上采用 Apple Pay 商户令牌管理 API 我们认为您会喜欢这些新的 API 也会享受 Apple Pay 商户令牌带来的好处以上是我们的一些合作伙伴他们也将要支持自动支付 Apple Pay 商户令牌将得到 American Express Discover Mastercard 和 Visa 的支持未来还将支持其他支付网络我们也将引入订单跟踪以提升购后体验 iOS 16 新增了订单跟踪功能以便用户跟踪与商家下的订单现在钱包能提供直观的概览展示正在进行中的订单最近完成的订单和历史订单现在展示的是正在进行中的烘焙食品订单这个订单仍在处理中稍后再谈这个话题现在我想在 Pet Avenue 给我的猫买一些玩具和配饰我选择使用 Apple Pay 结账在我授权付款后不久我收到一条通知在钱包中跟踪我的订单点击该通知可以看到订单的详细信息我可以检查当前状态可以看到订单状态包括物流运输和跟踪信息以及我订购的订单项列表接下来我有多种联系方式可以联系 Pet Avenue 检查付款信息然后返回 Pet Avenue App 好了想象一下 Pet Avenue 处理新订单的速度非常快他们刚刚运送了我的物品 Pet Avenue 发货后他们已更新了可用信息我可以看到状态更改为“在路上” 预计到货日期为 6 月 10 日页面还包含一条自定义消息以及货件的跟踪信息哦还记得我的烘焙食品吗？我刚收到通知他们可以取货了让我们来看一下我订购了自提的烘焙食品我已经可以取货了太好了 Bake My Breath Away 提供了我的取货窗口取货说明和取货时需出示的条形码我们已经知道了订单跟踪与 Apple Pay 无缝衔接让我们看看如何将订单跟踪集成到客户体验中要开始订单跟踪首先您必须在开发者帐户中创建一个 Order Type ID Order Type ID 将您的组织标识为提供订单信息的实体您可以注册多个 Order Type ID 例如代表多个商家提供订单信息然后创建一个 Order Type ID 证书您将使用证书来构建订单包和更新订单订单以订单包的形式分发订单包包括订单的所有元数据和信息订单包可以代表广泛的场景包括运输取货和多重履行订单订单包也包括图像比如您的徽标和行式项目图片您还可以添加本地化以支持不同范围的客户每个订单包都必须经过加密签名以验证订单包来源一切就绪后订单包被压缩以进行分发请查看这个讲座附带的示例订单包有关订单包的更多信息请参阅开发人员文档将订单添加到钱包可与 Apple Pay 无缝协作当您的客户授权付款时您的应用或网页将接收到支付信息然后将支付信息发送到服务器进行处理如果支付信息处理成功您的服务器会创建一个订单和一些元数据然后服务器返回订单细节到 App 或网页以显示结果订单详细信息使设备能够以异步方式从服务器请求订单然后服务器将订单包返回给设备当服务器创建订单时分配一个 Order ID 这个 ID 在 Order Type ID 命名空间中不可与其他重复您的服务器还必须生成安全的身份验证令牌身份验证令牌是共享密钥是订单详细信息的一部分当设备请求订单时将使用令牌来验证这个设备让我们来看一个返回支付授权结果的例子当您的客户授权付款时 App 将付款信息发送到服务器并要求服务器创建一个订单请检查服务器结果是否表示成功并处理服务器返回的任何错误如果服务器结果确实表明成功则使用适当的授权结果完成付款要返回包含订单详细信息的支付授权结果首先从服务器结果中提取订单详细信息然后创建一个 PKPaymentOrderDetails 对象这个对象带有 Order Type ID 或 Order ID 到服务器的 URL 和身份验证令牌将 PKPaymentOrderDetails 对象分配到 PKPaymentAuthorizationResult 上的新 orderDetails 属性这样就完成了您也可以在网页上使用订单详细信息完成付款和刚才一样从服务器结果中提取订单详细信息然后在完成支付的数据中列入订单细节要更新订单创建一个指示支持自动更新的订单包添加订单后设备将注册订单的更新您的服务器必须存储有关注册的信息以后当服务器更新订单时使用注册信息通知已注册更新订单的设备当设备收到推送通知时设备将再次向您的服务器请求订单然后服务器将更新后的订单包返回给设备只有您和您的客户才可知道客户订购了什么我们在设计订单跟踪时考虑到了客户隐私订单信息直接在设备和服务器之间交换订单通过 iCloud 同步时内容是端到端加密的请遵循这些做法以为客户提供最好的体验将您的应用与您提供的订单关联起来如果您的应用提供通知并已安装应用您可以禁用订单跟踪通知这么做可以防止重复通知利用您对客户偏好的了解只提供相关的本地化内容请注意订单包的大小尽量减小订单包以降低昂贵的网络成本当您更新订单时及时通知已注册更新的设备钱包中的订单应与订单的实际状态相匹配还要确保检查 HIG 以进行订单跟踪平台可以使订单跟踪的集成更加简单我们很高兴地宣布 Shopify 及 Narvar 和 Route 将在今秋支持订单跟踪请留意未来几个月更多支持订单跟踪的平台订单跟踪是增强客户购后体验的好方法通过自动更新您的客户将能及时了解他们订单的最新状态我们相信您的客户会喜欢这种体验我们期待能尽快向您订购产品接下来 David 将继续讲座 David：谢谢 Lais 我非常高兴能与大家聊一聊我们在 iOS 16 的钱包中添加了 ID 的新功能今年早些时候我们在 iOS 15.4 中推出了钱包中的 ID 美国境内支持这个功能的各州用户能将驾照或身份证添加到钱包钱包中的 ID 是由发行实体身份证的机构发行在美国就是各州的机动车管理局或同等机构在 iOS 16 中我们增加了一个新的 API 允许 App 和 App Clips 从钱包中的 ID 请求信息以验证用户的年龄或身份您的 App 将请求信息用户会审查并批准请求然后 App 会将响应发送到服务器进行解密和验证您可以从用户 ID 请求许多数据元素包括他们的姓名、地址出生日期、照片也叫肖像颁发身份证件的颁发机构身份证号码和有效期以及如果有的话用户的的身份证件授予的驾驶特权 ID 的常见的用例是验证用户的年龄查看实体身份证能够看到用户出生日期但要验证用户年龄具体出生日期是不必要的如果要验证我的年龄实际上不需要知道我出生的确切日期或年份甚至不需要知道我多少岁只需要知道我是否达到年龄标准使用钱包中的 ID 您可以直接验证年龄您的应用可以请求布尔数据元素表明用户是否超过一定年龄这种验证年龄的方式比查看具体出生日期更保护隐私当您的应用调用 API 时用户会收到一张表单显示您在请求什么信息表单还会显示您是否打算存储这些信息以及您打算存储多长时间这样用户可以更明智地决定是否与您的 App 共享信息用户使用 Face ID 或 Touch ID 明确批准之前设备不会共享信息您收到的响应仅包含您请求的元素其他身份验证机制比如扫描实体身份证会共享身份证上的所有信息把共享信息限制在您需要的范围内钱包中的 ID 更能保护用户的隐私并减少您需要在服务器上储存的敏感信息数量响应由 ID 的颁发机构签名这样就可以直接验证响应中的信息是否真实请注意 ID 是由颁发机构创建但在调用 API 时颁发机构并不参与颁发机构不知道用户何时共享信息也不知道用户向谁共享了信息要使用 API 您需要通过开发者帐户请求授权然后您需要设置商户 ID 和加密证书这个过程与使用 Apple Pay 设置应用内支付非常相似稍后我们将详细讨论如何使用 ID 和证书现在我们来看看验证流程概括地说包括四个步骤首先您的应用将调用 PassKit 框架中的 API 并指定您正在请求的信息然后系统将显示一个表单提示用户批准请求用户通过请求后您的 App 将收到一个加密的响应然后应用会将该响应传递给服务器进行解密和验证首先来看看如何使用 PassKit 中的 API 如果您的应用使用 SwiftUI 您应该使用 VerifyIdentityWithWalletButton SwiftUI 视图这里会显示一个按钮按下时触发身份验证流程就像“使用 Apple Pay 支付” 和“添加航空通票到钱包”按钮一样 “使用钱包验证身份”按钮提供了一个熟悉的一致的使用 API 的 App 体验有四种不同的标签供您选择以显示适合您的用例的按钮按钮会根据可用空间自动切换单行和多行的按钮创建按钮时您需要指定一个 PKIdentityRequest 对象这个对象描述您希望请求的信息以及应该如何返回它让我们来看看如何创建按钮首先创建一个 PKIdentityDriversLicenseDescriptor 它描述了您需要的数据元素使用 addElements 方法指定您想请求的元素以及您是否打算存储元素您可以多次调用 addElements 方法指定具有不同的存储意图的不同的元素集在这个例子中我调用了两次首先添加一个 “年龄至少 18 岁”元素这个元素不会被存储然后再次调用 addElements 方法来请求用户的名字姓氏和肖像所有元素都可以存储长达 30 天然后描述符进入 PKIdentityRequest 下一步是指定要使用的商户标识符商户标识符表示 API 响应将加密到的加密证书您将通过您的开发者帐户配置商家标识符及其加密证书最后您需要指定一个随机数它将绑定到从 API 接收的响应这是一项重要的安全功能用于防止响应重放并将其绑定到特定的用户会话具体如何管理随机数取决于您自己的安全需求通常它来自您的服务器因为稍后您的服务器将负责执行随机数是有效的设置所有这些属性后 PKIdentityRequest 就准备好了现在我们再回到按钮部分如果身份验证可用这个按钮将显示在您的 App 中点击它将启动与您的请求的身份验证流程如果身份验证不可用则将显示您指定的回退视图例如如果这款 iPhone 上的钱包中没有 ID 就会发生这种情况您可以使用回退视图提供其他方式来验证身份我们假设身份验证是可用的用户点击按钮系统会显示一张表单上面有您的请求其中包括您请求的元素以及您存储元素的意图用户可以通过 Face ID 或 Touch ID 批准请求或不批准并关闭表单然后您的代码将收到一个结果对象其中包含请求的结果如果请求受到批准您将收到成功结果结果带有一个包含加密响应的 PKIdentityDocument 对象 App 将发送给服务器进行解密和验证如果请求不成功您会收到一个失败的结果最常见的失败原因是请求未获批准在这种情况下您将收到“取消”的错误以上就是 VerifyIdentityWithWalletButton SwiftUI 版本的 API 您可以用它来显示按钮用按钮启动身份验证流程并请求钱包中的 ID 信息如果您的应用中没有使用 SwiftUI 您还可以使用 PKIdentityButton 和 PKIdentityAuthorizationController 类来完成相同的流程好了现在您请求到了信息用户批准了请求 App 向服务器发送了加密的响应现在我们来看看服务器需要做什么来解密和验证响应我只会大致地略微聊聊这个话题那么请查看开发人员文档以获取更多详细信息响应格式使用多个国际标准所以我强烈建议您也熟悉这些标准您将收到的响应数据位于 CBOR 编码的加密信封中 CBOR RFC 8949 中定义的数据格式类似于 JSON 但使用二进制数据对对象进行编码加密信封包含解密过程所需的元数据连同加密数据本身数据使用 HPKE 加密 HPKE 是 RFC 9180 中定义的加密方案您的服务器将使用私钥解密数据解密后您将获得一个 mdoc 响应对象 mdoc 响应的定义在 ISO 18013 第 5 部分这是移动驾驶执照和州 ID 的 ISO 标准 mdoc 响应对象包含您请求的数据元素还包括许多服务器需要验证的安全特性以确保响应是真实的请注意您的服务器将执行解密和验证服务器本身 Apple 服务器和发行机构的服务器都不会参与其中在讨论解密和响应验证之前我们需要讨论会话记录这是一个 CBOR 结构它将响应负载绑定到来自特定 App 的特定请求您的服务器将需要构建此结构并在解密和验证期间使用它会话记录包含您之前在 PKIdentityRequest 中使用的同一个随机数和商户 ID 以及您的开发团队的团队 ID 以及您的加密证书的公钥的 SHA256 散列在构建会话记录时服务器应该检查您正在使用的输入都是有效的这意味着随机数不应该已经被使用而应该被绑定到当前用户其他值应该与您的开发者帐户上所期望的值相匹配现在我们来聊聊解密加密数据您需要刚刚创建的会话记录以及来自加密信封的元数据您还需要个人密钥这是与您之前在开发者帐户中设置的证书相对应的个人密钥为保护用户信息的机密性您需要确保个人密钥保持私有安全存储在您的服务器上并且永远不要储存在 App 中如果您的个人密钥泄露请立即撤销开发者帐户中的证书解密加密数据后您将收到一个 mdoc 响应对象包含两个加密签名以及您要求的数据元素您需要检查 mdoc 响应中的两个签名然后才能使用它的数据元素首先您需要检查颁发者签名这是用户 ID 颁发机构的签名通过检查这个签名您正在验证响应中的数据来自真正的发证机关并且没有被篡改您应该检查签名不仅是有效的而且签名是由您信任的颁发者证书签署的查看文档了解关于钱包中 ID 使用的颁发者证书的更多详细信息接下来您需要验证设备签名这是由用户 iPhone 的 Secure Element 中的密钥创建的签名这说明您收到的回复来自发卡机构最初发给您 ID 的那台 iPhone 在这里您需要再次使用会话记录以及颁发者签名所涵盖的一些信息最后可以使用请求的数据元素了在没有首先验证颁发者和设备签名之前永远不要使用这些元素否则您不知道您收到的数据是否真实完成所有这些步骤后就完成了您的应用已经请求了信息并且您的服务器已经解密并验证了响应您可能想知道如果在钱包中没有 ID 如何测试您的设置我们提供了一些机制来帮助您首先您可以在 iOS 模拟器中测试模拟器中的 API 将返回一个模拟响应测试的响应类似于真实的响应但没有真正的签名同样您可以使用测试配置文件在真正的 iPhone 上接收模拟响应哪怕 iPhone 上的钱包中没有 ID 也可以做到关于如何执行这项操作的更多详细信息请参阅文档请注意您的服务器不应该将像处理真实响应一样处理模拟响应要帮助您设置服务器文档中还有一个示例响应以及解密和验证所需要的一切这就是在 iOS 16 中使用钱包中 ID 进行身份验证的方式我们讨论了如何在您的应用中使用 API 如何处理服务器上的响应以及如何测试您的设置 Lais：今年我们为钱包和 Apple Pay 推出了很多很棒的新功能新功能包括多商户支付改进了对自动支付的支持订单跟踪和身份验证请查看开发者文档以了解更多信息 David：感谢您的收看希望您在 WWDC 体验愉快 ♪

@State var addedToWallet: Bool

@ViewBuilder private var airlineButton: some View {
    if let pass = createAirlinePass() {
        AddPassToWalletButton([pass]) { added in
            addedToWallet = added
        }
        .frame(width: 250, height: 50)
        .addPassToWalletButtonStyle(.blackOutline)
    } else {
        // Fallback
    }
}

3:40 - PayWithApplePayButton

// Create a payment request
let paymentRequest = PKPaymentRequest()
// ...

// Create a payment authorization change method
func authorizationChange(phase: PayWithApplePayButtonPaymentAuthorizationPhase) { ... }

PayWithApplePayButton(
    .plain,
    request: paymentRequest,
    onPaymentAuthorizationChange: authorizationChange
) {
    // Fallback
}
.frame(width: 250, height: 50)
.payWithApplePayButtonStyle(.automatic)

6:34 - Multi-merchant payments

// Create a payment request
let paymentRequest = PKPaymentRequest()
// ...

// Set total amount
paymentRequest.paymentSummaryItems = [
    PKPaymentSummaryItem(label: "Total", amount: 500)
]

// Create a multi token context for each additional merchant in the payment
let multiTokenContexts = [
    PKPaymentTokenContext(
        merchantIdentifier: "com.example.air-travel",
        externalIdentifier: "com.example.air-travel",
        merchantName: "Air Travel",
        merchantDomain: "air-travel.example.com",
        amount: 150
    ),
    PKPaymentTokenContext(
        merchantIdentifier: "com.example.hotel",
        externalIdentifier: "com.example.hotel",
        merchantName: "Hotel",
        merchantDomain: "hotel.example.com",
        amount: 300
    ),
    PKPaymentTokenContext(
        merchantIdentifier: "com.example.car-rental",
        externalIdentifier: "com.example.car-rental",
        merchantName: "Car Rental",
        merchantDomain: "car-rental.example.com",
        amount: 50
    )
]
paymentRequest.multiTokenContexts = multiTokenContexts

10:14 - Automatic Payments - Recurring payment request

// Specify the amount and billing periods
let regularBilling = PKRecurringPaymentSummaryItem(label: "Membership", amount: 20)

let trialBilling = PKRecurringPaymentSummaryItem(label: "Trial Membership", amount: 10)

let trialEndDate = Calendar.current.date(byAdding: .month, value: 1, to: Date.now)
trialBilling.endDate = trialEndDate
regularBilling.startDate = trialEndDate

// Create a recurring payment request
let recurringPaymentRequest = PKRecurringPaymentRequest(
    paymentDescription: "Book Club Membership",
    regularBilling: regularBilling,
    managementURL: URL(string: "https://www.example.com/managementURL")!
)
recurringPaymentRequest.trialBilling = trialBilling

recurringPaymentRequest.billingAgreement = """
50% off for the first month. You will be charged $20 every month after that until you cancel. \ You may cancel at any time to avoid future charges. To cancel, go to your Account and click \ Cancel Membership.
"""

recurringPaymentRequest.tokenNotificationURL = URL(
    string: "https://www.example.com/tokenNotificationURL"
)!

// Update the payment request
let paymentRequest = PKPaymentRequest()
// ...
paymentRequest.recurringPaymentRequest = recurringPaymentRequest

// Include in the summary items
let total = PKRecurringPaymentSummaryItem(label: "Book Club", amount: 10)
total.endDate = trialEndDate
paymentRequest.paymentSummaryItems = [trialBilling, regularBilling, total]

12:39 - Automatic Payments - Automatic reload payment request

// Specify the reload amount and threshold
let automaticReloadBilling = PKAutomaticReloadPaymentSummaryItem(
    label: "Coffee Shop Reload",
    amount: 25
)
reloadItem.thresholdAmount = 5

// Create an automatic reload payment request
let automaticReloadPaymentRequest = PKAutomaticReloadPaymentRequest(
    paymentDescription: "Coffee Shop",
    automaticReloadBilling: automaticReloadBilling,
    managementURL: URL(string: "https://www.example.com/managementURL")!
)

automaticReloadPaymentRequest.billingAgreement = """
Coffee Shop will add $25.00 to your card immediately, and will automatically reload your \
card with $25.00 whenever the balance falls below $5.00. You may cancel at any time to avoid \ future charges. To cancel, go to your Account and click Cancel Reload.
"""

automaticReloadPaymentRequest.tokenNotificationURL = URL(
    string: "https://www.example.com/tokenNotificationURL"
)!

// Update the payment request
let paymentRequest = PKPaymentRequest()
// ...
paymentRequest.automaticReloadPaymentRequest = automaticReloadPaymentRequest

// Include in the summary items
let total = PKAutomaticReloadPaymentSummaryItem(
    label: "Coffee Shop",
    amount: 25
)
total.thresholdAmount = 5
paymentRequest.paymentSummaryItems = [total]

19:17 - Order Tracking (swift)

func onAuthorizationChange(phase: PayWithApplePayButtonPaymentAuthorizationPhase) {
    switch phase {
    // ...
    case .didAuthorize(let payment, let resultHandler):
        server.createOrder(with: payment) { serverResult in
            guard case .success(let orderDetails) = serverResult else { /* handle error */ }
            let result = PKPaymentAuthorizationResult(status: .success, errors: nil)
            result.orderDetails = PKPaymentOrderDetails(
                orderTypeIdentifier: orderDetails.orderTypeIdentifier,
                orderIdentifier: orderDetails.orderIdentifier,
                webServiceURL: orderDetails.webServiceURL,
                authenticationToken: orderDetails.authenticationToken,
            )
            resultHandler(result)
        }
    }
}

20:13 - Order Tracking (JS)

paymentRequest.show().then((response) => {
    server.createOrder(response).then((orderDetails) => {
        let details = { };
        if (response.methodName === "https://apple.com/apple-pay") {
            details.data = {
                orderDetails: {
                    orderTypeIdentifier: orderDetails.orderTypeIdentifier,
                    orderIdentifier: orderDetails.orderIdentifier,
                    webServiceURL: orderDetails.webServiceURL,
                    authenticationToken: orderDetails.authenticationToken,
                },
            };
        }
        response.complete("success", details);
    });
});

27:05 - VerifyIdentityWithWalletButton 2

@ViewBuilder var verifiyIdentityButton: some View {
    VerifyIdentityWithWalletButton(
        .verifyIdentity,
        request: createRequest(),
    ) { result in
        // ...
    } fallback: {
        // verify identity another way
    }
}

27:18 - Create a PKIdentityRequest

func createRequest() -> PKIdentityRequest {
    let descriptor = PKIdentityDriversLicenseDescriptor()
    descriptor.addElements([.age(atLeast: 18)],
                            intentToStore: .willNotStore)
    descriptor.addElements([.givenName, .familyName, .portrait],
                            intentToStore: .mayStore(days: 30))

    let request = PKIdentityRequest()
    request.descriptor = descriptor
    request.merchantIdentifier = // configured in Developer account
    request.nonce = // bound to user session
}

27:19 - VerifyIdentityWithWalletButton 3

@ViewBuilder var verifiyIdentityButton: some View {
    VerifyIdentityWithWalletButton(
        .verifyIdentity,
        request: createRequest(),
    ) { result in
        // ...
    } fallback: {
        // verify identity another way
    }
}

29:37 - VerifyIdentityWithWalletButton 4

@ViewBuilder var verifiyIdentityButton: some View {
    VerifyIdentityWithWalletButton(
        .verifyIdentity,
        request: createRequest(),
    ) { result in
        switch result {
        case .success(let document):
            // send document to server for decryption and verification
        case .failure(let error):
            switch error {
            case PKIdentityError.cancelled:
                // handle cancellation
            default:
                // handle other errors
            }
        }
    } fallback: {
        // verify identity another way
    }
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

资源

相关视频

WWDC23