银联二维码支付之主扫、被扫、查询接口

最新推荐文章于 2024-06-14 20:32:04 发布
最新推荐文章于 2024-06-14 20:32:04 发布
阅读量1.9w 收藏 18
点赞数 3
分类专栏： Android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hanfengzqh/article/details/75043052
版权

最近在做银联二维码支付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


hanfengzqh
关注
  • 3
    点赞
  • 踩
  • 18
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
专栏目录
银联-----银行卡信息查询接口
曹品东
08-30 4684
public function wangyin(){ // ini_set('date.timezone','Asia/Shanghai'); $url="https://openapi.unionpay.com/upapi/cardbintest/token?app_id=up_1j732hancela_29i&amp;app_secret=dcd6822b0b14138cb69e9705...
nodejs调用建行互联网银企被扫支付接口Java版加解密Demo
juchangtao1的博客
09-25 810
node js调用建行互联网银企被扫支付接口Java版加解密Demo
中国银联全渠道支付平台--银联二维码支付之主扫、被扫、查询接口
07-13
中国银联全渠道支付平台--银联二维码支付之主扫、被扫、查询接口
给你一个扫码支付的二维码，如何写测试用例？
最新发布
qq_48811377的博客
06-14 1163
面试的时候，经常会临场出题：给你一个xxx, 如何。
中国银联接口
08-08
为中国银联账户交易处理的最新接口，包含申卡，交易，结果查询，消费绑定，撤销，冲正等接口
java对接银联商务扫码支付（银联商务扫码支付文档）
排长性感的小屁屁
01-19 3411
java实现银联商务扫码支付----根据银联商务扫码支付文档 一、本文对接银联商务扫码支付文档，文档链接： 本文根据扫码支付文档接口，简单的做参数传值，进行简单的调取二维码测试，直接看代码如下： 1.1Union_ScanPayContrloloer控制层代码 /** * a获取一次性二维码 * @param request * @param response * @param ...
聚合支付PC端-银联扫码支付
qq_41657996的博客
08-31 1090
扫码支付
c#银联支付接口获取二维码支付
05-16
提供c#源码，接口地址，appid，appkey需要自行提供，银联付款，查账等支持微信，支付宝支付，源码有接口的话可调试
银联二维码支付demo
01-31
总的来说，银联二维码支付的实现涉及多方面的技术，包括客户端应用开发、服务器端接口集成、支付安全策略等。通过使用银联提供的开发包，开发者可以更方便地将这一支付方式融入到自己的产品中，为用户提供更加便捷的...
二维码支付产品开发包V1.3.rar_DEMO_二维码支付_银联二维码支付开发包
09-20
接下来，"Java Version SDK (通用版)"是为Java开发者提供的API库，包含了实现银联二维码支付功能所需的所有类和方法。开发者可以通过这些接口来调用银联的支付服务，处理支付请求、查询交易状态、处理退款等操作。这...
建设银行【善付通】支付结算接入文档
10-23
善付通是在善融商务建立的，为供应链中具有一定主导地位的客户与其上下游间交易提供信息协同、结算对账及经营分析的服务专区。 善付通解决企业传统订单管理、对外协同、收付款等环节分离所造成的对账工作量大、出错率高等问题，为企业提供更加高效的管理工具。 善付通包括采购订单管理、销售订单管理、商品管理、供应商管理、客户管理、员工管理、结算管理等模块，将交易全流程的各类单据，如订单、付款单、发货单、签收单等，相互匹配对应。企业不仅跟踪订单全流程，如订单建立、收发货登记、在线付款等，还可预付货款、查询应收应付信息并设置员工不同权限。
银联支付回调
04-17
银联支付回调 支付完成进行回调 修改数据库订单信息
微信被扫支付接口文档V2.5.6
10-01
微信被扫支付接口文档V2.5.6 微信被扫和主扫文档
android app银联支付,android app 快速接入银联支付流程（android studio版）
weixin_42447681的博客
05-28 1176
刚接触了下银联支付，在网上搜还是看官方文档银联支付都不是很清晰，所以自己总结一篇，希望可以帮助大家快速集成。一.进入下载官网，选择下载手机控件支付demo：https://open.unionpay.com/ajweb/help/file/techFile?productId=3二.直接找到demo中的三个类： 这里不得不吐槽下银联支付的demo了，不像支付宝那样的简单明了调一个方法改一些参数，银...
PHP 之建行龙支付 - 被扫查单（商家扫码客户二维码），查询订单是否付款成功
weixin_42674576的博客
01-08 1618
PHP 之建行龙支付 - 被扫查单（商家扫码客户二维码），查询订单是否付款成功
Java集成建行龙支付接口（详细）
dacheng_liu的博客
11-20 5434
Java集成建行龙支付接口（详细），持续更新！
Android开发：app工程集成银联支付功能（服务器端）
yshr1991的博客
05-07 1912
因为是自己开发了一个app应用，没资格去申请微信支付和支付宝支付，于是就采用了银联支付功能，银联支付分为了两种环境：测试环境和生产环境，一般前期开发的时候都是使用测试环境，数据都是测试数据，不会发生真实交易。第一次做Android项目+IDE为Android Studio+第一次集成支付功能，所以个人觉得整个集成过程可能有点复杂，而且银联支付产品众多：网关支付产品、手机控件支付、手机网页支付等等，
正确规范写接口文档
热门推荐
qq_41961113的博客
05-17 11万+
前言　　正规的团队合作或者是项目对接，接口文档是非常重要的，一般接口文档都是通过开发人员写的。一个工整的文档显得是非重要。下面我总结下自己看到的优秀接口文档。银联接口文档案例：5.2.2 统一收单线下交易查询5.2.2.1 场景说明收单机构可以通过该接口主动查询订单状态，完成下一步的业务逻辑。需要调用查询接口的情况:当收单机构后台、网络、服务器等出现异常，收单机构系统最终未接收到支付通知;调用支付...
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值