關鍵詞

com.apple.developer.payment-pass-provisioning

PKAddPaymentPassRequestConfiguration

PKAddPaymentPassViewController

PKAddPaymentPassRequest

PKPassLibrary

PKAddPassButton

PKPaymentPass

下面是開發的步驟及遇到的問題

1.向蘋果公司的人員申請Wallet(官方說是passKit)許可權

2.許可權配好後，在開發者中心配置一下Application Services:

 3.編輯描述檔案選擇下圖所示，並重新生成，沒有其他的什麼檔案

 4.xcode工程配置 開啟wallet

5.然後配置一下工程中的檔案 填入com.apple.developer.payment-pass-provisioning欄位，確定這個entitlements檔案已加到工程裡

6.申請沙盒賬號：就是假的icloud賬號，可以用第7步的賬號直接在wallet試試

7.官方網站提供的測試賬號可以直接在wallet應用里加上

8.申請測試卡賓：即測試賬號的前6位

9.開發中遇到報錯：蘋果查需要提供SEID,銀聯查需要提供卡號

10:有效期的格式需要傳斜槓

10.報錯"無法新增卡"有很多原因

如果把密文給蘋果直接報錯“無法新增卡”，那就是加密錯誤，祕鑰是一個數組需要都傳給後臺。

11.報錯“卡片有誤”，說明加解密已過，是我們自己這邊的卡可能被鎖

12.開發此功能的設定支援的iOS版本可以低於10.3,如果使用tesfflight測試此功能需要提高到10.3.

13.上程式碼

//設定加密型別
        PKAddPaymentPassRequestConfiguration *con = [[PKAddPaymentPassRequestConfiguration alloc]initWithEncryptionScheme:PKEncryptionSchemeRSA_V2];
        con.cardholderName = @"介面展示用";
        con.localizedDescription = @"加卡";//描述資訊
        if (IOS10_OR_LATER) {
            con.paymentNetwork = PKPaymentNetworkChinaUnionPay;//銀聯卡
        }
        con.primaryAccountSuffix =  @“1111”；卡號結尾4位
        PKAddPaymentPassViewController *vc = [[PKAddPaymentPassViewController alloc] initWithRequestConfiguration:con delegate:self];
        [XXX.rootViewController pushViewController:vc animated:YES];

