ApplePay高调入华,教你在app里上线ApplePay


博客原文链接: http://zyden.vicp.cc/applepay/


ApplePay在中国上线后,就有许多线上app前后脚加入了对其的接入支持,个人比较喜欢的ENJOY也抢在首批接入了ApplePay应用内支付。本文将分享作者的接入经验。

ApplePay是苹果公司推出的一种线上/线下的便捷支付方式,根据TouchId来验证支付卡持卡人身份,ApplePay并不参与资金流动,最终还是让银行完成扣款处理,目前据Apple介绍只配备在iphone6以上和新款的ipad Air2和ipad mini3上,中国地区最低系统要求为IOS9.2,对于一种新支付体验,这门槛的确有点高了。苹果开发文档对ApplePay工作方式的介绍.



线下支付使用NFC POST机只需要与银联联系签约租用即可,我们来介绍线上支付的流程和app应用内接入的方法。

目前的接入方式有两种,一是使用第三方提供商的SDK接入,另一种是让PassKit Framework直接与银联的接口对接,当然网络上还有一些自己使用PassKit PaymentRequest自己生成订单组织信息,直接与Apple对接的Demo,因为我们不可能每家银行跑去签约,大陆的银行也不会给我们开放特许,因此这种方式仅仅能用于测试ApplePay的功能和API尝鲜,并不适用于生产中。
ApplePay官网上有列出中国目前支持并提供SDK的第三方提供商

使用第三方SDK接入的优点是开发成本比较低,并且各自都应该有高度定制的Payment Sheet(因订单信息完整度的不同),可供定制更详细的商品信息展示,缺点就是要钱。
若我们选择后者,相对开发成本会高,移动端不仅需要对支持性进行验证,协商银联接口数据对Payment Sheet的展示关闭进行控制,对各种异常进行捕抓和处理,同时后台需要自己实现对银联接口的认证交互,对交易数据的标准封装,订单状态的处理,支付信息的解密等。


我们选择使用银联SDK接入这种折中的方式,免费,工作量可以接受。

使用银联SDK接入的实现方式如图所示,主要工作是商户后台利用现成的API与银联的交互:




申请MerchantID并更新你的证书:

向苹果申请我们独有的商户ID,这里我借用Yasin朋友在简书上分享的详细步骤,真的很详细易懂。

获得MerchantId后,更新你的证书,并且于项目->targets->Capabilities中打开ApplePay权限,选择正确的MerchantID,让三个steps成为tick状态完全权限的配置。





ok开始与银联碰头,于银联商家技术服务中心找到ApplePay入口,然后在"技术文档"选项卡中可以找到相应的SDK和后台文档。





这里我使用PHP后台,在下载的SDK压缩包里找到了PHP Version SDK,忽略掉这个外壳,我们需要将子文件夹upacp_demo_app部署到我们的服务器中。





这里我将upacp_demo_app部署到我mac的PHP环境中,打开upacp_demo_app/demo/api_05_app可以看见各种对订单处理的接口。



订单的创建,取消,查询,退款等,现在我们测试下创建订单接口


订单参数

下图是创建订单的请求参数,目前银联创建ApplePay订单仅支持图中所示的参数字段,基本满足使用但可定制性比较低,最基本的订单参数merId商户号,orderId订单号,txnTime订单发送时间,txnAmt订单金额,目前测试阶段我们可以通过直接调用此接口post传参,也可以直接写死在php文件中

  • 注意:这里的merId是银联商户号,而非苹果分配的MerchantID。


测试证书

了解到这里后还没有具备生成订单的条件,然后我们需要配置配置签名证书和验签证书的路径,这些证书在SDK下载包里面已经有附带,我们只需要在upacp_demo_app/sdk/SDKConfig.php文件中配置好他们的路径即可


这里需要配置主机的绝对路径,不能使用项目相对路径,完成SDK_SIGN_CERT_PATH,SDK_ENCRYPT_CERT_PATH,SDK_VERIFY_CERT_DIR路径的配置


成功获取tn

我们请求下Form_6_2_AppConsume.php接口,即可创建订单,并且返回对应的Trade Name,在App端我们就是拿这个Trade Name来对相应的订单进行付款。


拿到订单tn后,我们已经可以使用银联SDK调起支付,在这之前还要做的就是对设备和平台的支持性检测,通过,present出Payment Sheet即可。

工程配置:

1.添加SDK包:
将下载SDK解压包中找到applePaySDK文件夹,加入到需要接入ApplePay的项目中。


**这里注意,项目内如果同时支持银联普通支付的话,因为两个库引用重复,最好的办法就是升级银联SDK至最新版本(3.3.3),当然可以使用添加Linker Flags的方式解决,或者可以自己剥离掉重复部分,我是懒人,我选择升级哈哈。


