您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

Apple Pay 接入詳解:從環境搭建到支付全流程

編輯:iOS 開發基礎

本文為投稿文章,作者:Yasin

Apple Pay 的運行環境要求:iPhone 6 及以上設備,操作系統最低 iOS 9.0,部分信息設置需 iOS 9.2 以上,目前尚不支持企業證書添加。環境搭建完成後可在模擬器上運行,我在 xcode 7.2.1 + iPhone 6SP(iOS 9.2)下測試,系統會綁定幾張虛擬銀行卡與聯繫人方便調試,且支付不會產生真實扣款,十分便利。

准備工作

接入 Apple Pay 前,首先要申請 Merchant ID 及對應證書(可參考我寫的《申請 Merchant ID 及對應證書詳解》一文)。

工程設置

  • 設置 bundleID

在 Capability 中啟用 Apple Pay 權限並選擇 merchantID。

之後項目會多出一個 Apple Pay 配置文件 ApplePayYasin.entitlements。

  • 需要引用的庫

Xcode 7.0 以上無需手動添加庫,導入頭文件即可:

#import  // 用戶綁定的銀行卡信息 #import  // Apple pay 的展示控件
  • 設備 Apple Pay 權限檢測

if (![PKPaymentAuthorizationViewController class]) { // 需 iOS 8.0 以上支持 NSLog(@"操作系統不支持 ApplePay,請升級至 9.0 以上,且需 iPhone 6 以上設備"); return; } // 檢查當前設備是否可支付 if (![PKPaymentAuthorizationViewController canMakePayments]) { NSLog(@"設備不支持 ApplePay,請升級至 9.0 以上,且需 iPhone 6 以上設備"); return; } // 檢查用戶是否可進行某種卡的支付(Amex、MasterCard、Visa 與銀聯),按項目需要檢測 NSArray *supportedNetworks = @[PKPaymentNetworkAmex, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa, PKPaymentNetworkChinaUnionPay]; if (![PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:supportedNetworks]) { NSLog(@"沒有綁定支付卡"); return; }

創建支付請求 PKPaymentRequest

  • 初始化 PKPaymentRequest(注意人民幣幣種代碼為 CNY)

// 設置幣種、國家碼及 merchant 標識符等基本信息 PKPaymentRequest *payRequest = [[PKPaymentRequest alloc] init]; payRequest.countryCode = @"CN"; // 國家代碼 payRequest.currencyCode = @"CNY"; // 人民幣幣種代碼 payRequest.merchantIdentifier = @"merchant.ApplePayDemoYasin"; // 申請的 merchantID payRequest.supportedNetworks = supportedNetworks; // 用戶可支付的銀行卡 payRequest.merchantCapabilities = PKMerchantCapability3DS | PKMerchantCapabilityEMV; // 3DS 必須支持,EMV 可選,國內建議兩者都設
  • 設置賬單配送信息與貨物配送地址(用戶設置後可通過代理回調獲取更新)

// payRequest.requiredBillingAddressFields = PKAddressFieldEmail; // 默認 PKAddressFieldNone payRequest.requiredShippingAddressFields = PKAddressFieldPostalAddress | PKAddressFieldPhone | PKAddressFieldName; // 送貨地址信息,默認 PKAddressFieldNone

送貨信息頁面展示。設置配送方式(不需要則不配置):

// 設置兩種配送方式 PKShippingMethod *freeShipping = [PKShippingMethod summaryItemWithLabel:@"包郵" amount:[NSDecimalNumber zero]]; freeShipping.identifier = @"freeshipping"; freeShipping.detail = @"6-8 天送達"; PKShippingMethod *expressShipping = [PKShippingMethod summaryItemWithLabel:@"極速送達" amount:[NSDecimalNumber decimalNumberWithString:@"10.00"]]; expressShipping.identifier = @"expressshipping"; expressShipping.detail = @"2-3 小時送達"; payRequest.shippingMethods = @[freeShipping, expressShipping];

  • 賬單信息的設置

每條賬單用 PKPaymentSummaryItem 添加描述與價格,價格使用 NSDecimalNumber。初始化時 label 為商品名或描述,amount 為價格(折扣為負數),type 表示該條是最終價格還是估算價格:

+ (instancetype)summaryItemWithLabel:(NSString *)label amount:(NSDecimalNumber *)amount; + (instancetype)summaryItemWithLabel:(NSString *)label amount:(NSDecimalNumber *)amount type:(PKPaymentSummaryItemType)type;

添加賬單列表:

NSDecimalNumber *subtotalAmount = [NSDecimalNumber decimalNumberWithMantissa:1275 exponent:-2 isNegative:NO]; // 12.75 PKPaymentSummaryItem *subtotal = [PKPaymentSummaryItem summaryItemWithLabel:@"商品價格" amount:subtotalAmount]; NSDecimalNumber *discountAmount = [NSDecimalNumber decimalNumberWithString:@"-12.74"]; PKPaymentSummaryItem *discount = [PKPaymentSummaryItem summaryItemWithLabel:@"優惠折扣" amount:discountAmount]; NSDecimalNumber *methodsAmount = [NSDecimalNumber zero]; PKPaymentSummaryItem *methods = [PKPaymentSummaryItem summaryItemWithLabel:@"包郵" amount:methodsAmount]; NSDecimalNumber *totalAmount = [NSDecimalNumber zero]; totalAmount = [totalAmount decimalNumberByAdding:subtotalAmount]; totalAmount = [totalAmount decimalNumberByAdding:discountAmount]; totalAmount = [totalAmount decimalNumberByAdding:methodsAmount]; PKPaymentSummaryItem *total = [PKPaymentSummaryItem summaryItemWithLabel:@"Yasin" amount:totalAmount]; summaryItems = [NSMutableArray arrayWithArray:@[subtotal, discount, methods, total]]; // 設為成員變量,便於代理回調中調整金額 payRequest.paymentSummaryItems = summaryItems;

顯示購物信息並發起支付

// Apple Pay 控件 PKPaymentAuthorizationViewController *view = [[PKPaymentAuthorizationViewController alloc] initWithPaymentRequest:payRequest]; view.delegate = self; [self presentViewController:view animated:YES completion:nil];

PKPaymentAuthorizationViewControllerDelegate 代理

  • 兩個相關類介紹

PKPayment(支付成功信息):

PKPaymentToken *payToken = payment.token; // 支付憑據,發給服務端驗證 PKContact *billingContact = payment.billingContact; // 賬單信息 PKContact *shippingContact = payment.shippingContact; // 送貨信息 PKContact *shippingMethod = payment.shippingMethod; // 送貨方式

PKContact(聯繫人信息):

NSPersonNameComponents *name = contact.name; // 姓名 CNPostalAddress *postalAddress = contact.postalAddress; // 地址 NSString *emailAddress = contact.emailAddress; // 郵箱 CNPhoneNumber *phoneNumber = contact.phoneNumber; // 手機 NSString *supplementarySubLocality = contact.supplementarySubLocality; // 補充信息,iOS 9.2 及以上才有
  • 代理說明

送貨地址回調:

-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectShippingContact:(PKContact *)contact completion:(void (^)(PKPaymentAuthorizationStatus, NSArray * _Nonnull, NSArray * _Nonnull))completion{ // 可根據送貨地址調整配送方式與金額 completion(PKPaymentAuthorizationStatusSuccess, shippingMethods, summaryItems); }

送貨方式回調:

-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectShippingMethod:(PKShippingMethod *)shippingMethod completion:(void (^)(PKPaymentAuthorizationStatus, NSArray * _Nonnull))completion{ PKShippingMethod *oldShippingMethod = [summaryItems objectAtIndex:2]; PKPaymentSummaryItem *total = [summaryItems lastObject]; total.amount = [total.amount decimalNumberBySubtracting:oldShippingMethod.amount]; total.amount = [total.amount decimalNumberByAdding:shippingMethod.amount]; [summaryItems replaceObjectAtIndex:2 withObject:shippingMethod]; [summaryItems replaceObjectAtIndex:3 withObject:total]; completion(PKPaymentAuthorizationStatusSuccess, summaryItems); }

支付卡選擇回調:

-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectPaymentMethod:(PKPaymentMethod *)paymentMethod completion:(void (^)(NSArray * _Nonnull))completion{ // 可根據不同銀行調整金額 completion(summaryItems); }

付款成功、蘋果服務器返回信息回調(做服務端驗證):

-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didAuthorizePayment:(PKPayment *)payment completion:(void (^)(PKPaymentAuthorizationStatus status))completion{ PKPaymentToken *payToken = payment.token; // 支付憑據,發給服務端驗證 PKContact *billingContact = payment.billingContact; PKContact *shippingContact = payment.shippingContact; PKContact *shippingMethod = payment.shippingMethod; dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{ completion(PKPaymentAuthorizationStatusSuccess); }); }

支付完成回調:

-(void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller{ [controller dismissViewControllerAnimated:YES completion:nil]; }

由於證書問題,demo 可能會報錯,但不影響大家閱讀代碼。demo 下載見原文。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved