Apple Pay 详细集成文档
Apple pay刚推出的时候可以说“绑定的过程很崩溃,用的时候很心碎”,为什么要这样说呢?因为刚一推出,就有大量的人同时绑定,银行和银联又处理不过来,就会出现以下界面,用的时候很心碎是指太TMD方便了,几百块说没就没呀,你说心碎不!哭:
一:适用于以下设备
注:操作系统必须iOS9.2以上版本watch OS 2.1以上版本,可以在模拟器上面运行,xcode7.2.1以上 + iPhone6S 以上 + 9.2系统以上,系统会绑定几种虚拟的银行卡,和几个联系人,方便调试,支付也不会发生真实的付款。
二:金融交易分为:在线远程支付和近场支付
1.在线远程支付:是指在应用内完成物品的购买,一般在电商应用内比较常见(Apple Pay 远程支付商户入网采取大商户、大行业优先、直联接入优先的原则。同时, 优先发展零售业、住宿/餐饮和休闲娱乐业、居民服务和商业服务、教育/卫生行业。暂时限制接 入互联网金融(基金、理财、直销银行、P2P、信贷还款、融资租赁等)、信用卡还款、货款回 缴、烟草、房地产、彩票以及其他苹果公司限制接入 Apple Pay 的行业及应用场景
)。
环境配置:在接入Apple Pay之前,首先要申请MerchantID。
第一步:首先明确,你要为哪一个应用做或者增加Apple Pay功能:
第二步:使该应用具备Apple Pay的能力:
第三步:配置Merchant IDs
这时回到你的应用,选择上面配置好的Merchant IDs
当你完成上面操作时,再回到apple ID时,这时查看你的应用你会发现如下界面:
到这里环境配置已经完毕。
二:代码体现
1.首先导入头文件:
#import <PassKit/PassKit.h> //包含用户绑定的银行卡信息
#import <PassKit/PKPaymentAuthorizationViewController.h> //Apple pay的展示控制器
#import <AddressBook/AddressBook.h> //用户联系的相关信息
2.代码展示
//点击支付按钮要执行的事件
- (IBAction)ApplePayBtnClicked:(id)sender {
if (![PKPaymentAuthorizationViewController class]) {
//PKPaymentAuthorizationViewController需iOS8.0以上支持
NSLog(@"操作系统不支持ApplePay,请升级至9.0以上版本,且iPhone6以上设备才支持");
return;
}
//检查当前设备是否可以支付
if (![PKPaymentAuthorizationViewController canMakePayments]) {
//支付需iOS9.0以上支持
NSLog(@"设备不支持ApplePay,请升级至9.0以上版本,且iPhone6以上设备才支持");
return;
}
//创建支付请求
//设置币种、国家码及merchant标识符等基本信息
PKPaymentRequest *payRequest = [[PKPaymentRequest alloc]init];
payRequest.countryCode = @"CN"; //国家代码
payRequest.currencyCode = @"CNY"; //RMB的币种代码
payRequest.merchantIdentifier = @"申请的merchantID"; //申请的merchantID
//配置请求的支付网络
//检查用户是否可进行某种卡的交易,是否支持Amex、MasterCard、Visa与银联四种卡,根据项目需要进行校验
NSArray *supportedNetworks = @[PKPaymentNetworkAmex, PKPaymentNetworkMasterCard,PKPaymentNetworkVisa,PKPaymentNetworkChinaUnionPay];
if (![PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:supportedNetworks]) {
NSLog(@"你需要绑定支付卡");
return;
}
payRequest.supportedNetworks = supportedNetworks; //用户可进行支付的银行卡
payRequest.merchantCapabilities = PKMerchantCapability3DS|PKMerchantCapabilityEMV; //设置支持的交易处理协议,3DS必须支持,EMV为可选,目前国内的话还是使用两者吧
// payRequest.requiredBillingAddressFields = PKAddressFieldEmail;
//如果需要邮寄账单可以选择进行设置,默认PKAddressFieldNone(不邮寄账单)
payRequest.requiredShippingAddressFields = PKAddressFieldPostalAddress|PKAddressFieldPhone|PKAddressFieldName;
//送货地址信息,这里设置需要地址和联系方式和姓名,如果需要进行设置,默认PKAddressFieldNone(没有送货地址)
//
//设置配送方式可以设置多种供用户选择
PKShippingMethod *free = [PKShippingMethod summaryItemWithLabel:@"顺丰包邮" amount:[NSDecimalNumber zero]];
free.identifier = @"free";
free.detail = @"一天内送达";
PKShippingMethod *quick = [PKShippingMethod summaryItemWithLabel:@"极速送达" amount:[NSDecimalNumber decimalNumberWithString:@"15.00"]];
quick.identifier = @"quick";
quick.detail = @"1 小时内 送达";
// self.shippingMethod = [NSMutableArray arrayWithCapacity:@[free,quick]];
//shippingMethods为配送方式列表,类型是 NSMutableArray,这里设置成成员变量,在后续的代理回调中可以进行配送方式的调整。
payRequest.shippingMethods = @[free,quick];
NSDecimalNumber *subtotalAmount = [NSDecimalNumber decimalNumberWithMantissa:8888 exponent:-2 isNegative:NO]; //88.88
PKPaymentSummaryItem *subtotal = [PKPaymentSummaryItem summaryItemWithLabel:@"商品价格" amount:subtotalAmount];
NSDecimalNumber *discountAmount = [NSDecimalNumber decimalNumberWithString:@"-66.66"]; //-66.66
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:@"Obama" amount:totalAmount]; //要支付给谁
summaryItems = [NSMutableArray arrayWithArray:@[subtotal, discount, methods, total]];
//summaryItems为账单列表,类型是 NSMutableArray,这里设置成成员变量,在后续的代理回调中可以进行支付金额的调整。
payRequest.paymentSummaryItems = summaryItems;
//ApplePay控件
PKPaymentAuthorizationViewController *view = [[PKPaymentAuthorizationViewController alloc]initWithPaymentRequest:payRequest];
//view可能创建不成功,因为payRequest可能创建失败或无效
if (!view) {
return;
}
view.delegate = self;
[self presentViewController:view animated:YES completion:nil];
}
#pragma mark - 授权的代理方法
//controller:授权控制器
//payment:支付对象 token,address地址
//completion:系统给定一个代码块,执行这个代码块,来告诉当前的支付状态是否成功
- (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; //送货方式
//在这里将token,送货信息,送货方式发送到自己的服务器,自己的服务器和银行与商家对接支付,并将结果防回到这里,根据结果生成对应的状态对象,根据状态对象显示不同的支付结果
//等待服务器返回结果后再进行系统block调用
//状态对象
BOOL isSuccessed = YES;
if (isSuccessed) {
completion(PKPaymentAuthorizationStatusSuccess);
}else{
completion(PKPaymentAuthorizationStatusFailure);
}
}
//当授权结束或取消支付,就会调用该方法
- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller{
NSLog(@"授权结束");
//让展示界面消失
[controller dismissViewControllerAnimated:YES completion:nil];
}
//该方法可以选择实现
//- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
// didSelectShippingContact:(PKContact *)contact
// completion:(void (^)(PKPaymentAuthorizationStatus, NSArray<PKShippingMethod *> * _Nonnull, NSArray<PKPaymentSummaryItem *> * _Nonnull))completion{
// //contact送货地址信息,PKContact类型
// NSPersonNameComponents *name = contact.name; //联系人姓名
// CNPostalAddress *postalAddress = contact.postalAddress; //联系人地址
// NSString *emailAddress = contact.emailAddress; //联系人邮箱
// CNPhoneNumber *phoneNumber = contact.phoneNumber; //联系人手机
// NSString *supplementarySubLocality = contact.supplementarySubLocality; //补充信息,iOS9.2及以上才有
//
// //送货信息选择回调,如果需要根据送货地址调整送货方式,比如普通地区包邮+极速配送,偏远地区只有付费普通配送,进行支付金额重新计算,可以实现该代理,返回给系统:shippingMethods配送方式,summaryItems账单列表,如果不支持该送货信息返回想要的PKPaymentAuthorizationStatus
// completion(PKPaymentAuthorizationStatusSuccess, self.shippingMethod, summaryItems);
//}
//该方法根据实际情况,选择实现
//- (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);
//}
//根据需求,选择实现。支付银行卡回调,如果需要根据不同的银行调整付费金额,可以实现该代理
//-(void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectPaymentMethod:(PKPaymentMethod *)paymentMethod completion:(void (^)(NSArray<PKPaymentSummaryItem *> * _Nonnull))completion{
//
// completion(summaryItems);
//}
二:金融交易之近场支付(目前银行类客户端比较常见)
在银行类客户端中基本都是跳到wallet应用( [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“shoebox://“]];),以后的操作都有用户自己管理。当然银行自己的App也可以对卡进行一些:挂失,解挂,注销等操作,因每个银行需求不一样,至于在银行客户端中怎样进行挂失,解挂等,行内人员(主要tsm系统)提供接口,页面设计有行内决定,有开发人员自行开发。