Apple Pay在APP应用内的集成

Apple Pay接入iOS端最主要的工作就是申请授权和SDK的集成，只要授权的开发者才能接入sdk，apple通过授权team id的方式对开发者授权最近在做这个东西，发现网上相关资料少的很，整理出来供准备接入的开发者参考，有疑问的可以直接联系我，我们共同讨论！首先，把招商银行APP 添加Apple Pay的场景多玩几遍，明白我们要做什么！

1. 申请授权

开发者发送Team ID到apple-pay-provisioning@apple.com申请entitlements，没有这个entitlement无法调起Apple Pay API
在开发者中心将entitlement添加到provisionProfile中，并生成新的provisionProfile
下载包含entitlement的provisionProfile并导入到项目中

2. 加载的整个流程图

我了个大擦，oschina的markdown不支持时序图语法，请找个支持时序图语法的markdown编辑器打开下面内容，查看整个流程图！

1webank app->PassKit:是否支持Apple Pay
2PassKit-->webank app:返回bool结果
3webank app->PassKit:绑定卡片列表
4PassKit-->webank app:PKPasses
5webank app->PassKit:获取加密证书
6PassKit->Apple server:获取APP加密证书+nOnce
7PassKit->PassKit:将nOnce送给SE签名\n(NOnce+AccountIDHash)
8PassKit-->webank app:加密证书+sData+nOnce
9webank app->webank server:证书+nonce+nonceSignonce
10webank server->webank server:生成一个临时的密钥对
11webank server->webank server:生成encryptedPassData\n（用apple提供的公钥）
12webank server-->webank app:encryptedPassData+临时公钥
13webank app->PassKit:添加卡片
14PassKit-> Apple server:卡片添加权限检查(EncData)
15Apple server->Apple server:verifyAndConsumenOnce
16Apple server->PNOs:联网查询
17PNOs-->Apple server:返回查询结果
18Apple server-->PassKit:权限状态+TnC
19PassKit->Apple server:enableCard(cardId+OTP)
20Apple server->PNOs:联网连接配置
21PNOs-->Apple server:response
22Apple server-->PassKit:返回卡片相关信息
23PassKit->PassKit:addDisabledPass(绑定流程结束)
24Apple server->PassKit:notify（激活完成通知）
25PassKit->PassKit:refreshPass

3. Apple Pay的加载时候的方法调用&& Passkit的集成

结合国内现有的案例（比如招行APP）来讲一下绑定和激活Apple Pay整个流程以及实现过程的一些技术点，具体集成代码参考苹果官方提供的PassKit.framework以及相关的开发者文档

###3.1 权限检查

使用PKAddPaymentPassViewController提供的类方法检查APP是否有添加银行卡到Apple Pay的权限

1NS_CLASS_AVAILABLE_IOS(9_0) @interface PKAddPaymentPassViewController : UIViewController
2+ (BOOL)canAddPaymentPass;
3

使用PKPassLibrary提供的方法检测当前设备是否能够添加输入的银行到Apple Pay

1NS_CLASS_AVAILABLE_IOS(6_0)
2@interface PKPassLibrary : NSObject
3// Returns YES if either the current device or an attached device both supports adding payment passes and does not already contain
4// a payment pass with the supplied primary account identifier.
5// indicates whether the app can add a card to Apple Pay on the devices for the provided FPAN ID
6- (BOOL)canAddPaymentPassWithPrimaryAccountIdentifier:(NSString *)primaryAccountIdentifier NS_AVAILABLE_IOS(9_0);

PKPassLibrary也提供了类方法查询绑定卡片信息，但都需要你的APP有相应的权限，简单来说，就是在招行APP中你无法获取Apple Pay绑定的建行卡信息

1- (NSArray<PKPass *> *)passes;
2- (nullable PKPass *)passWithPassTypeIdentifier:(NSString *)identifier serialNumber:(NSString *)serialNumber;
3- (NSArray<PKPass *> *)passesOfType:(PKPassType)passType NS_AVAILABLE_IOS(8_0);
4- (BOOL)containsPass:(PKPass *)pass;

###3.2 添加银行卡到wallet按钮的展示

Apple规定，接入Apple Pay的APP必须遵循他的视觉规范，入口按钮必须用官方提供的PKAddPassButton，生成之后张这个样子

输入图片说明

1#import <UIKit/UIKit.h>
2    NS_ASSUME_NONNULL_BEGIN
3    typedef NS_ENUM(NSInteger, PKAddPassButtonStyle) {
4    PKAddPassButtonStyleBlack = 0,
5    PKAddPassButtonStyleBlackOutline,
6    } NS_ENUM_AVAILABLE_IOS(9_0);
7    
8    NS_CLASS_AVAILABLE_IOS(9_0) @interface PKAddPassButton : UIButton
9    + (instancetype)addPassButtonWithStyle:(PKAddPassButtonStyle)addPassButtonStyle;
10    - (instancetype)initWithAddPassButtonStyle:(PKAddPassButtonStyle)style NS_DESIGNATED_INITIALIZER;
11    @property (nonatomic, assign) PKAddPassButtonStyle addPassButtonStyle UI_APPEARANCE_SELECTOR;
12    @end
13    NS_ASSUME_NONNULL_END
14    #endif

