PKPaymentAuthorizationViewControllerDelegate
继承自NSObject
,@import PassKit
。
PKPaymentAuthorizationViewControllerDelegate
协议被支付授权视图控制器的代理实施。实现该协议响应用户和视图控制器之间的交互。
在它回调其他的代理方法之前,支付授权视图控制器自动等待它的代理完成响应一个方法。指定代理回调方法中的完成Block
用来完成当前的方法。该操作告诉支付授权视图控制器继续授权进程的下一步。
这种步进式过程(一步一步地进行)有一个例外:一旦用户取消没有授权的支付,支付授权视图控制器调用paymentAuthorizationViewControllerDidFinish
方法。该控制器在任何时候调用该方法。
Working with Authorization 处理授权
-paymentAuthorizationViewControllerWillAuthorizePayment:
告诉代理用户正在授权该支付请求。
参数:controller
支付授权视图控制器
支付请求被授权之前但在用户使用密码或者Touch ID支付之后调用该方法。
-paymentAuthorizationViewController:didAuthorizatePayment:completion:
告诉代理用户已经授权该支付请求。
参数:
controller
支付授权视图控制器
payment
授权的支付。该对象不仅包含需要提交给支付处理器的支付密钥,还包含支付请求需要的账单和运送信息。
completion
当app授权支付之后回调完成的Block
。该Block
取下面的参数:status
支付的授权状态。对于它的值,查看PKPaymentAuthorizationStatus
。
当授权支付请求之后调用该方法,提交支付信息给支付进程授权该交易,并回调完成的Block
。
-paymentAuthorizationViewController:didSelectPaymentMethod:completion:
告诉代理支付方式已经改变并请求更新的概要项列表。
参数:
controleller
支付授权视图控制器
paymentMethod
新的支付方式
completion
当app更新概要项之后回调完成的Block
。该Block
包含下面参数:summaryItem
包含任何由支付方式引起的费用或者信用卡附加费带来的改变而更新后的概要项数组。
当用户选择一个新的支付卡时调用该方法。使用该代理回调更新概要项用以响应卡片方式的改变(例如:信用卡附加费),调用更新概要项的回调。
注意:该代理不再接受回调,除非paymentAuthorizationViewControllerDidFinish:
直到它引起完成的Block
。
-paymentAuthorizationViewControllerDidFinish:
告诉代理支付授权已经完成。
参数:controller
支付授权视图控制器。
使用该方法dismiss
支付授权视图控制器,更新其他的app状态。
当用户授权一个支付请求时,当paymentAuthorizationViewController:didAuthorizePayment:completion:
方法的完成Block
已经展示给用户,该方法被调用。当用户没有授权支付请求引起取消操作时,仅仅paymentAuthorizationViewControllerDidFinish:
被调用。
Working with Shipping Information 处理运送信息
-paymentAuthorizationViewController:didSelectShippingMethod:completion:
告诉代理用户选择一个运送方式。
参数:
controller
支付授权视图控制器
shippingMethod
选择的运送方式。该参数包含支付方式的一种,包含在支付请求中。
completion
更新运送方式信息时该完成Block被调用。该Block包含下面的参数:status
支付的授权状态。所有可能值,可查看PKPaymentAuthorizationStatus
。SummaryItems
PKPaymentSummaryItems
对象的数组,用以替换当前支付请求的概要项。
使用该方法更新基于用户选择的运送地址产生的运送费用,该运送地址为先前在paymentAuthorizationViewController:didSelectShippingAddress:completion:
方法中传送给代理的。如果没有选择地址,使用在支付请求中预填充的地址。
当该方法被调用时,创建一个新的PKPaymentSummaryItem
对象的数组,展示包括运费的更新后的费用。更多关于创建概要项的信息,可查看PKPaymentRequest
类中的paymentSummaryItems
属性。
-paymentAuthorizationViewController:didSelectShippingContact:completion:
告诉代理用于选择一个运送地址。
参数:
controller
支付授权视图控制器
contact
展示新的运送地址的联系对象。为了维护隐私,运送信息是匿名的。例如:在美国仅仅包含城市、州、邮政编码。这提供足够的信息用来计算运费,不显示敏感信息除非用户实际上批准该次购买。
completion
更新运送信息时完成Block
被调用。该Block
包含下面的参数:staus
支付的授权状态。所有可能值,可查看PKPaymentAuthorizationStatus
。shippingMethods
一个 PKShippingMethod
对象的数组,用以替代当前支付请求的运送方式。summaryItems
PKPaymentSummaryItems
对象的数组,用以替换当前支付请求的概要项。
使用该方法更新适用的运送方式和如果选中一种运送方式相应的当前的运费。
当该方法被调用时,创建一个指定地址适用的PKShippingMethod
对象的新数组。也可以创建一个显示更新后的费用的PKPaymentSummaryItem
对象的数组。概要项应该包含选中的适用的运送方式的运费。更多关于更新这些数据的信息,可查看PKPaymentRequest
类的shippingMethods
和paymentSummaryItems
属性。
Constants 常量
PKPaymentAuthorizationStatus
一般是成功和失败的状态,也有由于特殊错误生成的代码。
PaymentAuthorizationStatus | Description |
---|---|
PKPaymentAuthorizationStatusSuccess | 支付授权成功或者交易被期望是成功的 |
PKPaymentAuthorizationStatusFailure | 支付授权失败(无效的地址或联系方式) |
PKPaymentAuthorizationStatusInvalidBillingPostalAddress | 无效或不可用的账单地址 |
PKPaymentAuthorizationStatusInvalidShippingPostalAddress | 无效或者不可用的运送地址 |
PKPaymentAuthorizationStatusInvalidShippingContact | 无效或不完整的运送联系方式 |