最近在做银联二维码支付Android端相关项目,因为中国银联网站上并未提供Android端demo,只提供了Java相关demo,只能是根据自己的业务需求去更改,开始看银联的开发文档觉得一脸懵逼,看不懂,后来经过深入分析,才知道自己没有理清步骤,在本篇文档中先介绍一下,银联二维码的主扫、被扫以及查询接口,后续会在介绍退货、冲证、撤销等相关接口。

银联Java提供的SDK目录如下:

银联支付的C扫Bjava代码案例 银联扫描是什么意思_Data

在MainActivity中或者Application中先调用:SDKConfig.getConfig().loadPropertiesFromSrc(this);加载工程所需的相关密钥证书,这些证书密钥Java工程是通过classPath路径加载的,但是在Android项目中可以放在assets文件贾或者其他的本地目录中,在此我将这些证书密钥放在了assets中,便于去加载。此外还要将相关的jar包取出来放在项目中

银联支付的C扫Bjava代码案例 银联扫描是什么意思_银联支付的C扫Bjava代码案例_02

当然,这些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