Apple Pay接入详细教程

简介: <p style="margin-top:0px; margin-bottom:20px; padding-top:0px; padding-bottom:0px; color:rgb(37,37,37); font-family:'Helvetica Neue',Helvetica,STheiti,微软雅黑,黑体,Arial,Tahoma,sans-serif,serif; font-s

Apple Pay运行环境:iPhone6以上设备,操作系统最低iOS9.0以上,部分信息设置需要iOS9.2以上。目前还不支持企业证书添加。

环境搭建好后可以在模拟器上面运行,xcode7.2.1+iPhone6SP9.2系统下,系统会绑定几种虚拟的银行卡,和几个联系人,方便调试,支付也不会发生真实的付款,真的很方便。

准备工作

在接入Apple Pay之前,首先要申请MerchantID及对应证书。(请移步我写的申请MerchantID及对应证书详细图文教程

工程设置

  • bundleID设置

1024259-16fff81828406887.png

Capability中启用Apple Pay权限,并选择merchantID。

1024259-21c046559eb3d59a.png

之后项目会多一个Applepay的配置文件ApplePayYasin.entitlements

1024259-35739a7c9011a540.png

  • 需要引用的库

Xcode7.0以上不需要再手动添加需要引用的库了,只需要导入头文件就可以了

1
2
3
#import <passkit passkit.h="">                                 //用户绑定的银行卡信息
#import <passkit pkpaymentauthorizationviewcontroller.h="">    //Apple pay的展示控件
#import <addressbook addressbook.h="">                         //用户联系信息相关</addressbook></passkit></passkit>
  • 设备Applepay权限检测

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
if  (![PKPaymentAuthorizationViewController class]) {
         //PKPaymentAuthorizationViewController需iOS8.0以上支持
         NSLog(@ "操作系统不支持ApplePay,请升级至9.0以上版本,且iPhone6以上设备才支持" );
         return ;
     }
     //检查当前设备是否可以支付
     if  (![PKPaymentAuthorizationViewController canMakePayments]) {
         //支付需iOS9.0以上支持
         NSLog(@ "设备不支持ApplePay,请升级至9.0以上版本,且iPhone6以上设备才支持" );
         return ;
     }
     //检查用户是否可进行某种卡的支付,是否支持Amex、MasterCard、Visa与银联四种卡,根据自己项目的需要进行检测
     NSArray *supportedNetworks = @[PKPaymentNetworkAmex, PKPaymentNetworkMasterCard,PKPaymentNetworkVisa,PKPaymentNetworkChinaUnionPay];
     if  (![PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:supportedNetworks]) {
         NSLog(@ "没有绑定支付卡" );
         return ;
     }

创建支付请求PKPaymentRequest

  • 初始化PKPaymentRequest

这里需要注意RMB的币种代码是CNY

1
2
3
4
5
6
7
//设置币种、国家码及merchant标识符等基本信息
   PKPaymentRequest *payRequest = [[PKPaymentRequest alloc]init];
   payRequest.countryCode = @ "CN" ;      //国家代码
   payRequest.currencyCode = @ "CNY" ;        //RMB的币种代码
   payRequest.merchantIdentifier = @ "merchant.ApplePayDemoYasin" ;   //申请的merchantID
   payRequest.supportedNetworks = supportedNetworks;    //用户可进行支付的银行卡
   payRequest.merchantCapabilities = PKMerchantCapability3DS|PKMerchantCapabilityEMV;       //设置支持的交易处理协议,3DS必须支持,EMV为可选,目前国内的话还是使用两者吧
  • 设置发票配送信息和货物配送地址信息,用户设置后可以通过代理回调代理获取信息的更新

1
2
3
4
5
// payRequest.requiredBillingAddressFields = PKAddressFieldEmail;   
//如果需要邮寄账单可以选择进行设置,默认PKAddressFieldNone(不邮寄账单)
//楼主感觉账单邮寄地址可以事先让用户选择是否需要,否则会增加客户的输入麻烦度,体验不好,
   payRequest.requiredShippingAddressFields = PKAddressFieldPostalAddress|PKAddressFieldPhone|PKAddressFieldName;
   //送货地址信息,这里设置需要地址和联系方式和姓名,如果需要进行设置,默认PKAddressFieldNone(没有送货地址)

1024259-43c63c7a57cc2a08.png

送货信息页面展示

设置货物的配送方式,不需要不配置

1
2
3
4
5
6
7
8
9
10
//设置两种配送方式
   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];