然後實現下面的方法
- (void)addPaymentPassViewController:(PKAddPaymentPassViewController *)controller
 generateRequestWithCertificateChain:(NSArray<NSData *> *)certificates
                               nonce:(NSData *)nonce
                      nonceSignature:(NSData *)nonceSignature
                   completionHandler:(void(^)(PKAddPaymentPassRequest *request))handler;{
    NSString *leafBase64Encoded = [certificates[0] base64EncodedStringWithOptions:0];
    NSString *subBase64Encoded = [certificates[1] base64EncodedStringWithOptions:0];
    NSArray * cerArray = @[leafBase64Encoded,subBase64Encoded];

    
    NSString *nonceStr = [self convertDataToHexStr:nonce];
    
    NSString *nonceSignatureStr = [self convertDataToHexStr:nonceSignature];
    

    //然後往後臺發介面 注意cerArray直接發給後臺
    //後臺返回密碼等資料

    然後回傳給sdk

                           NSString *encryptedPassString = params[@"encryptedPassData"];
                           
                           encryptedPassString = [encryptedPassString stringByReplacingOccurrencesOfString:@" " withString:@""];
                           
                           encryptedPassString = [encryptedPassString stringByReplacingOccurrencesOfString:@"\r\n" withString:@""];
                           
                           encryptedPassString = [encryptedPassString stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
                           
                           NSData *encryptedPassData=[[NSData alloc] initWithBase64EncodedString:encryptedPassString options:0];
                           
                           
                           
                           NSString *activationString = params[@"activationData"];
                           
                           activationString = [NSString stringWithFormat:@"%@|%@",nonceSignatureStr, params[@"activationData"]];

                           
                           NSData *activationData = [activationString dataUsingEncoding:NSUTF8StringEncoding];
                           
                           
                           
                           NSString *wrappedKeyString = params[@"wrappedKey"];
                           
                           wrappedKeyString = [wrappedKeyString stringByReplacingOccurrencesOfString:@" " withString:@""];
                           
                           wrappedKeyString = [wrappedKeyString stringByReplacingOccurrencesOfString:@"\r\n" withString:@""];
                           
                           wrappedKeyString = [wrappedKeyString stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
                           
                           NSData *wrappedKey=[[NSData alloc] initWithBase64EncodedString:wrappedKeyString options:0];
                           
                           wrappedKey = [EncodeAndDecode dataFromHexString:wrappedKeyString];
                           encryptedPassData = [EncodeAndDecode dataFromHexString:encryptedPassString];

 
                           
                           PKAddPaymentPassRequest *request = [[PKAddPaymentPassRequest alloc] init];
                           
                           request.activationData = activationData;
                           
                           request.encryptedPassData = encryptedPassData;
                           
                           request.wrappedKey = wrappedKey;
                           
                           
                           
                           
                           
                           if (request == nil) {
                               
                               return;
                               
                           }
                           
                           
                           
                           if (handler) {

                               handler(request);
                               
                           }
//下面這個方法   失敗會走但沒什麼有用的資訊  
- (void)addPaymentPassViewController:(PKAddPaymentPassViewController *)controller didFinishAddingPaymentPass:(nullable PKPaymentPass *)pass error:(nullable NSError *)error;{
}

//進位制轉換
- (NSString *)convertDataToHexStr:(NSData *)data {
    
    if (!data || [data length] == 0) {
        
        return @"";
        
    }
    
    NSMutableString *string = [[NSMutableString alloc] initWithCapacity:[data length]];
    
    
    
    [data enumerateByteRangesUsingBlock:^(const void *bytes, NSRange byteRange, BOOL *stop) {
        
        unsigned char *dataBytes = (unsigned char*)bytes;
        
        for (NSInteger i = 0; i < byteRange.length; i++) {
            
            NSString *hexStr = [NSString stringWithFormat:@"%x", (dataBytes[i]) & 0xff];
            
            if ([hexStr length] == 2) {
                
                [string appendString:hexStr];
                
            } else {
                
                [string appendFormat:@"0%@", hexStr];
                
            }
            
        }
        
    }];
    
    
    
    return string;
    
}

 

注意：1.證書要編碼傳給後臺，對證書編碼這裡用base64和平時用的沒有區別 

2.nonce要轉成16進位制傳給後臺  不是做base64。使用convertDataToHexStr方法或下面這個都行

    NSString *nOnce = [NSString stringWithFormat:@"%@",nonce];

    nOnce = [nOnce stringByReplacingOccurrencesOfString:@"<" withString:@""];

    nOnce = [nOnce stringByReplacingOccurrencesOfString:@">" withString:@""];

    nOnce = [nOnce stringByReplacingOccurrencesOfString:@" " withString:@""];

3.nonceSignature同上

4.後臺返回的資料如何給蘋果，encryptedPassData和wrappedKey需要直接從16進位制字串轉為nsdata

方法是

+ (NSData *) dataFromHexString:(NSString*)hexString
{
    NSString * cleanString = [SM4EncodeAndDecode cleanNonHexCharsFromHexString:hexString];
    if (cleanString == nil) {
        return nil;
    }
    
    NSMutableData *result = [[NSMutableData alloc] init];
    
    int i = 0;
    for (i = 0; i+2 <= cleanString.length; i+=2) {
        NSRange range = NSMakeRange(i, 2);
        

        
        NSString* hexStr = [cleanString substringWithRange:range];
        NSScanner* scanner = [NSScanner scannerWithString:hexStr];
        unsigned int intValue;
        [scanner scanHexInt:&intValue];
        unsigned char uc = (unsigned char) intValue;
        [result appendBytes:&uc length:1];
    }
    
    NSData * data = [NSData dataWithData:result];
    
//    [result autorelease];//add先去掉 可能有閃退
    
    return data;
}

5.返回的activationData 轉成data就可以 和後臺約定一下就行

6.然後可能報錯 錯誤1

上圖的警告框下邊就一個按鈕“好”，這種情況應該是返給蘋果的資料型別不對

7.錯誤2  這個下邊兩個按鈕   如果在協議之前彈出來應該是加解密錯誤（後臺要用test vector驗仔細證）   或銀聯問題

如果在協議之後彈出來應該是自己後臺驗證的問題

在wallet裡新增或在客戶端裡新增應該走的鏈路沒啥區別都報相同的錯

8.錯誤3   如果在協議之前彈出來應該是已經過了加解密，而且這個是信用卡報出來的機率大，可以驗證第7步是否加解密沒有問題

9.如果下面的錯 加解密沒問題   卡賓沒有加到測試蘋果資料裡

10.如果銀聯沒有問題會彈出協議

11.然後加掛成功 

12.注意的問題

（1）- (NSArray<PKPass *> *)passesOfType:(PKPassType)passType

這個方法如果獲取不到資料需要後臺配置一下引數：teamid.bundleid  

後臺程式碼類似

"cardMetaData":{"associatedApplicationIdentifiers":[":["P2V7337495.com.elem.e","P","","P2V7337495.com.nihaom.hao"],""],"associatedStoreIdentifiers":["473489211"]

(2)名詞 fpan不太懂應該用不到

en_otp:加密驗證碼 應該指的是activationData

(3)- canAddPaymentPassWithPrimaryAccountIdentifier:  傳入的引數應該是fpan後臺給的