从用户体验的角度出发，苹果希望APP在确保用户卡片能添加到Apple Pay之后才展示该button给用户，即预检测发生在button展示之前，这一块可能会影响到上架审核

###3.3 Configuration && delegate 相关类以及方法如下

PKAddPaymentPassViewController初始化方法

1- (nullable instancetype)initWithRequestConfiguration:(PKAddPaymentPassRequestConfiguration *)configuration
2                                         delegate:(nullable id<PKAddPaymentPassViewControllerDelegate>)delegate NS_DESIGNATED_INITIALIZER;

该方法返回一个添加Apple Pay的view controller 对象,这个对象用来提供configuration 和 delegate.

PKAddPaymentPassRequestConfiguration 这个类由一个实例方法和若干属性组成
- 实例化一个configuration对象，encryptionScheme为接入方数据传输过程中使用的加密方案
```
1/* Schemes defined in PKConstants.h.
2* Supported Schemes:
3*  PKEncryptionSchemeECC_V2:
4*      ephemeralPublicKey
5*  PKEncryptionSchemeRSA_V2:
6*      wrappedKey
7*/
8- (nullable instancetype)initWithEncryptionScheme:(PKEncryptionScheme)encryptionScheme NS_DESIGNATED_INITIALIZER;
```
- 若干可选参数，很多参数从命名上就知道是干嘛用的，到具体用的时候再对照开发文档看即可
  
  @property (nonatomic, copy, readonly) PKEncryptionScheme encryptionScheme; @property (nonatomic, copy, nullable) NSString *cardholderName; @property (nonatomic, copy, nullable) NSString *primaryAccountSuffix;
  
  @property (nonatomic, copy) NSArray<PKLabeledValue *> *cardDetails NS_AVAILABLE_IOS(10_1);
  
  @property (nonatomic, copy, nullable) NSString *localizedDescription; @property (nonatomic, copy, nullable) NSString *primaryAccountIdentifier; @property (nonatomic, copy, nullable) PKPaymentNetwork paymentNetwork; @property (nonatomic, assign) BOOL requiresFelicaSecureElement NS_AVAILABLE_IOS(10_1);

PKAddPaymentPassViewControllerDelegate

1@protocol PKAddPaymentPassViewControllerDelegate<NSObject>
2/* Certificates is an array of NSData, each a DER encoded X.509 certificate, with the leaf first and root last.
3* The continuation handler must be called within 20 seconds, or the flow will terminate with
4* PKAddPaymentPassErrorInvalidRequest.
5*/
6- (void)addPaymentPassViewController:(PKAddPaymentPassViewController *)controller
7generateRequestWithCertificateChain:(NSArray<NSData *> *)certificates
8                           nonce:(NSData *)nonce
9                  nonceSignature:(NSData *)nonceSignature
10               completionHandler:(void(^)(PKAddPaymentPassRequest *request))handler;

为Apple Pay调用方提供certificate chains、nOnce、nOnceSignature 以及一个回调block，供代理去处理一个添加Apple Pay的请求，但苹果规定这个回调必须在20秒内完成，否则流程将会终止。 request相关东西在下文将介绍。

###3.4 Provision request && delegate

PKAddPaymentPassRequest，请求里面包含了APP服务端传过来的一些银行卡信息以及加密信息

1NS_CLASS_AVAILABLE_IOS(9_0) @interface PKAddPaymentPassRequest : NSObject
2- (instancetype)init NS_DESIGNATED_INITIALIZER;
3
4@property (nonatomic, copy, nullable) NSData *encryptedPassData;
5@property (nonatomic, copy, nullable) NSData *activationData;
6
7/* Scheme dependent properties:
8*/
9@property (nonatomic, copy, nullable) NSData *ephemeralPublicKey;
10@property (nonatomic, copy, nullable) NSData *wrappedKey;
11@end

请求结束之后的回调

1/* Error parameter will use codes from the PKAddPaymentPassError enumeration, using the PKPassKitErrorDomain domain.
2*/
3- (void)addPaymentPassViewController:(PKAddPaymentPassViewController *)controller didFinishAddingPaymentPass:(nullable PKPaymentPass *)pass error:(nullable NSError *)error;
4@end

Apple Pay在APP应用内的集成

1. 申请授权

2. 加载的整个流程图

3. Apple Pay的加载时候的方法调用&& Passkit的集成

评论区

相关推荐