1024259-c8a390d491efc6ef.png

1024259-ff33c2d6e59a960b.png

  • 账单信息的设置

每条账单的设置

账单列表使用PKPaymentSummaryItem添加描述和价格,价格使用NSDecimalNumber。

PKPaymentSummaryItem初始化:

label为商品名字或者是描述,amount为商品价格,折扣为负数,type为该条账单为最终价格还是估算价格(比如出租车价格预估)

1
2
+ (instancetype)summaryItemWithLabel:(NSString *)label amount:(NSDecimalNumber *)amount;
+ (instancetype)summaryItemWithLabel:(NSString *)label amount:(NSDecimalNumber *)amount type:(PKPaymentSummaryItemType)type NS_AVAILABLE(NA, 9_0);

NSDecimalNumber初始化:

NSDecimalNumber可以使用数字初始化,也可以使用字符串。

使用方法请移步我写的NSDecimalNumber--十进制数

添加账单列表:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
NSDecimalNumber *subtotalAmount = [NSDecimalNumber decimalNumberWithMantissa:1275 exponent:-2 isNegative:NO];    //12.75
PKPaymentSummaryItem *subtotal = [PKPaymentSummaryItem summaryItemWithLabel:@ "商品价格"  amount:subtotalAmount];
 
NSDecimalNumber *discountAmount = [NSDecimalNumber decimalNumberWithString:@ "-12.74" ];       //-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]];
//summaryItems为账单列表,类型是 NSMutableArray,这里设置成成员变量,在后续的代理回调中可以进行支付金额的调整。
payRequest.paymentSummaryItems = summaryItems;

显示购物信息并进行支付

1
2
3
4
//ApplePay控件
     PKPaymentAuthorizationViewController *view = [[PKPaymentAuthorizationViewController alloc]initWithPaymentRequest:payRequest];
     view.delegate = self;
     [self presentViewController:view animated:YES completion:nil];

PKPaymentAuthorizationViewControllerDelegate代理

  • 这里还有两个类要介绍

PKPayment 支付成功信息

1
2
3
4
5
PKPaymentToken *payToken = payment.token;
//支付凭据,发给服务端进行验证支付是否真实有效
PKContact *billingContact = payment.billingContact;      //账单信息
PKContact *shippingContact = payment.shippingContact;    //送货信息
PKContact *shippingMethod = payment.shippingMethod;      //送货方式

PKContact 联系人信息

1
2
3
4
5
NSPersonNameComponents *name = contact.name;                 //联系人姓名
CNPostalAddress *postalAddress = contact.postalAddress;      //联系人地址
NSString *emailAddress = contact.emailAddress;               //联系人邮箱
CNPhoneNumber *phoneNumber = contact.phoneNumber;            //联系人手机
NSString *supplementarySubLocality = contact.supplementarySubLocality;   //补充信息,地址详细描述,其他备注等等,iOS9.2及以上才有
  • 代理说明

送货地址回调

1
2
3
4
5
6
7
-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                 didSelectShippingContact:(PKContact *)contact
                               completion:(void (^)(PKPaymentAuthorizationStatus, NSArray<pkshippingmethod *> * _Nonnull, NSArray<pkpaymentsummaryitem *> * _Nonnull))completion{
   //contact送货地址信息,PKContact类型
   //送货信息选择回调,如果需要根据送货地址调整送货方式,比如普通地区包邮+极速配送,偏远地区只有付费普通配送,进行支付金额重新计算,可以实现该代理,返回给系统:shippingMethods配送方式,summaryItems账单列表,如果不支持该送货信息返回想要的PKPaymentAuthorizationStatus
   completion(PKPaymentAuthorizationStatusSuccess, shippingMethods, summaryItems);
}</pkpaymentsummaryitem *></pkshippingmethod *>

