springboot 银联支付（条码支付）
程序员文章站
2024-03-22 23:05:40
...
springboot 银联支付（条码支付）
应用：持卡人打开付款app（云闪付、银行app）出示付款码，商户使用扫码设备扫描付款码完成支付
官方文档：https://open.unionpay.com/tjweb/acproduct/list?apiSvcId=468&index=2
***************************
操作流程
收银员在门店收银台生成支付订单，向持卡人展示订单信息以及支付金额；
持卡人打开付款APP（云闪付或者银行APP），展示付款码；
收银员使用扫码设备读取付款码，将读取的信息上传给门店收银台，门店收银台发起支付请求；
银联支付系统收到支付请求后对请求进行验证，验证通过后处理请求数据；
银联同步返回处理结果，应答码为00时，仅表示受理成功，具体应答码见下图；
银联支付系统将支付结果返回给商户收银后台（如果没有收到可主动查询），同时将反馈给付款app
***************************
示例
************************
配置文件
acp_sdk.properties
##############SDK配置文件（证书方式签名）################
# 说明：
# 1. 使用时请将此文件复制到src文件夹下替换原来的acp_sdk.properties。
# 2. 具体配置项请根据注释修改。
#
################################################
##########################入网测试环境交易发送地址（线上测试需要使用生产环境交易请求地址）#############################
##交易请求地址
acpsdk.frontTransUrl=https://gateway.test.95516.com/gateway/api/frontTransReq.do
acpsdk.backTransUrl=https://gateway.test.95516.com/gateway/api/backTransReq.do
acpsdk.singleQueryUrl=https://gateway.test.95516.com/gateway/api/queryTrans.do
acpsdk.batchTransUrl=https://gateway.test.95516.com/gateway/api/batchTrans.do
acpsdk.fileTransUrl=https://filedownload.test.95516.com/
acpsdk.appTransUrl=https://gateway.test.95516.com/gateway/api/appTransReq.do
acpsdk.cardTransUrl=https://gateway.test.95516.com/gateway/api/cardTransReq.do
#以下缴费产品使用，其余产品用不到
acpsdk.jfFrontTransUrl=https://gateway.test.95516.com/jiaofei/api/frontTransReq.do
acpsdk.jfBackTransUrl=https://gateway.test.95516.com/jiaofei/api/backTransReq.do
acpsdk.jfSingleQueryUrl=https://gateway.test.95516.com/jiaofei/api/queryTrans.do
acpsdk.jfCardTransUrl=https://gateway.test.95516.com/jiaofei/api/cardTransReq.do
acpsdk.jfAppTransUrl=https://gateway.test.95516.com/jiaofei/api/appTransReq.do
########################################################################
# 报文版本号，固定5.1.0，请勿改动
acpsdk.version=5.1.0
# 签名方式，证书方式固定01，请勿改动
acpsdk.signMethod=01
# 是否验证验签证书的CN，测试环境请设置false，生产环境请设置true。非false的值默认都当true处理。
acpsdk.ifValidateCNName=false
# 是否验证https证书，测试环境请设置false，生产环境建议优先尝试true，不行再false。非true的值默认都当false处理。
acpsdk.ifValidateRemoteCert=false
#后台通知地址，填写接收银联后台通知的地址，必须外网能访问
acpsdk.backUrl=http://tpzrbx.natappfree.cc/notify
#########################入网测试环境签名证书配置 ################################
# 多证书的情况证书路径为代码指定，可不对此块做配置。
# 签名证书路径，必须使用绝对路径，如果不想使用绝对路径，可以自行实现相对路径获取证书的方法；测试证书所有商户共用开发包中的测试签名证书，生产环境请从cfca下载得到。
# windows样例：
acpsdk.signCert.path=D:/certs/acp_test_sign.pfx
# linux样例（注意：在linux下读取证书需要保证证书有被应用读的权限）（后续其他路径配置也同此条说明）
#acpsdk.signCert.path=/SERVICE01/usr/ac_frnas/conf/ACPtest/acp700000000000001.pfx
# 签名证书密码，测试环境固定000000，生产环境请修改为从cfca下载的正式证书的密码，正式环境证书密码位数需小于等于6位，否则上传到商户服务网站会失败
acpsdk.signCert.pwd=000000
# 签名证书类型，固定不需要修改
acpsdk.signCert.type=PKCS12
##########################加密证书配置################################
# 敏感信息加密证书路径(商户号开通了商户对敏感信息加密的权限，需要对 卡号accNo，pin和phoneNo，cvn2，expired加密（如果这些上送的话），对敏感信息加密使用)
acpsdk.encryptCert.path=D:/certs/acp_test_enc.cer
##########################验签证书配置################################
# 验签中级证书路径(银联提供)
acpsdk.middleCert.path=D:/certs/acp_test_middle.cer
# 验签根证书路径(银联提供)
acpsdk.rootCert.path=D:/certs/acp_test_root.cer
acpsdk.validateCert.dir=D:/certs/
************************
config 层
UnionpayConfig：加载配置属性，初始化SDKConfig
@Configuration
public class UnionpayConfig implements ApplicationRunner {
@Override
public void run(ApplicationArguments args) {
SDKConfig.getConfig().loadPropertiesFromSrc();
}
}
************************
service 层
UnionpayService
public interface UnionpayService {
public String pay(String orderId, String txnAmt,String termId,String qrNo) //支付接口
}
************************
serviceImpl 层
UnionpayServiceImpl
@Service
public class UnionpayServiceImpl implements UnionpayService {
@Override
public String pay(String orderId, String txnAmt,String termId,String qrNo) {
Map<String, String> requestData = new HashMap<>();
/***银联全渠道系统，产品参数，除了encoding自行选择外其他不需修改***/
requestData.put("version", SDKConstants.VERSION_5_1_0); //版本号，全渠道默认值
requestData.put("encoding", SDKConstants.UTF_8_ENCODING); //字符集编码，可以使用UTF-8,GBK两种方式
requestData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法
requestData.put("txnType", "01"); //交易类型 ，01：消费
requestData.put("txnSubType", "06"); //交易子类型， 06：二维码消费
requestData.put("bizType", "000000"); //业务类型
requestData.put("channelType", "08"); //渠道类型，这个字段区分B2C网关支付和手机wap支付；07：PC,平板 08：手机
/***商户接入参数***/
requestData.put("merId", "777***"); //商户号码，请改成自己申请的正式商户号或者open上注册得来的777测试商户号
requestData.put("accessType", "0"); //接入类型，0：直连商户
requestData.put("orderId",orderId); //商户订单号，8-40位数字字母，不能含“-”或“_”，可以自行定制规则
requestData.put("txnTime", DemoBase.getCurrentTime()); //订单发送时间，取系统时间，格式为YYYYMMDDhhmmss，必须取当前时间，否则会报txnTime无效
requestData.put("currencyCode", "156"); //交易币种（境内商户一般是156 人民币）
requestData.put("txnAmt", txnAmt); //交易金额，单位分，不要带小数点
requestData.put("qrNo", qrNo); //C2B码,1-20位数字
requestData.put("termId", termId); //终端号
//后台通知地址（需设置为【外网】能访问 http https均可），支付成功后银联会自动将异步通知报文post到商户上送的该地址，失败的交易银联不会发送后台通知
//后台通知参数详见open.unionpay.com帮助中心 下载 产品接口规范 网关支付产品接口规范 消费交易 商户通知
//注意:1.需设置为外网能访问，否则收不到通知 2.http https均可 3.收单后台通知后需要10秒内返回http200或302状态码
// 4.如果银联通知服务器发送通知后10秒内未收到返回状态码或者应答码非http200，那么银联会间隔一段时间再次发送。总共发送5次，每次的间隔时间为0,1,2,4分钟。
// 5.后台通知地址如果上送了带有？的参数，例如：http://abc/web?a=b&c=d 在后台通知处理程序验证签名之前需要编写逻辑将这些字段去掉再验签，否则将会验签失败
requestData.put("backUrl", DemoBase.backUrl);
// 报文中特殊用法请查看 PCwap网关跳转支付特殊用法.txt
/**请求参数设置完毕，以下对请求参数进行签名并生成html表单，将表单写入浏览器跳转打开银联页面**/
//报文中certId,signature的值是在signData方法中获取并自动赋值的，只要证书配置正确即可。
Map<String, String> submitFromData = AcpService.sign(requestData, SDKConstants.UTF_8_ENCODING);
//获取请求银联的前台地址：对应属性文件acp_sdk.properties文件中的acpsdk.frontTransUrl
String requestUrl = SDKConfig.getConfig().getBackRequestUrl();
Map<String,String> rspData=AcpService.post(requestData,requestUrl,SDKConstants.UTF_8_ENCODING);
String result=null;
if (!rspData.isEmpty()){
if (AcpService.validate(rspData,SDKConstants.UTF_8_ENCODING)){
LogUtil.writeLog("验证签名成功");
String respCode = rspData.get("respCode") ;
if(("00").equals(respCode)){
result= "交易成功受理，稍后可查询交易结果";
}else {
result= "交易异常或超时，稍后查询处理结果";
}
}else {
LogUtil.writeErrorLog("验证签名失败");
result= "验签失败";
}
}else {
LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");
result="未获取到返回报文或返回http状态码非200";
}
return result;
}
}
************************
controller 层
UnionpayController
@RestController
public class UnionpayController {
@Resource
private UnionpayService unionpayService;
@RequestMapping("/pay")
public void pay(HttpServletResponse response) throws Exception{
response.setHeader("content-type", "text/html;charset=UTF-8");
response.getWriter().write(unionpayService.pay(DemoBase.getOrderId(),"20000"));
}
@RequestMapping("/notify")
public void hello2(HttpServletRequest request,HttpServletResponse response) throws Exception{
Map<String,String> result=new HashMap<>();
System.out.println("======= 后台通知 ========");
Enumeration<String> names=request.getParameterNames();
if (names!=null){
while (names.hasMoreElements()){
String name=names.nextElement();
String value=request.getParameter(name);
result.put(name,value);
System.out.println(name+" ==> "+value);
if (result.get(name)==null||"".equals(result.get(name))){
result.remove(name);
}
}
}
if (AcpService.validate(result, SDKConstants.UTF_8_ENCODING)){
System.out.println("后台验签成功");
}else {
System.out.println("后台验签失败");
}
response.getWriter().print("ok");
}
}