PKPassKit框架解析

最新推荐文章于 2024-05-23 09:59:56 发布
最新推荐文章于 2024-05-23 09:59:56 发布
阅读量1.8k 收藏 1
点赞数
分类专栏： ApplePay相关技术文档
文章出处：http://blog.csdn.net/sz_vcp2007/article/details/52524616
（1）PassKit.h
   定义该框架下所有的类的引用
（2）PKAddPassButton.h
定义【添加到钱包】按钮，按钮定义了两种类型：1、PKAddPassButtonStyleBlack；2、PKAddPassButtonStyleBlackOutline
同时该类定义了两种构造方法：1、+ (instancetype)addPassButtonWithStyle:(PKAddPassButtonStyle)addPassButtonStyle;
2、- (instancetype)initWithAddPassButtonStyle:(PKAddPassButtonStyle)style NS_DESIGNATED_INITIALIZER;
（3）PKObject.h 直接继承于NSObject
 (4) PKPaymentPass继承于PKPass
 1、PKPaymentPassActivationState 枚举类型，包含：
    PKPaymentPassActivationStateActivated,（已激活）
    PKPaymentPassActivationStateRequiresActivation,（需要被激活）
    PKPaymentPassActivationStateActivating,（正在激活）
    PKPaymentPassActivationStateSuspended, （挂起）
    PKPaymentPassActivationStateDeactivated （停用）
