支付ios11.0.2
ios11.0.2 时间:2021-05-24 阅读:()
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:
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:
ShockHosting（$4.99/月），东京机房 可享受五折优惠，下单赠送10美金
ShockHosting商家在前面文章中有介绍过几次。ShockHosting商家成立于2013年的美国主机商，目前主要提供虚拟主机、VPS主机、独立服务器和域名注册等综合IDC业务，现有美国洛杉矶、新泽西、芝加哥、达拉斯、荷兰阿姆斯特丹、英国和澳大利亚悉尼七大数据中心。这次有新增日本东京机房。而且同时有推出5折优惠促销，而且即刻使用支付宝下单的话还可获赠10美金的账户信用额度，折扣相比之前的常规...
PIGYUN：美国联通CUVIPCUVIP限时cuvip、AS9929、GIA/韩国CN2机房限时六折
pigyun怎么样?PIGYunData成立于2019年，2021是PIGYun为用户提供稳定服务的第三年，目前商家提供香港CN2线路、韩国cn2线路、美西CUVIP-9929、GIA等线路优质VPS，基于KVM虚拟架构，商家采用魔方云平台，所有的配置都可以弹性选择，目前商家推出了七月优惠，韩国和美国所有线路都有相应的促销，六折至八折，性价比不错。点击进入：PIGYun官方网站地址PIGYUN优惠...
HostYun 新增可选洛杉矶/日本机房 全场9折月付19.8元起
关于HostYun主机商在之前也有几次分享，这个前身是我们可能熟悉的小众的HostShare商家，主要就是提供廉价主机，那时候官方还声称选择这个品牌的机器不要用于正式生产项目，如今这个品牌重新转变成Hostyun。目前提供的VPS主机包括KVM和XEN架构，数据中心可选日本、韩国、香港和美国的多个地区机房，电信双程CN2 GIA线路，香港和日本机房，均为国内直连线路，访问质量不错。今天和大家分享下...
ios11.0.2为你推荐
-
glucanotransferasechrome曲目itunesfunctionscss浙江世纪华通集团股份有限公司之路android支持ipad2.3ios5x-router思科路由器有线端无法上网，而无线段却可以，用的是PPPOE拨号上网，一开始两种方法都不可以，检查宽x-routerX-TRAlL是什么意思xp关闭445端口Windows XP系统 关闭445端口后无法上网，求解？