ApplePay开发流程
一、线上支付集成步骤
1. 配置支付环境
使用XCode创建一个工程, 并设置好对应的BundleID
注册并配置一个商业标示符
添加一个App ID
配置Merchant ID
为Merchant ID 配置证书, 并下载证书安装到钥匙串
检查安装到钥匙串中的证书是否有效
绑定Merchant ID 到 APP ID
2. 配置Xcode 项目
调整系统最低部署版本(iOS8.0)
开启Apple Pay功能
3. 代码实现
判断当前设备是否可以支付
判断"Wallet有没有添加该支付网络的储蓄卡/信用卡"
创建一个支付请求, 并配置各项信息
弹出授权控制器,让用户给支付授权
处理支付凭证
4. 服务器处理
二、 具体步骤实现
1. 配置支付环境
使用XCode创建一个工程, 并设置好对应的BundleID
注册并配置一个商业标示符
(1)添加一个App ID, 并勾选Apple Pay功能
(2)配置Merchant ID
(3)为Merchant ID 配置证书, 并下载证书安装到钥匙串
(4)检查安装到钥匙串中的证书是否有效
问题描述: 有可能会出现
提示
问题原因: 系统根证书/中级证书颁发机构过期
解决方案: 重新下载证书, 并安装,具体下载列表看下图
(5)绑定Merchant ID 到 APP ID
2. 配置Xcode 项目
调整系统最低部署版本(iOS8.0)
开启Apple Pay功能
注意: 以上步骤截图, 只是关键处截图, 如果在具体细节处遇到问题, 欢迎关注公众号(王顺子),共同探讨。或者参照具体视频教程, 链接地址, 后续附上。
3.MAC下生成CSR(.certSigningRequest)文件
当在苹果开发者中心生成证书的时候需要一个CSR文件。
打开钥匙串访问工具,在钥匙串访问下拉菜单选中证书助理-》从证书颁发机构请求证书;
输入appId邮件地址、名称,选择存储到磁盘
步骤1:
CSR1.png
步骤2:
CSR2.png
步骤3:这里选取保存的位置是桌面,也可以选择自己喜欢的位置保存
CSR3.png
这样就生成了一个CSR文件:
CSR4.png
三、银联接入
银联服务平台:https://merchant.unionpay.com/join/index
(1)选择访问 “技术文档”TAB页查看相关技术文档
(2)点击访问“DEMO/SDK下载”可跳转至“银联Apple Pay控件开发包”下载界面
(3)ApplePay上线CSR证书获取
(1)什么是CSR文件?
接入银联Apple Pay在线支付的商户,须生成Apple Pay专用的CSR文件并提交至苹果开发者网站进行签名,以签署证书,取得Apple Pay的访问权限。在银联SDK模式中,银联代为商户生成CSR文件,商户可直接登录银联商户服务平台获取
(2)在申请银联Apple Pay接入时,银联的联系人会分配商户服务平台的登录权限及CSR的申请权限,请确认是否开通了Apple Pay接入权限。
(3)银联在商户服务平台中提供Apple Pay的CSR下载功能。登录后进入安全管理-CSR文件下载,点击“生成CSR”按钮,并将获取的CSR保存。CSR文件与商户代码一一对应,是交易安全保护的重要环节,请勿将CSR透露给无关人员。
(4)重置CSR后,原CSR即刻失效,应重新向苹果公司的网站提交新的CSR文件。
苹果官网https://developer.apple.com/apple-pay/
支付流程如下:
1-2、 商户生成订单,通过商户 SERVER 端将订单信息发送给银联支付网关; 3-4、银联支付网关记录订单信息,返回用来标识订单的 TN 号,经由商户 SERVER 返回至给 商户 APP;
5、 商户 APP 调用银联 SDK,将 TN 号传递给银联 SDK
6、 银联 SDK 向苹果公司的 PASSKIT FRAMEWORK 发起支付请求;
7、 接口返回加密的支付 Token 信息;
8-9、银联 SDK 将支付 Token 传递给银联支付网关,完成交易认证;
10-12、银联将支付结果返回给商户 APP,商户 SERVER,商户 APP 负责提示用户交易结果。
相信曾经接入过银联支付SDK的同学对这张图会比较熟悉,是的,这里的支付流程和之前几乎一模一样,只是多了银联SDK和PassKit交互的部分,之前的卡PIN输入变成了token获取。
银联也是提供了专为ApplePay封装的SDK,与Passkit之间的交互完全由银联来代理。
(5)将证书放入这个位置
(6)商户入网
(7)测试证书
四、代码实现
(1)判断当前设备是否可以支付
if(![PKPaymentAuthorizationViewController canMakePayments])
{
NSLog(@"不能支付");
return;
}
(2)判断"Wallet有没有添加该支付网络的储蓄卡/信用卡"
if(![PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:@[PKPaymentNetworkAmex, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa, PKPaymentNetworkChinaUnionPay]]) {
NSLog(@"Wallet没有添加该支付网络的储蓄卡/信用卡");
// 创建一个设置按钮
// PKPaymentButton *button = [PKPaymentButton buttonWithType:PKPaymentButtonTypeSetUp style:PKPaymentButtonStyleWhiteOutline];
// [button addTarget:self action:@selector(jump) forControlEvents:UIControlEventTouchUpInside];
// button.center = self.view.center;
// [self.view addSubview:button];
return;
}
(3)创建一个支付请求, 并配置各项信息
// 1. 创建一个支付请求
PKPaymentRequest *request = [[PKPaymentRequest alloc] init];
// 2. 参数配置
// 2.1 商店标识
request.merchantIdentifier = @"merchant.520it.com";
// 2.2 货币代码
request.currencyCode = @"CNY";
// 2.3 国家编码
request.countryCode = @"CN";
// 2.4 支持的支付网络(PKPaymentNetworkChinaUnionPay iOS9.2开始支持)
request.supportedNetworks = @[PKPaymentNetworkAmex, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa, PKPaymentNetworkChinaUnionPay];
// 2.5 支付请求包含一个支付摘要项目的列表
NSDecimalNumber*price1 = [NSDecimalNumberdecimalNumberWithString:@"2"];
PKPaymentSummaryItem *item1 = [PKPaymentSummaryItem summaryItemWithLabel:@"手榴弹"amount:price1];
NSDecimalNumber*price2 = [NSDecimalNumberdecimalNumberWithString:@"6"];
PKPaymentSummaryItem *item2 = [PKPaymentSummaryItem summaryItemWithLabel:@"炸弹"amount:price2 type:PKPaymentSummaryItemTypePending];
NSDecimalNumber*totalAmount = [NSDecimalNumberzero];
totalAmount = [totalAmount decimalNumberByAdding:price1];
totalAmount = [totalAmount decimalNumberByAdding:price2];
PKPaymentSummaryItem *total = [PKPaymentSummaryItem summaryItemWithLabel:@"小码哥财务中心"amount:totalAmount type:PKPaymentSummaryItemTypePending];
// 注意: 数组最后一个是总价格
request.paymentSummaryItems = @[item1, item2, total];
// 2.6 运输方式
NSDecimalNumber*shippingPrice = [NSDecimalNumberdecimalNumberWithString:@"18.0"];
PKShippingMethod *method = [PKShippingMethod summaryItemWithLabel:@"顺丰快递"amount:shippingPrice];
method.detail = @"24小时送到!";
method.identifier = @"shunfeng";
request.shippingMethods = @[method];
request.shippingType = PKShippingTypeServicePickup;
// 2.7 通过指定merchantCapabilities属性来指定你支持的支付处理标准,3DS支付方式是必须支持的,EMV方式是可选的,
request.merchantCapabilities = PKMerchantCapability3DS | PKMerchantCapabilityEMV | PKMerchantCapabilityCredit | PKMerchantCapabilityDebit;
// 2.8 需要的配送信息和账单信息
request.requiredBillingAddressFields = PKAddressFieldAll;
request.requiredShippingAddressFields = PKAddressFieldAll;
// 2.9 存储额外信息
// 使用applicationData属性来存储一些在你的应用中关于这次支付请求的唯一标识信息,比如一个购物车的标识符。在用户授权支付之后,这个属性的哈希值会出现在这次支付的token中。
request.applicationData = [@"购物车ID: 123456"dataUsingEncoding:NSUTF8StringEncoding];
(4)弹出授权控制器,让用户给支付授权
// 3. 开始支付
PKPaymentAuthorizationViewController *paymentPane = [[PKPaymentAuthorizationViewController alloc] initWithPaymentRequest:request];
if(paymentPane ==nil) {
NSLog(@"授权控制器创建失败");
return;
}
paymentPane.delegate =self;
[selfpresentViewController:paymentPane animated:YEScompletion:nil];
(5)处理支付凭证(token)
/**
* 当授权成功之后会调用这个代理方法
*/
- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
didAuthorizePayment:(PKPayment *)payment
completion:(void(^)(PKPaymentAuthorizationStatus status))completion;
{
// PKPayment *temp = payment;
NSLog(@"验证授权---%@", payment.token);
NSLog(@"验证通过后, 需要开发者继续完成交易");
// 它需要你连接服务器并上传支付令牌和 其他信息,以完成整个支付流程。
BOOLisSuccess =YES;
if(isSuccess) {
completion(PKPaymentAuthorizationStatusSuccess);
}else
{
completion(PKPaymentAuthorizationStatusFailure);
}
}
(6)关闭授权控制器
/**
* 当授权成功之后或者取消授权之后会调用这个代理方法
*/
- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller
{
NSLog(@"取消或者交易完成");
[selfdismissViewControllerAnimated:YEScompletion:nil];
}
* 支付授权的流程:
框架发送支付请求给安全模块,只有安全模块可以访问存储在设备上的标记化的卡信息。
安全模块把特定的卡和商家等支付数据加密,以保证只有苹果可以读取,然后发送给框架。框架会将这些数据发送给苹果。
苹果服务器再次加密这些支付数据,以保证只有商家可以读取。然后服务器对它进行签名,生成支付token,然后发送给设备。
框架调用相应的代理方法并传入这个token,然后你的代理方法传送token给你的服务器。
4. 服务器接收到token后的一般处理流程
验证支付数据的哈希表和签名
为加密过的支付数据解码
向支付处理系统提交支付数据
向订单追踪系统提交订单
处理支付请求时,你有两个选择;你既可以利用支付平台处理支付请求,也可以自己实现支付请求处理流程。一个常用的支付平台可以完成上述大部分操作。
关于支持Apple Pay支付平台的更多信息,请参考developer.apple.com/apple-pay/
Demo下载地址:https://github.com/YasinZhou/ApplePayDemo