支付ios11.0.2

1第三方APP调用农行掌银APP支付使用说明文档信息:最新版本:V0.
4修订记录:日期版本修订描述作者2016-11-160.
1创建范华、王杰、苏玉林、骆雄武2017-01-060.
2修订骆雄武2017-02-200.
3修订苏玉林、骆雄武2017-4-120.
4修订范华、王杰、骆雄武修订内容:版本修订内容0.
1创建0.
2增加基本说明、接口及参数说明0.
3在接口及参数说明中增加具体的返回参数说明0.
4对第三方APP如何提供白名单信息进行具体说明2一、基本说明1、随本文档提供的掌银安装包和供第三方APP集成的SDK,均适用于测试环境,而非生产环境,使用前请确保所访问环境是正确的.
2、用于测试环境的测试数据,请联系各相关分行业务对口人员获取.
3、掌银测试安装包及支付SDK分iOS和Android两个版本,分别包含的文件如下:(1)iOS版掌银测试安装包:支付测试3.
5.
0.
ipa支付SDK文件:ABCAppCaller.
h,libABCAppCaller.
a(2)Android版掌银测试安装包:BankABC_XXX_sign.
apk支付SDK文件:bankabccaller.
jar4、各APP在准备集成上述支付SDK,并与农行掌银APP支付进行联调测试前,请务必确保自己已经是农行线上支付平台(商e付)的签约商户,并确保自己应用的服务端配置对接的是农行商e付的测试环境.
5、整个支付流程与系统关系示意如下图1.
3图1支付流程及系统关系示意图二、iOSSDK集成及使用指南1、将静态库libABCAppCaller.
a以及头文件ABCAppCaller.
h集成到工程中2、工程Plist文件添加如下配置项,将农行掌银url添加至canOpenURL调用白名单LSApplicationQueriesSchemesbankabc3、ios支付SDK调用示例代码:if([[ABCAppCallersharedAppCaller]isABCePayAvailable:@"bankabc://"]){[[ABCAppCallersharedAppCaller]callBankABC:@"bankabc"param:@"CallbackID=railwaypay&TokenID=14406457162720037182&Method=pay"];//如果已安装掌银则调起掌银,两个参数分别为掌银的URL标示以及送的参数,参数格式参考标准url传参格式}else{//这里写没有安装掌银app的业务逻辑农行掌银支付SDK第三方APP第三方APP服务端农行掌银服务端农行掌银APP农行商e付平台1、下单2、订单推送3、订单支付4、支付调用5、支付6、支付7、支付完成后,反调第三方APP4}4、将掌银测试安装包安装至测试手机中进行连调测试,可通过同步助手等软件进行安装5、支付完成后,掌银会反调起第三方APP,并传入相应参数(该笔支付的订单号),APP需自行获取并处理相应参数,并根据订单号主动查询支付结果.
三、AndroidSDK集成及使用指南1.
将bankabccaller.
jar放入工程lib目录下;2.
示例代码:/***判断手机上是否具备调起农行掌银的条件*/if(BankABCCaller.
isBankABCAvaiable(MainActivity.
this)){/***调起农行掌银*/BankABCCaller.
startBankABC(MainActivity.
this,"com.
example.
caller","com.
example.
caller.
MainActivity","pay","14821359507779891364");}else{//客户手机未安装农行掌银APP的处理逻辑,由第三方APP自行实现Toast.
makeText(MainActivity.
this,"没安装农行掌银,或已安装农行掌银版本不支持",Toast.
LENGTH_LONG).
show();}3.
获取掌银返回参数(在onResume方法里)支付完成后,掌银会反调起第三方APP,并传入相应参数,通知APP查询支付结果Stringparam=getIntent().
getStringExtra("from_bankabc_param");54、调用农行掌银之前,如果APP自身弹出了系统键盘,请先将键盘隐去,再执行调起掌银APP的操作.
四、接口及参数说明1、iOSSDK接口说明:(1)isABCePayAvailable//农行掌银支付是否可用参数:农行掌银url,例如bankabc(2)callBankABC://调用农行掌银APP支付参数1:农行掌银url,例如bankabc参数2:参数列表param,具体包含三个字段CallbackID,TokenID,Method,以&符号连接,拼成一串,例如:CallbackID=railwaypay&TokenID=14406457162720037182&Method=pay2、AndroidSDK接口说明:(1)BankABCCaller.
isBankABCAvaiable(Activityactivity)//农行掌银支付是否可用(2)BankABCCaller.
startBankABC(Activityactivity,StringappID,StringCallbackID,StringMethod,StringTokenID)//调用农行掌银APP支付例如:BankABCCaller.
startBankABC(MainActivity.
this,"com.
example.
caller","com.
example.
caller.
MainActivity","pay","14821359507779891364")3、参数含义说明:(1)appID:第三方APP的应用标识.
iOS无此项内容,值为空;Android为第三方apk的包名.
(2)CallbackID:支付完成后回调用的id.
iOS为第三方app的schema,Android为第三方APP目标页面的activity.
(3)Method:业务类型.
目前支持的取值仅为pay,表示是支付交易.
(4)TokenID:支付订单号.
4、支付完成后,掌银调起第三方APP的过程及参数(1)支付完成后,掌银支付页面若判断出是从第三方APP过来的支付订单,当用户点击"完成"按钮,则会反调起第三方APP(需用到前面的CallbackID值),并传入参数CallbackParam.
目前约定的CallbackParam为:"STT=XX&Msg=XXX&6TokenID=XXXX",分别指:STT:支付状态码.
Msg:支付状态说明.
注意:STT和Msg由于是从掌银APP端传递给第三方的,可靠性无法保证,其值仅供参考.
目前所有的可能取值为:STTMsg备注0000支付成功9999支付未完成PA500401已存在成功支付的订单[支付出错情况下,后台返回的错误码][后台返回的错误信息]非法调用(未知的调起APP)!
!
无appID非法调用(错误的参数)!
!
无param非法调用(无法解析参数)!
解密param失败非法调用(关键参数1未获取)!
未取到TokenID非法调用(关键参数2未获取)!
未取到TimeStamp非法调用(关键参数3未获取)!
未取到CallbackIDAP0000调起请求异常,请重试!
时间戳验证失败或android签名验证失败AP0001调用程序不在白名单其中,需要第三方APP程序对返回结果进行业务处理的是标黄的四类情况.
其余的均为程序或配置错误,需要进行相应的程序或配置修正,无需业务逻辑处理.
TokenID:该笔支付对应的订单号.
当支付状态为成功时,第三方APP需根据该参数,主动去后台查询订单支付状态,确保支付状态的可靠性.
五、第三方APP提供白名单信息说明第三方APP若需调用农行掌银APP进行支付,需提供自身APP相关信7息给总行业务部门添加至掌银白名单.
具体需提供的信息包括:ios版:APP的bundleid.
Android版:APP的包名(packagename)和APK签名的SHA-1值.
查看方法如下:ios:Android: