PKPaymentAuthorizationViewControllerDelegate

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 支付的授权状态。所有可能值,可查看PKPaymentAuthorizationStatusSummaryItems PKPaymentSummaryItems对象的数组,用以替换当前支付请求的概要项。

使用该方法更新基于用户选择的运送地址产生的运送费用,该运送地址为先前在paymentAuthorizationViewController:didSelectShippingAddress:completion:方法中传送给代理的。如果没有选择地址,使用在支付请求中预填充的地址。

当该方法被调用时,创建一个新的PKPaymentSummaryItem对象的数组,展示包括运费的更新后的费用。更多关于创建概要项的信息,可查看PKPaymentRequest类中的paymentSummaryItems属性。

-paymentAuthorizationViewController:didSelectShippingContact:completion:

告诉代理用于选择一个运送地址。
参数:
controller 支付授权视图控制器
contact 展示新的运送地址的联系对象。为了维护隐私,运送信息是匿名的。例如:在美国仅仅包含城市、州、邮政编码。这提供足够的信息用来计算运费,不显示敏感信息除非用户实际上批准该次购买。
completion 更新运送信息时完成Block被调用。该Block包含下面的参数:staus 支付的授权状态。所有可能值,可查看PKPaymentAuthorizationStatusshippingMethods 一个 PKShippingMethod对象的数组,用以替代当前支付请求的运送方式。summaryItems PKPaymentSummaryItems对象的数组,用以替换当前支付请求的概要项。

使用该方法更新适用的运送方式和如果选中一种运送方式相应的当前的运费。
当该方法被调用时,创建一个指定地址适用的PKShippingMethod对象的新数组。也可以创建一个显示更新后的费用的PKPaymentSummaryItem对象的数组。概要项应该包含选中的适用的运送方式的运费。更多关于更新这些数据的信息,可查看PKPaymentRequest类的shippingMethodspaymentSummaryItems属性。

Constants 常量

PKPaymentAuthorizationStatus

一般是成功和失败的状态,也有由于特殊错误生成的代码。

PaymentAuthorizationStatus Description
PKPaymentAuthorizationStatusSuccess 支付授权成功或者交易被期望是成功的
PKPaymentAuthorizationStatusFailure 支付授权失败(无效的地址或联系方式)
PKPaymentAuthorizationStatusInvalidBillingPostalAddress 无效或不可用的账单地址
PKPaymentAuthorizationStatusInvalidShippingPostalAddress 无效或者不可用的运送地址
PKPaymentAuthorizationStatusInvalidShippingContact 无效或不完整的运送联系方式
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 1.About Apple Pay Apple Pay是一种移动支付技术,让使用者把它们对真实的物品和服务的支付信...
    NEWWORLD阅读 10,609评论 14 51
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 175,008评论 25 709
  • Authorizing Payments 支付授权处理是支付授权视图控制器和它的代理之间的协力合作的结果。支付授权...
    NEWWORLD阅读 5,292评论 2 0
  • 我昨晚九点多睡觉,因为中午没有休息,所以晚上入睡特别快,而且感觉到困。然而早晨定了五六个闹钟,五点的,都没有醒来。...
    晓丽姐阅读 3,060评论 0 2
  • 图片发自简书App 流光溢彩笑语喧,踽踽独行颜难展。早知归来形影吊,不如他乡天伦欢。 注:2000年,孤身回蓉,爱...
    成都独行侠阅读 2,490评论 0 6