送货方式回调

1
2
3
4
5
6
7
8
9
10
11
12
13
-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                  didSelectShippingMethod:(PKShippingMethod *)shippingMethod
                               completion:(void (^)(PKPaymentAuthorizationStatus, NSArray<pkpaymentsummaryitem *> * _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);
}</pkpaymentsummaryitem *>

支付卡选择回调

1
2
3
4
-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectPaymentMethod:(PKPaymentMethod *)paymentMethod completion:(void (^)(NSArray<pkpaymentsummaryitem *> * _Nonnull))completion{
   //支付银行卡回调,如果需要根据不同的银行调整付费金额,可以实现该代理
   completion(summaryItems);
}</pkpaymentsummaryitem *>

送货地址回调,已弃用

1
2
3
-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectShippingAddress:(ABRecordRef)address completion:(void (^)(PKPaymentAuthorizationStatus, NSArray<pkshippingmethod *> * _Nonnull, NSArray<pkpaymentsummaryitem *> * _Nonnull))completion{
   //送货地址回调,已弃用
}</pkpaymentsummaryitem *></pkshippingmethod *>

付款成功苹果服务器返回信息回调,做服务器验证

1
2
3
4
5
6
7
8
9
10
11
12
13
14
-(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;      //送货方式
   //等待服务器返回结果后再进行系统block调用
   dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
       //模拟服务器通信
       completion(PKPaymentAuthorizationStatusSuccess);
   });
}

支付完成回调

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

demo的话因为证书问题可能会报错,不过大家可以看看代码。

https://github.com/SummertimSadness/ApplePayDemo


目录
相关文章
|
2月前
|
iOS开发 开发者 MacOS
windows 制作 apple 苹果证书 -appuploader​
windows 制作 apple 苹果证书 -appuploader​
|
3月前
|
数据安全/隐私保护 iOS开发 开发者
注册苹果开发者账号步骤揭秘,创建证书全攻略
注册苹果开发者账号步骤揭秘,创建证书全攻略
|
3月前
|
开发者 iOS开发
苹果上架常见问题 -appstore 开发者名称修改
苹果上架常见问题 -appstore 开发者名称修改
|
6月前
|
存储 Java 机器人
关于apple上架常见问题汇总
关于apple上架常见问题汇总
|
6月前
|
Web App开发 开发者
最新苹果开发者账号添加设备UDID​
最新苹果开发者账号添加设备UDID​
|
6月前
|
安全 Go 数据安全/隐私保护
免费升级到 iOS 17 Developer Beta:官方Apple Store升级方案与爱思助手方法比较
免费升级到 iOS 17 Developer Beta:官方Apple Store升级方案与爱思助手方法比较
225 0
|
11月前
|
Java 测试技术 Android开发
Sonic 开源移动端云真机测试平台 - 设备中心接入安卓设备实例演示,Agent端服务部署过程详解(下)
Sonic 开源移动端云真机测试平台 - 设备中心接入安卓设备实例演示,Agent端服务部署过程详解
285 0
|
11月前
|
Web App开发 JavaScript Java
Sonic 开源移动端云真机测试平台 - 设备中心接入安卓设备实例演示,Agent端服务部署过程详解(上)
Sonic 开源移动端云真机测试平台 - 设备中心接入安卓设备实例演示,Agent端服务部署过程详解
372 0
|
Web App开发 弹性计算 Android开发
阿里云无影云桌面客户端下载Win/Mac/iOS/安卓/Web端均支持
阿里云无影客户端下载系统Win/Mac/iOS/安卓/Web端均支持
3575 0
阿里云无影云桌面客户端下载Win/Mac/iOS/安卓/Web端均支持
|
数据安全/隐私保护 Android开发 iOS开发
免费苹果账号(apple id)申请ios证书p12真机调试
免费苹果账号(apple id)申请ios证书p12真机调试