2、包含的属性：
    primaryAccountIdentifier ：主账户标识
    primaryAccountNumberSuffix：主账户的后缀，一般是后面4到5个数字
    deviceAccountIdentifier：特定于设备的帐号的唯一标识符。(只读)
    deviceAccountNumberSuffix：设备账号的后缀，一般是后面4到5个数字
    activationState：上面PKPaymentPassActivationState枚举值之一
 (4）PKPass.h 继承于PKObject.h
1、PKPassType:枚举类型，包含：
PKPassTypeBarcode：条码
PKPassTypePayment:支付
PKPassTypeAny：其它类型
构造方法：- (instancetype)initWithData:(NSData *)data error:(NSError **)error;
2、属性:
（1）PKPassType：Pass类型
（2）PKPaymentPass：PKPaymentPass对象类型
（3）serialNumber：标识pass的唯一值
（4）passTypeIdentifier：pass类型的唯一值
（5）webServiceURL：更新pass的URL地址
（6）localizedName：pass模板的本地名称
（7）localizedDescription：本地化描述
（8）organizationName：组织名称
（9）relevantDate：时间
（10）icon：图标
（11）userInfo：用户信息
（12）passURL：在pass APP里面打开pass的地址，作为URL的参数调用openURL: method of UIApplication.
（13）remotePass：指示pass是否存储在本地iOS设备上
（14）deviceName：设备名称
 
 （5）PKConstants.h
 包含以下几种类型：
 1、PKEncryptionSchemeECC_V2 ：支持Apple pay卡加密
 2、PKPaymentNetworkAmex：美国运通
 3、PKPaymentNetworkChinaUnionPay：中国银联
 4、PKPaymentNetworkDiscover:discover网络
 5、PKPaymentNetworkInterac：interac网络
 6、PKPaymentNetworkMasterCard：万事达卡
 7、PKPaymentNetworkPrivateLabel
 8、PKPaymentNetworkVisa：visa
 （6）PKContact.h
 1、name：NSPersonNameComponents类型，名字
 2、postalAddress：CNPostalAddress类型，邮编
 3、emailAddress：邮件
 4、phoneNumber：CNPhoneNumber类型，手机号码
 5、supplementarySubLocality：
 （7）PKError.h
错误码：PKPassKitErrorCode，枚举类型：
PKUnknownError、
PKInvalidDataError、
PKUnsupportedVersionError、
PKInvalidSignature
（8）PKPassLibrary.h
当把pass添加到pass libarary后的状态：PKPassLibraryAddPassesStatus，类型：
PKPassLibraryDidAddPasses、
PKPassLibraryShouldReviewPasse、
PKPassLibraryDidCancelAddPasses
PKAutomaticPassPresentationSuppressionResult 枚举值：
PKAutomaticPassPresentationSuppressionResultNotSupported、
PKAutomaticPassPresentationSuppressionResultAlreadyPresenting、
PKAutomaticPassPresentationSuppressionResultDenied、
PKAutomaticPassPresentationSuppressionResultCancelled、
PKAutomaticPassPresentationSuppressionResultSuccess

请求令牌：PKSuppressionRequestToken

构造方法：
+ (BOOL)isPassLibraryAvailable
pass library是否可用
+ (PKSuppressionRequestToken)requestAutomaticPassPresentationSuppressionWithResponseHandler:(void(^)(PKAutomaticPassPresentationSuppressionResult result))responseHandler
当设备遇到非接字段时，临时使自动展示不可用
+ (void)endAutomaticPassPresentationSuppressionWithRequestToken:(PKSuppressionRequestToken)requestToken
重新使Apple pay接口可用
+ (BOOL)isSuppressingAutomaticPassPresentation
指示系统是否支持 Apple Pay passes的自动展示.
- (BOOL)isPaymentPassActivationAvailable
支付pass是否可激活
- (NSArray<PKPass *> *)passes;
返回本地标题为可访问的pass
- (nullable PKPass *)passWithPassTypeIdentifier:(NSString *)identifier serialNumber:(NSString *)serialNumber;
返回指定pass的类型
- (NSArray<PKPass *> *)passesOfType:(PKPassType)passType
返回所有的pass
- (NSArray<PKPaymentPass *> *)remotePaymentPasses
移除pass
- (void)removePass:(PKPass *)pass
判断是否包含pass
- (BOOL)containsPass:(PKPass *)pass
替换pass
- (BOOL)replacePassWithPass:(PKPass *)pass
添加pass,完成后把添加的状态回调传回
- (void)addPasses:(NSArray<PKPass *> *)passes withCompletionHandler:(nullable void(^)(PKPassLibraryAddPassesStatus status))completion
打开支付安装流程
- (void)openPaymentSetup
// 支持在当前设备或附件添加主账户不存在的卡
- (BOOL)canAddPaymentPassWithPrimaryAccountIdentifier:(NSString *)primaryAccountIdentifier
// 下面2个方法激活pay pass
- (void)activatePaymentPass:(PKPaymentPass *)paymentPass withActivationData:(NSData *)activationData completion:(nullable void(^)(BOOL success, NSError* error))completion __WATCHOS_PROHIBITED NS_AVAILABLE_IOS(8_0);
- (void)activatePaymentPass:(PKPaymentPass *)paymentPass withActivationCode:(NSString *)activationCode completion:(nullable void(^)(BOOL success, NSError* error))completion __WATCHOS_PROHIBITED NS_DEPRECATED_IOS(8_0, 9_0, "Use activatePaymentPass:withActivationData:completion: instead");
// 下面是2个通知
extern NSString * const PKPassLibraryDidChangeNotification NS_AVAILABLE_IOS(6_0);
extern NSString * const PKPassLibraryRemotePaymentPassesDidChangeNotification NS_AVAILABLE_IOS(9_0);
其中，PKPassLibraryDidChangeNotification有下面一些key：
PKPassLibraryAddedPassesUserInfoKey、
PKPassLibraryReplacementPassesUserInfoKey、
PKPassLibraryRemovedPassInfosUserInfoKey、
PKPassLibraryPassTypeIdentifierUserInfoKey、
PKPassLibrarySerialNumberUserInfoKey
（9）PKPayment.h
代表了付款结果
包含下面几个属性：
1、token：包含加密后的支付凭证
2、PKContact *billingContact：计费地址
3、shippingContact：邮递地址
4、shippingMethod：邮递方式
（10）PKPaymentAuthorizationViewController.h
PKPaymentAuthorizationStatus 枚举值：
PKPaymentAuthorizationStatusSuccess 支付授权成功
PKPaymentAuthorizationStatusFailure 支付授权失败
PKPaymentAuthorizationStatusInvalidBillingPostalAddress 计费地址错误
PKPaymentAuthorizationStatusInvalidShippingPostalAddress 投递地址错误
PKPaymentAuthorizationStatusInvalidShippingContact 提供联系信息是不够的
PKPaymentAuthorizationStatusPINRequired 需要PIN 个人身份唯一标识
PKPaymentAuthorizationStatusPINIncorrect 错误的PIN
PKPaymentAuthorizationStatusPINLockout PIN被锁

代理：PKPaymentAuthorizationViewControllerDelegate
必须要执行的方法：
当用户支付请求时候执行
1、- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                       didAuthorizePayment:(PKPayment *)payment
                                completion:(void (^)(PKPaymentAuthorizationStatus status))completion
当支付完成的时候
2、- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller
可选的执行方法：
1、- (void)paymentAuthorizationViewControllerWillAuthorizePayment:(PKPaymentAuthorizationViewController *)controller
当选择了新的邮递方式之后
2、- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                   didSelectShippingMethod:(PKShippingMethod *)shippingMethod
                                completion:(void (^)(PKPaymentAuthorizationStatus status, NSArray<PKPaymentSummaryItem *> *summaryItems))completion
3、重新选择联系地址后
- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                  didSelectShippingContact:(PKContact *)contact
                                completion:(void (^)(PKPaymentAuthorizationStatus status, NSArray<PKShippingMethod *> *shippingMethods,
                                                     NSArray<PKPaymentSummaryItem *> *summaryItems))completion NS_AVAILABLE_IOS(9_0);
4、重新选择支付卡
- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                    didSelectPaymentMethod:(PKPaymentMethod *)paymentMethod
                                completion:(void (^)(NSArray<PKPaymentSummaryItem *> *summaryItems))completion NS_AVAILABLE_IOS(9_0);

方法：
测试设备是否能支付
1、+ (BOOL)canMakePayments; 
测试是否支持支付网络
2、+ (BOOL)canMakePaymentsUsingNetworks:(NSArray<NSString *> *)supportedNetworks;
测试是否支持支付网络和支付类别，类别在PKMerchantCapability枚举中查看
3、+ (BOOL)canMakePaymentsUsingNetworks:(NSArray<NSString *> *)supportedNetworks capabilities:(PKMerchantCapability)capabilties NS_AVAILABLE_IOS(9_0);
构造方法
- (instancetype)initWithPaymentRequest:(PKPaymentRequest *)request
（10）PKPaymentButtonStyle.h
PKPaymentButtonStyle 样式类型枚举
PKPaymentButtonStyleWhite
PKPaymentButtonStyleWhiteOutline
PKPaymentButtonStyleBlack
PKPaymentButtonType 类型枚举
PKPaymentButtonTypePlain
PKPaymentButtonTypeBuy
PKPaymentButtonTypeSetUp
构造方法：
+ (instancetype)buttonWithType:(PKPaymentButtonType)buttonType style:(PKPaymentButtonStyle)buttonStyle;

- (instancetype)initWithPaymentButtonType:(PKPaymentButtonType)type paymentButtonStyle:(PKPaymentButtonStyle)style

（11）PKPaymentMethod.h
1、枚举类型：PKPaymentMethodType
PKPaymentMethodTypeUnknown、
PKPaymentMethodTypeDebit、借记
PKPaymentMethodTypeCredit、 贷记
PKPaymentMethodTypePrepaid、预付
PKPaymentMethodTypeStore
属性：
1、displayName：显示名称
2、network：支付网络
3、type ：刚才定义的PKPaymentMethodType其中一个值
4、paymentPass：
（12）PKPaymentRequest.h
PKMerchantCapability枚举：商户支持的支付方式
PKMerchantCapability3DS、 Merchant supports 3DS
PKMerchantCapabilityEMV、
PKMerchantCapabilityCredit、
PKMerchantCapabilityDebit

PKAddressField：地址字段
PKAddressFieldNone、
PKAddressFieldPostalAddress、
PKAddressFieldPhone、
PKAddressFieldEmail、
PKAddressFieldName、
PKAddressFieldAll

PKShippingType：邮递方式
PKShippingTypeShipping、
PKShippingTypeDelivery、
PKShippingTypeStorePickup、
PKShippingTypeServicePickup

PKPaymentSummaryItemType：支付总的信息
PKPaymentSummaryItemTypeFinal、
PKPaymentSummaryItemTypePending

PKPaymentSummaryItem接口：定义一个单项的付款明细
+ (instancetype)summaryItemWithLabel:(NSString *)label amount:(NSDecimalNumber *)amount;
+ (instancetype)summaryItemWithLabel:(NSString *)label amount:(NSDecimalNumber *)amount type:(PKPaymentSummaryItemType)type NS_AVAILABLE(NA, 9_0);
包含属性：
1、label:item的简单描述
2、amount：item的金额
3、type：PKPaymentSummaryItemType其中类型

PKShippingMethod接口：PKPaymentSummaryItem
1、identifier、邮递标识
2、detail、邮递明细

PKPaymentRequest.h接口
1、merchantIdentifier：商家和苹果协议好的商家标志
2、countryCode、国际区号
3、supportedNetworks、支付的网络
4、merchantCapabilities、商家支付方式
5、paymentSummaryItems、支付总信息
6、currencyCode、货币吗
7、requiredBillingAddressFields：购买地址
8、billingContact：如果商家有购买地址，则写在这里
9、requiredShippingAddressFields：邮寄地址需要
10、shippingContact：邮寄联系人
11、shippingMethods: 邮寄方法
12、shippingType：邮寄方式
13、applicationData：应用程序数据

（13）PKPaymentToken
1、paymentMethod、支付方式
2、transactionIdentifier、交易标识
3、paymentData、加密数据
ziyikongfu
关注
专栏目录
[iOS]PassKit框架解析
sz_vcp2007的专栏
09-13 3864
（1）PassKit.h    定义该框架下所有的类的引用 （2）PKAddPassButton.h 定义【添加到钱包】按钮，按钮定义了两种类型：1、PKAddPassButtonStyleBlack；2、PKAddPassButtonStyleBlackOutline 同时该类定义了两种构造方法：1、+ (instancetype)addPassButtonWithStyle:(PKAd
iOS开发------Apple Pay(PassKit.framework篇)
RITL_Y
08-24 2543
由于项目突赶进度，从上次发布iOS开发——Apple Pay(证书配置篇)过去有挺长一段时间了。俗话说凡事应有始有终，所以还是决定趁空余时间将这篇Apple Pay(PassKit.framework篇)补充完整，万一有相同疑问的小伙伴呢，好有个参考，也不枉花费的时间。说实话，网上其实有很多介绍Apple Pay的文章，但总是感觉不太详细，在探索的过程中没有给我太大的帮助，便把更多的时间执着于开发文
iOS PassKit框架（一）—— PKPaymentAuthorizationViewController
ihoudf
08-09 1912
PKPaymentAuthorizationViewController 此类弹出apple pay视图控制器。 + (BOOL)canMakePayments;// 设备是否能进行applepay支付 + (BOOL)canMakePaymentsUsingNetworks:(NSArray&lt;PKPaymentNetwork&gt; *)supportedNetworks; + (BOO...
iOS6新特征：PassKit编程指南
03-24
本文档包含了 Pass Kit 技术的关键概念，以及解释了使用 Pass Kit 的方法。 Pass（通行证）是用数字化表示的信息，这些信息可能需要被打印在小纸片或者塑料上。在现实世界中， pass 让用户像使用登机牌、会员卡、优惠卷一样的方式在使用。pass 库包含了用户的通行证。用户可以使用 Passbook 应用程序来浏览和管理他们的通行证。 【注：便于理解，下面红色部分是译者根据下图表达的意思，增加进去的】 从下图，我们可以看出 Pass（通行证）使用的步骤： 1、 服务器端创建一个 pass，客户端可以通过 email，url 或者普通的应用程序进行安装 2、 一段时间过后，服务器端可能由于某种原因（例如登机牌的登机时间改变），把 pass 更新了，这是 服务器端通过苹果的 APNS，把消息推送给客户端 3、 客户端收到推送消息后，请求服务器，以查询详细信息
PassKit -- Wallet开发
旭日的博客
04-10 1171
根据目前系统钱包中的能够添加的卡，大致可分为三类银行卡/交通卡电子卡(例如：京东闪付)消费凭证 (电影票/机票/优惠券)
推荐一款创新的iOS应用：PassKit商务名片模板
最新发布
gitblog_00050的博客
05-23 306
推荐一款创新的iOS应用：PassKit商务名片模板 项目地址:https://gitcode.com/TimOliver/PassKit-Business-Card 在数字化时代，创新始终是推动我们前进的重要力量。今天，我们要向您推荐一个有趣的开源项目——PassKit-Business-Card，它将传统的纸质名片转变为可存放在iPhone钱包应用中的电子版，既环保又实用。 项目简介 Pass...
iOS6新特征：初识PassKit
eqera的专栏
11-01 3874
初始PassKit Pass（通行证）是用数字化表示的信息。在现实世界中，pass可以是登机牌、会员卡、优惠卷等。这些pass存放在PassBook里面。用户可以使用Passbook应用程序来浏览和管理他们的通行证，当然开发者也可以使用PassKit 框架来编写自己程序，以提供Pass的一些功能。 PassBook为用户提供了非常方便的功能，用户只需要带上手机，就可以出去消费，免去了各种卡。
iOS PassKit框架 （三）——Passkit其他类
ihoudf
08-10 1086
PKPaymentButton  —— 8.3以后的applePay系统按钮 PKAddPassButton ——  9.0后一个显示“Add to Apple Wallet”的按钮 PKAddPaymentPassViewController ——  添加银行卡到apple pay的系统控制器 {     // 初始化。添加支付卡需要一个特殊的由苹果发行的授权。如果app中不包括这个授权...
iOS PassKit框架 （二）—— PKPaymentRequest
ihoudf
08-09 1653
PKPaymentRequest 此类配置弹出的apple pay控制器中各内容要素 // 返回支付系统 + (NSArray&lt;PKPaymentNetwork&gt; *)availableNetworks; // + (NSError *)paymentContactInvalidErrorWithContactField:(PKContactField)field localize...
iOS apple Pay 教程
Magic.F的专栏
06-29 2993
Apple Pay运行环境：iPhone6以上设备，操作系统最低iOS9.0以上，部分信息设置需要iOS9.2以上。目前还不支持企业证书添加。 环境搭建好后可以在模拟器上面运行，xcode7.2.1+iPhone6SP9.2系统下，系统会绑定几种虚拟的银行卡，和几个联系人，方便调试，支付也不会发生真实的付款，真的很方便。 准备工作 在接入Apple Pay之前，首先要申请Merc
简单的做了一个苹果支付的demo
ZHZMAREN的博客
03-04 694
配置文件：请点击文件配置 首先导入框架：#import 然后是代理：PKPaymentAuthorizationViewControllerDelegate 这个代理方法是为了和后台数据做判断完成支付的对接： -(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewControlle
XZ_iOS 之 ApplePay支付看这一篇就够了-第二阶段
understand_XZ的博客
04-17 609
如果需要第一阶段，证书申请，请移步 《XZ_iOS 之 ApplePay支付看这一篇就够了-第一阶段》 申请完证书之后，现在开始工程配置，你也可以先创建好工程，设置好Bundle Identifier再申请证书。 首先，创建工程，确保Bundle Identifier 跟申请 Merchant ID 的一样 设置好Bundle Identifier 和 Team 之后，点击 Capabi...
iOS集成三方支付支付宝、微信、银联、Apple Pay
努力，可能成功！放弃，注定失败！
09-07 914
很多APP里都有支付，我们一般都是使用比较成熟且用户基数很大的第三方支付，比如支付宝和微信，为使用方便，我们一般都会进行封装，这样做的好处就是第三方SDK更换或者有变动，只对封装的类就行修改就好了。不多说了，直接上代码 使用示例代码 支付宝 PayOrderInfo *orderInfo = [[PayOrderInfo alloc] init]; orderInfo.payType = ...
Apple Pay 接入
WQ_631288233的博客
06-28 1189
Apple pay 整体接入流程 一 . 简介 Apple Pay，是苹果公司在2014苹果秋季新品发布会上发布的一种基于NFC的手机支付功能，于2014年10月20日在美国正式上线。官网链接apple pay developer 二. 整个流程中如下： 客户端通过苹果API，在 APP 应用内展示 Apple Pay 支付控件。（注意： 和其他支付入口一样醒目） 用户在 Apple Pay 的支付控件上进行生物验证（指纹或者人脸识别）或者手机密码验证。 苹果在用户验证通过之后，会生成一个用户选中的银行卡
iOS PassKit Wallet 开发（Passbook 开发）
wentianen的博客
09-27 4572
简介Wallet 的前身叫 Passbook，对用户来说，，它是一个票据凭证的综合管理中心，你可以把你的登机牌、电影票、优惠券等所有凭证添加到 Wallet，在里面可以查看凭证的余额、使用期限、使用地点等信息，使用时直接通过 Wallet 就能看到你所有的票据和凭证。对于开发者而言，支持 Wallet ，可以给用户提供更统一便利的管理凭证的方式，便于用户使用。Wallet 可以通过 “Passes”
如何将PKPaymentPass添加到PKPassLibrary中
qq_15509071的博客
07-15 1649
关键词 com.apple.developer.payment-pass-provisioning PKAddPaymentPassRequestConfiguration PKAddPaymentPassViewController PKAddPaymentPassRequest PKPassLibrary PKAddPassButton PKPaymentPass ...
ApplePay简单测试(一)
YoungForever
02-24 5424
最近ApplePay刚进入中国,现在貌似挺火的.在Github上看到了别人写的一个Demo(https://github.com/lintide/ApplePayDemo),于是研究了一下.下面简单记录一下步骤和经验.(在2016-2-24是有效的,以后不知道怎么改了) 1.登陆开发者中心,在申请证书里选择Merchant ID 点击右上角+号 2.continue 后有填写描述和标识符的
[iOS]PKPass文件制作及添加到Wallet
sz_vcp2007的专栏
03-07 9511
1、什么是PKPass文件？PKPass 是Apple定义的一套针对商家消费券、优惠券、火车机票等票据格式类文件。包含：图标icon、缩略图thumbnail和logo外最重要的就是pass.json、manifest.json和signature等文件的一个压缩包2、如何制作PKPass文件？1）、服务器端制作是比较通用的做法 这里有一个Java写的开源库： Java版本制作PKPass的we
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值