银联二维码支付之主扫、被扫、查询接口
最近在做银联二维码支付Android端相关项目,因为中国银联网站上并未提供Android端demo,只提供了Java相关demo,只能是根据自己的业务需求去更改,开始看银联的开发文档觉得一脸懵逼,看不懂,后来经过深入分析,才知道自己没有理清步骤,在本篇文档中先介绍一下,银联二维码的主扫、被扫以及查询接口,后续会在介绍退货、冲证、撤销等相关接口。
银联Java提供的SDK目录如下:
在MainActivity中或者Application中先调用:SDKConfig.getConfig().loadPropertiesFromSrc(this);加载工程所需的相关密钥证书,这些证书密钥Java工程是通过classPath路径加载的,但是在Android项目中可以放在assets文件贾或者其他的本地目录中,在此我将这些证书密钥放在了assets中,便于去加载。此外还要将相关的jar包取出来放在项目中
当然,这些jar包在银联提供的java的Demo中都是有的。
一、主扫
package com.zng.unionpayqr.msqr;import java.util.HashMap;
import java.util.Map;import android.util.Log;import com.zng.unionpayqr.sdk.AcpService;
import com.zng.unionpayqr.sdk.LogUtil;
import com.zng.unionpayqr.sdk.SDKConfig;
import com.zng.unionpayqr.utils.DemoBase;
import com.zng.unionpayqr.utils.RandomUtil;public class QRMainSweepUtil {/**QR主扫*/public static void qrMainSweep(){Map<String, String> contentData = new HashMap<String, String>();/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/contentData.put("version", DemoBase.version); //版本号 全渠道默认值contentData.put("encoding", DemoBase.encoding); //字符集编码 可以使用UTF-8,GBK两种方式contentData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法contentData.put("txnType", "01"); //交易类型 01:消费contentData.put("txnSubType", "07"); //交易子类 07:申请消费二维码contentData.put("bizType", "000000"); //填写000000contentData.put("channelType", "08"); //渠道类型 08手机/***商户接入参数***/contentData.put("merId", "777290058149059"); //商户号码,请改成自己申请的商户号或者open上注册得来的777商户号测试contentData.put("accessType", "0"); //接入类型,商户接入填0 ,不需修改(0:直连商户, 1: 收单机构 2:平台商户)contentData.put("orderId", RandomUtil.getOutTradeNo()); //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则 contentData.put("txnTime", DemoBase.getCurrentTime()); //订单发送时间,取系统时间,格式为YYYYMMDDhhmmss,必须取当前时间,否则会报txnTime无效contentData.put("txnAmt", "1"); //交易金额 单位为分,不能带小数点contentData.put("currencyCode", "156"); //境内商户固定 156 人民币contentData.put("backUrl", DemoBase.backUrl);/**对请求参数进行签名并发送http post请求,接收同步应答报文**/Map<String, String> reqData = AcpService.sign(contentData,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。String requestAppUrl = SDKConfig.getConfig().getBackRequestUrl(); //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.backTransUrlMap<String, String> rspData = AcpService.post(reqData,requestAppUrl,DemoBase.encoding); Log.d("zqh", "rspData = "+rspData);/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**///应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》if(!rspData.isEmpty()){if(AcpService.validate(rspData, DemoBase.encoding)){LogUtil.writeLog("验证签名成功");String respCode = rspData.get("respCode") ;if(("00").equals(respCode)){//成功,获取tn号String qrCode = rspData.get("qrCode");Log.e("zqh", "qrCode = "+qrCode);}else{//其他应答码为失败请排查原因或做失败处理}}else{LogUtil.writeErrorLog("验证签名失败");//TODO 检查验证签名失败的原因}}else{//未返回正确的http状态LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");}String reqMessage = DemoBase.genHtmlResult(reqData);String rspMessage = DemoBase.genHtmlResult(rspData);Log.e("zqh","请求报文:<br/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"");}
}
二、被扫
package com.zng.unionpayqr.qrss;import java.util.HashMap;
import java.util.Map;import android.util.Log;import com.zng.unionpayqr.sdk.AcpService;
import com.zng.unionpayqr.sdk.LogUtil;
import com.zng.unionpayqr.sdk.SDKConfig;
import com.zng.unionpayqr.utils.DemoBase;
import com.zng.unionpayqr.utils.RandomUtil;/*** QR被扫* @author zqh**/
public class QRIsSweptUtil {/**QR被扫*/public static void qrIsSwept(String C2BCode){Map<String, String> contentData = new HashMap<String, String>();/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/contentData.put("version", DemoBase.version); //版本号 全渠道默认值contentData.put("encoding", DemoBase.encoding); //字符集编码 可以使用UTF-8,GBK两种方式contentData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法contentData.put("txnType", "01"); //交易类型 01:消费contentData.put("txnSubType", "06"); //交易子类 07:申请消费二维码contentData.put("bizType", "000000"); //填写000000contentData.put("channelType", "08"); //渠道类型 08手机/***商户接入参数***/contentData.put("merId", "777290058149059"); //商户号码,请改成自己申请的商户号或者open上注册得来的777商户号测试contentData.put("accessType", "0"); //接入类型,商户接入填0 ,不需修改(0:直连商户, 1: 收单机构 2:平台商户)contentData.put("qrNo", C2BCode);contentData.put("orderId", RandomUtil.getOutTradeNo()); //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则 contentData.put("txnTime", DemoBase.getCurrentTime()); //订单发送时间,取系统时间,格式为YYYYMMDDhhmmss,必须取当前时间,否则会报txnTime无效contentData.put("txnAmt", "1"); //交易金额 单位为分,不能带小数点contentData.put("currencyCode", "156"); //境内商户固定 156 人民币contentData.put("backUrl", DemoBase.backUrl);/**对请求参数进行签名并发送http post请求,接收同步应答报文**/Map<String, String> reqData = AcpService.sign(contentData,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。String requestAppUrl = SDKConfig.getConfig().getBackRequestUrl(); //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.backTransUrlMap<String, String> rspData = AcpService.post(reqData,requestAppUrl,DemoBase.encoding); Log.d("zqh", "rspData = "+rspData);/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**///应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》if(!rspData.isEmpty()){if(AcpService.validate(rspData, DemoBase.encoding)){LogUtil.writeLog("验证签名成功");String respCode = rspData.get("respCode") ;if(("00").equals(respCode)){//成功,获取tn号String qrCode = rspData.get("qrCode");Log.e("zqh", "qrCode = "+qrCode);}else{//其他应答码为失败请排查原因或做失败处理}}else{LogUtil.writeErrorLog("验证签名失败");//TODO 检查验证签名失败的原因}}else{//未返回正确的http状态LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");}String reqMessage = DemoBase.genHtmlResult(reqData);String rspMessage = DemoBase.genHtmlResult(rspData);Log.e("zqh","请求报文:<br/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"");}
}
三、查询
package com.zng.unionpayqr.utils;import java.util.HashMap;
import java.util.Map;import android.util.Log;import com.zng.unionpayqr.sdk.AcpService;
import com.zng.unionpayqr.sdk.LogUtil;
import com.zng.unionpayqr.sdk.SDKConfig;public class QueryUtil {public static void query(){Map<String, String> data = new HashMap<String, String>();/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/data.put("version", DemoBase.version); //版本号data.put("encoding", DemoBase.encoding); //字符集编码 可以使用UTF-8,GBK两种方式data.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法data.put("txnType", "00"); //交易类型 00-默认data.put("txnSubType", "00"); //交易子类型 默认00data.put("bizType", "000201"); //业务类型 /***商户接入参数***/data.put("merId", "777290058149059"); //商户号码,请改成自己申请的商户号或者open上注册得来的777商户号测试data.put("accessType", "0"); //接入类型,商户接入固定填0,不需修改/***要调通交易以下字段必须修改***/data.put("orderId", "20170712055720002"); //****商户订单号,每次发交易测试需修改为被查询的交易的订单号data.put("txnTime", DemoBase.getCurrentTime()); //****订单发送时间,每次发交易测试需修改为被查询的交易的订单发送时间/**请求参数设置完毕,以下对请求参数进行签名并发送http post请求,接收同步应答报文------------->**/Map<String, String> reqData = AcpService.sign(data,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。String url = SDKConfig.getConfig().getSingleQueryUrl(); //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.singleQueryUrlMap<String, String> rspData = AcpService.post(reqData, url,DemoBase.encoding); //发送请求报文并接受同步应答(默认连接超时时间30秒,读取返回结果超时时间30秒);这里调用signData之后,调用submitUrl之前不能对submitFromData中的键值对做任何修改,如果修改会导致验签不通过/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**///应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》if(!rspData.isEmpty()){if(AcpService.validate(rspData, DemoBase.encoding)){LogUtil.writeLog("验证签名成功");if(("00").equals(rspData.get("respCode"))){//如果查询交易成功String origRespCode = rspData.get("origRespCode");if(("00").equals(origRespCode)){//交易成功,更新商户订单状态//TODO}else if(("03").equals(origRespCode)||("04").equals(origRespCode)||("05").equals(origRespCode)){//订单处理中或交易状态未明,需稍后发起交易状态查询交易 【如果最终尚未确定交易是否成功请以对账文件为准】//TODO}else{//其他应答码为交易失败//TODO}}else if(("34").equals(rspData.get("respCode"))){//订单不存在,可认为交易状态未明,需要稍后发起交易状态查询,或依据对账结果为准}else{//查询交易本身失败,如应答码10/11检查查询报文是否正确//TODO}}else{LogUtil.writeErrorLog("验证签名失败");//TODO 检查验证签名失败的原因}}else{//未返回正确的http状态LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");}String reqMessage = DemoBase.genHtmlResult(reqData);String rspMessage = DemoBase.genHtmlResult(rspData);Log.e("zqh","交易状态查询交易</br>请求报文:<br/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"");}
}
银联测试地址:
商户接入银联全渠道二维码测试:主扫场景:商户参考demo生成二维码后,请使用银联提供的主扫模式付款方仿真https://open.unionpay.com/ajweb/help/qrcodeFormPage/mainSweepReceiverApp发送查询订单和付款交易完成付款。被扫场景:请先使用银联提供的被扫模式付款方仿真https://open.unionpay.com/ajweb/help/qrcodeFormPage/mainSweepReceiverApp中的C2B码申请交易,申请二维码得到qrNo,然后参考demo完成扫码消费交易。测试过程中请使用我们提供的测试卡进行测试,测试卡信息:https://open.unionpay.com/ajweb/help/faq/list?id=4&level=0&from=0&keyword=%E6%B5%8B%E8%AF%95%E5%8D%A1
以下是相关的Demo链接欢迎下载。
点击打开链接
github完整项目连接:https://github.com/hanfengzqh/UnionPayQR
银联二维码支付之主扫、被扫、查询接口相关推荐
- 微信二维码支付支付宝二维码支付(主扫模式)开发指南
微信二维码支付 熟悉微信支付全家桶的童鞋应该都清楚,微信支付是没有提供PC网关支付的,那么传统的网站需要怎么接入微信支付产品呢? 我们可以选择微信支付中的Native支付产品,官方介绍: Native ...
- 银联二维码支付与微信支付相比,哪个好用?
2019独角兽企业重金招聘Python工程师标准>>> 近日,中国银联联合40多家商业银行正式推出了二维码支付产品.扫码支付你应该早就不陌生了.现在即使是摆在街边的水果摊也有二维码让 ...
- PHP开发银联云闪付二维码支付
你好,是我琉忆.最近刚好有在研究银联云闪付的支付模块,所以就写篇总结分享给大家. 这算是第二次接触支付的东西了,接触得最多的是接入微信支付,自己也有相关的总结文章,可以去segmentfault搜索& ...
- 银联押宝二维码支付 背后还有一片纷争江湖
昨天银联二维码支付标准正式发布了.这被市场看做,此前存在安全隐患.饱受争议的二维码支付终于合规化了.各位以后去商家扫码,会有不同选择了:支付宝的.微信的.还有银联的.不过我估计各位还是哪个方便.哪个优 ...
- 移动二维码支付 推进二维码扫码智能POS
现如今:银币.再到纸币,演变到"钱"变得越来越轻薄.在现在这个移动支付市场中,互联网技术的支撑下,刷手机乘公交.刷支付宝买菜购物.缴水电费--日常生活中使用"现金&quo ...
- 梦行扫码付(收银台条码支付 微信钱包条码支付 支付宝二维码支付 手机APP钱包支付 PHP扫码支付 )
适用于:各行各业(如,超市 餐厅 收费站 等各类收费处) 平台管理员篇 扫码付管理 (收银台条码支付) 全站收款账号 (微信钱包条码支付) 全站收款记录 (支付宝二维码支付) 商家篇 我的扫码付 (支 ...
- Java 支付对接之银联电子商务(海南)聚合二维码支付(POS 通插件 C 扫 B 业务)
写在前面: 二维码支付宝有两种表现形式:第一种是动态的二维码,就是每生成一个订单就会生成一个二维码:第二种是固定的二维码,就是每个订单都是同一个二维码作为入口.本文主要描述的是如何使用银联的线下C扫B ...
- 银联云闪付二维码支付对接流程和测试
因为公司已经支持了支付宝支付和微信支付,所以需要加上一个银联的云闪付,主要是二维码支付. 银联商务的官方文档其实已经很清楚了,但是因为之前对接支付宝和微信,有一个保存商户信息的表,表结构已经确定了,再 ...
- 二维码支付的优势与劣势
一.二维码支付概述 1.第三方移动支付定义 第三方移动支付是指交易双方通过手机.平扳电脑等移动终端,利用移动通信网络和无线通信技术,由独立于移动通讯运营商与银行以外的第三方支付平台支持的支付服务,完成 ...
- 工行二维码支付时代来了
全球最大商业银行工商银行和福州拾方易科技网络公司签署了特约商户联盟商圈协作拓展合作,为商家和用户的便捷推出了,你赚钱我买单!各大零售,商户,餐饮,百货入住商家和用户都可享受,二维码支付,千分二费率,满 ...
最新文章
- VS2010解决方案转换到VS2008
- vijos 1512 SuperBrother打鼹鼠
- SRM596 DIV2 250
- Python入门100题 | 第063题
- “单细胞”前瞻 |新型微滴反应筛选技术ATAC-seq数据分析新篇章
- Python-WSGI协议如何实现?
- java读写excel文件
- Linux安装MATLAB Compiler Runtime操作
- 苹果系统被曝漏洞, 大麦网再遭撞库攻击 | 宅客周刊
- 动态规划之详细分析0-1背包问题
- Computer Science 领域文献检索 SCI、CPCI-S 和 EI
- (伪)原创,采集工具应用
- Computer Architectrure: Quantitative Approch 第三章第四节
- JavaScript-作用域和作用链
- linux和win10文件共享smb,Windows 10 Samba文件共享的设置方法,解决不能访问和密码错误的问题...
- python的cfg是什么模块_使用安装模块设置.py以及设置.cfg
- zynq系列之-----PS端iic使用
- C#批量剪切视频文件
- [安卓]安装低版本微信
- 张小娴经典语录100句