最近的项目需求中有集成ApplePay的需求,先前看了点资料,觉得过程so easy,没太多需要注意的地方,也就没太当回事,哪知到了真正集成的时候,简直……[ sàng xīn bìng kuáng ]
集成apple pay需要的资料:
https://developer.apple.com/apple-pay/
about Apple Pay
Apple Pay 安全性与隐私政策概览
一、集成前置步骤
二、集成
三、坑
一、集成前置步骤:
这里比较简单,主要是支付证书的配置,就不细写了,进入开发者中心:
- 注册 Merchant IDs(商户ID),上传CSR文件(钥匙链证书助理生成),生成支付证书
- 在App IDs中创建或找到已有的App ID 进行编辑Edit,打开Apple Pay功能,Edit,选中已经生成好的Merchant ID(可以多选),点Continue
- 在Xcode中配置,TARGETS -->Capabilities,找到Apple Pay 打开这个功能
如果这些步骤没有问题的话,那么现在的看到的是这样:
如果Steps里面的3个小勾都有的话,那就说明配置OK。
同时项目中出现了这个东东:
配置没有问题了,那么接下来就要写代码了
二、集成
1、对当前支付环境进行判断,是否可以进行苹果支付
- (BOOL)isCanMakeApplePayments {
if (IOS9.2) {
if ([PKPaymentAuthorizationViewController canMakePayments]) {
if ([PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:@[PKPaymentNetworkChinaUnionPay]]) {
return YES;
} else {
return NO;
}
}
}
return NO;
}
2、创建支付请求
PKPaymentRequest *request = [[PKPaymentRequest alloc] init];
// 配置商家ID
request.merchantIdentifier = @"merchant.mailegouapplepay.com";
// 配置货币代码, 以及国家代码
request.countryCode = @"CN";
request.currencyCode = @"CNY";
// 配置请求支持的支付网络 银联
request.supportedNetworks = @[PKPaymentNetworkChinaUnionPay];
// 配置商户的处理方式 3DS必须支持
request.merchantCapabilities = PKMerchantCapabilityEMV|PKMerchantCapability3DS;
// 配置购买的商品列表
PKPaymentSummaryItem *orderAmout = [PKPaymentSummaryItem summaryItemWithLabel:@"订单金额" amount:[NSDecimalNumber decimalNumberWithString:self.payModel.orderSum]];
PKPaymentSummaryItem *totalAmount = [PKPaymentSummaryItem summaryItemWithLabel:@"麦乐购" amount:[NSDecimalNumber decimalNumberWithString:self.payModel.orderSum]];
// 注意: 支付列表最后一个, 代表汇总
request.paymentSummaryItems = @[orderAmout,totalAmount];
以上这些配置是必须的,当然还有一些可选的,比如物流信息、发票地址等等,像下面这样:
// 是否显示发票收货地址, 显示哪些选项
request.requiredBillingAddressFields = PKAddressFieldAll;
// 是否显示快递地址, 显示哪些选项
request.requiredShippingAddressFields = PKAddressFieldAll;
// 配置快递方式NSArray<PKShippingMethod *>
NSDecimalNumber *price2 = [NSDecimalNumber decimalNumberWithString:@"18.0"]; // 邮费
PKShippingMethod *method = [PKShippingMethod summaryItemWithLabel:@"顺丰快递" amount:price2];
method.detail = @"24小时内送到";
method.identifier = @"shunfeng";
NSDecimalNumber *price3 = [NSDecimalNumber decimalNumberWithString:@"0.1"];
PKShippingMethod *method2 = [PKShippingMethod summaryItemWithLabel:@"韵达快递" amount:price3];
method2.identifier = @"yunda";
method2.detail = @"送货上门";
request.shippingMethods = @[method, method2];
// 配置快递的类型
request.shippingType = PKShippingTypeStorePickup;
// 添加一些附加数据
request.applicationData = [@"buyID=12345" dataUsingEncoding:NSUTF8StringEncoding];
3、配置完成,验证支付授权:
实现 PKPaymentAuthorizationViewControllerDelegate 代理,必须实现的两个代理方法为:
- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
didAuthorizePayment:(PKPayment *)payment
completion:(void (^)(PKPaymentAuthorizationStatus status))completion
{
//支付所需要的token
NSData *data = payment.token.paymentData;
NSString *paymentDataStr = [[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
//收货人地址
NSString *street = payment.shippingContact.postalAddress.street;
//收货人电话
NSString *phone = payment.shippingContact.phoneNumber.stringValue;
//收货人邮编
NSString *post = payment.shippingContact.postalAddress.postalCode;
//收货人姓名
NSString *familyName = payment.shippingContact.name.familyName;
NSString *givenName = payment.shippingContact.name.givenName;
/** 支付完成后需要在此代理方法中告诉苹果支付结果用于UI显示,如:*/
// 支付成功 PKPaymentAuthorizationStatus是枚举,里面有各种支付结果状态
completion(PKPaymentAuthorizationStatusSuccess);
}
// 当用户授权成功, 或者取消授权时调用
- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller {
[self dismissViewControllerAnimated:controller completion:nil];
}
三、坑
1、PKPaymentNetworkChinaUnionPay
if ([PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:@[PKPaymentNetworkChinaUnionPay]]) {
return YES;
}
PKPaymentNetworkChinaUnionPay这个字段是9.2增加的,也就是说国内使用银联渠道进行apple pay SDK需要是9.2以上,在这个判断之前需要对系统版本加以判断,以免程序崩溃。
2、[PKPaymentAuthorizationViewController canMakePayments]
由于项目中比较复杂的业务逻辑和成年累月的积累,旧的结构不好改动,一开始这个判断我是在选择苹果支付以后再去执行,如果返回NO,告诉用户不可以进行apple pay,返回YES就继续,很惊奇的发现,在我的手机上(iPhone6 9.2)上,这个方法每次返回的不一样,有时候YES 有时候NO,即使我已经在Wallet中绑上了符合要求的银联卡,在完全符合支付条件的情况下,这个方法还是会返回NO,而且是一阵一阵的,某一个时间内,全部是NO。就像神经病人发作一样。后面参考了一些别人Demo,我把这个判断放在了ViewDidLoad。返回NO就隐藏apple pay的选项,YES照常进行。这时这个方法的判断结果基本都是准确的,极偶尔的情况下会返回跟预想不一致的情况。到现在还没有找到原因~~希望后面可以找到。
3、代理方法不执行
- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
didAuthorizePayment:(PKPayment *)payment
completion:(void (^)(PKPaymentAuthorizationStatus status))completion;
这个代理方法是在弹出了PKPaymentAuthorizationViewController以后,按了正确的指纹或者输入密码后执行的(某些银行的卡还需要在输入指纹后输入银行卡支付密码)。都输入以后,等了2-3秒,PKPaymentAuthorizationViewController dismiss了,而上面的代理方法没有执行。这时第一就是检查一下代理的设置是否正确,如何确定呢,就是看另一个代理方法
- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller;
如果这个方法在取消时正常执行,不要着急,十有八九是苹果的服务器抽抽了,等一阵子就好了,等多长时间估计乔布斯也不知道。
4、如图所示
弹出PKPaymentAuthorizationViewController控制器后,下方一直显示正在处理的字样,而不是用Touch ID支付的指纹图标,经常这个圈转一会程序就崩溃掉了。这时需要看看是不是除了必须实现的这两个代理方法,是不是还实现了其它非必须实现的代理方法并且没有按要求实现。因为apple pay这一块的代理方法名字比较长,长的也比较像,需要认真检查一下。
5、自己碰到的奇怪符号
后面返回的json中,有这样一个东东
在控制台里不显示,复制出来也没有,只有用Beyond Compare这个软件才能看到。这个看不见的符号导致请求失败。目前还不知道这个鬼符号是什么鬼。
6、与第三方支付服务提供商对接
- 1、一定要确认好请求第三方sdk时的参数
比如我们这边,主要是跨境电商,对于我们对接的第三方支付服务提供商,就有跨镜服务,跨镜贸易等不同类型,需要传的参数不一样,而涉及到报关,国家政策调整,这些参数还会发生改变,而很多时候,国企提供的集成文档都不是最新的,很多东西没有。所以当支付请求失败时,需要第一时间联系支付服务提供商这边的技术人员进行确认,少走弯路。 - 2、沟通成本
与国企的工作人员进行沟通时,基本是问一句回一句,很多时间还不是及时回复,一个简单的问题沟通下来的时间可能是几天,(当然现在很多公司都是这样,不是单黑国企)如果公司离的不远,最好是将问题汇总,登门当面讨论,效率会BIU BIU的上升。 -
3、上传第三方支付服务商用到的私钥
我们合作的首信易支付公司需要的私钥是这样的:
是从CSR文件生成时产生的专用密钥这里导出p12用于上传,而不是和平常见的推送之类的,从证书处导出p12。各家公司要求不同,需要问清楚。