2.为工程引入必须的framework:

  • CFNetwork.framework
  • PassKit.framework
  • SystemConfiguration/framework
  • libUPAPayPlugin.a
  • libz.1.2.5.tbd


    3.银联SDK使用http请求,在ios9以后需在工程plist文件中添加NSAppTransportSecurity来支持Http继续使用。

---注意---

  • 因为银联SDK内部分代码是由C/C++组织,这里必须添加libz.1.2.5.tbd,并且将引用到UPAPayPlugin.h的源文件的后缀改为.mm
  • 同时检查Target->Build Settings->Search Paths->Library Search Paths中自定义库libUPAPayPlugin.a的路径是否正确


    4.最后可以开始写代码了,在需要调起ApplePay支付控件的文件中引入头文件UPAPayPlugin.h(记得文件名后缀需要改成.mm),PassKit/PassKit.h
- (void)verifiesApplePayAbility {
    if (![PKPaymentAuthorizationViewController class]) {
        //检查系统版本支持性
        PopMessage(@"当前系统版本不支持ApplePay,最低支持:iphone6, ios9.0以上");
        return;
    } else if (![PKPaymentAuthorizationViewController canMakePayments]) {
        //检查设备支持性
        PopMessage(@"当前设备不支持ApplePay,最低支持:iphone6, ios9.0以上");
        return;
    } else {
        //检查卡片支持性
        NSArray *supportedNetwork = @[PKPaymentNetworkVisa, PKPaymentNetworkMasterCard, PKPaymentNetworkChinaUnionPay, PKPaymentNetworkAmex, PKPaymentNetworkDiscover];
        if (![PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:supportedNetwork]) {
            PopMessage(@"没有绑定支持的卡片");
            return;
        }
    }
    
    //调起苹果支付控件
    [self presentPaymentSheet];
}

- (void)presentPaymentSheet {
    WaitingMessage(@"正在呼出ApplePay支付控件");
    [UPAPayPlugin startPay:yourPayTn mode:self.applePayMode viewController:self delegate:self andAPMechantID:kAppleMechantId];

//-startPay 第一个参数是后台向银联请求创建订单获得的商品tn
//mode是字符串,00为正式环境,01为测试环境
//此处的MechantID传的是从苹果那获取的mechantId
}

如果需要对借记卡/信用卡作限制,在检查卡片支持性的步骤可以这样写:

//检查卡片支持性
NSArray *supportedNetwork = @[PKPaymentNetworkVisa, PKPaymentNetworkMasterCard, PKPaymentNetworkChinaUnionPay, PKPaymentNetworkAmex, PKPaymentNetworkDiscover];
PKMerchantCapability capabilities = PKMerchantCapabilityEMV | PKMerchantCapability3DS | PKMerchantCapabilityDebit;
if (![PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks:supportedNetwork capabilities:capabilities]) {
    PopMessage(@"没有绑定支持的卡片,本支付仅支持使用借记卡支付");
    return;
}



最后是银联ApplePay的支付回调:
返回的UPPayResult对象中有各种支付状态,同时我们还应该检查他的otherInfo属性,里面包含银联的优惠活动信息,如果有则应该在支付成功页中告知客户。

//实现UPAPayPluginDelegate
- (void)UPAPayPluginResult:(UPPayResult *)payResult {
    //do something
    //检查是否有银联优惠信息,告知客户
}

otherInfo中包含优惠信息的格式为:

otherInfo = "currency=元&order_amt=20.00&pay_amt=15.00"

//currency       币种
//order_amt      订单金额
//pay_amt        实付金额

!!!目前不支持商户自定义优惠活动!!!
博主自己研究了php API很久后无果,咨询银联客服,然后彻底死心。。


展示

以下左图是通过银联SDK接入,因为可定制参数比较少,Payment Sheet比较简短,右图是使用苹果API直接生成的订单。




相信美团的ApplePay也是跟银联对接的,心血来潮买了个流量顺便作下对比


生产环境:

csr文件
若需要在生产环境中使用银联SDK接入ApplePay,首先需向银联申请开通ApplePay服务(联系下签约服务),并从银联商户服务平台生成ApplePay专用的CSR文件,重新去苹果开发者网站签署证书。

公钥,私钥
公钥在SDK下载包里面有,私钥在cfca入网通知邮件里面附带也可以自行下载,一个商户号唯一一份私钥和授权码,跟银联普通支付私钥是同一份。

配置
修改生产环境配置文件中的签名证书,密码,后台url地址
更换正式环境商户号(也可以是同一个)
app前端startPay方法的mode参数改为"00"


注意事项:

  • 银联常规支付SDK升级最新版本3.3.3
  • 项目内是否有引入libz.1.2.5.tbd
  • 将引用到UPAPayPlugin.h的源文件的后缀改为.mm
  • 检查Target->Build Settings->Search Paths->Library Search Paths中自定义库libUPAPayPlugin.a的路径是否正确
  • ApplePay的按钮展示必须使用官方指定,否则过不了审核
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容