最近在做银联二维码支付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"); //填写000000
contentData.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.backTransUrl
Map<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"); //填写000000
contentData.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.backTransUrl
Map<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"); //交易子类型 默认00
data.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.singleQueryUrl
Map<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