Java银联在线网关支付测试总结

1.准备

        进入银联开放平台,注册登录,选择产品,我这里选择在线网关支付,如图一,先下载SDK,然后点击我要测试。

图一

        如图二点击集成测试拿到测试权限,点击测试参数,拿到参数,可以先把“测试证书5.1.0”的4个证书下载下来放到一个目录。  

图二

 2.开发

        选择JAVA版的SDK,打开目录可以看到assets下面是一些证书目录,com下面是源码,demo下面是调用实例,sdk下面是一些配置实现类。

图三

         搭建一个maven项目,把图三圈起来的类拿过来,acp_sdk.properties也直接拿过来,构建如图四目录结构,其中Form_6_2_FrontConsume改为DemoController,代码要做一些修改,下面有具体内容。

图四

 pom文件内容:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example.demo</groupId>
    <artifactId>UnionPay</artifactId>
    <version>1.0-SNAPSHOT</version>
    <parent>
        <artifactId>spring-boot-starter-parent</artifactId>
        <groupId>org.springframework.boot</groupId>
        <version>2.5.2</version>
    </parent>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <version>2.5.2</version>
            <scope>test</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.bouncycastle/bcprov-jdk15on -->
        <dependency>
            <groupId>org.bouncycastle</groupId>
            <artifactId>bcprov-jdk15on</artifactId>
            <version>1.60</version>
        </dependency>
        <dependency>
            <groupId>commons-codec</groupId>
            <artifactId>commons-codec</artifactId>
            <version>1.10</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.31</version>
        </dependency>
    </dependencies>

</project>

 DemoController内容:

package com.example.demo.controller;

import com.example.demo.bean.DemoBase;
import com.example.demo.util.AcpService;
import com.example.demo.util.LogUtil;
import com.example.demo.util.SDKConfig;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

@RestController
@RequestMapping("/demo")
public class DemoController {
    @GetMapping("/pay")
    public void pay(HttpServletRequest req, HttpServletResponse resp) throws IOException {

        resp.setContentType("text/html; charset="+ DemoBase.encoding);

        //前台页面传过来的
        String merId = req.getParameter("merId");
        String txnAmt = req.getParameter("txnAmt");
        String orderId = req.getParameter("orderId");
        String txnTime = req.getParameter("txnTime");

        Map<String, String> requestData = new HashMap<String, String>();

        /***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/
        requestData.put("version", DemoBase.version);   			  //版本号,全渠道默认值
        requestData.put("encoding", DemoBase.encoding); 			  //字符集编码,可以使用UTF-8,GBK两种方式
        requestData.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法
        requestData.put("txnType", "01");               			  //交易类型 ,01:消费
        requestData.put("txnSubType", "01");            			  //交易子类型, 01:自助消费
        requestData.put("bizType", "000201");           			  //业务类型,B2C网关支付,手机wap支付
        requestData.put("channelType", "07");           			  //渠道类型,这个字段区分B2C网关支付和手机wap支付;07:PC,平板  08:手机

        /***商户接入参数***/
        requestData.put("merId", merId);    	          			  //商户号码,请改成自己申请的正式商户号或者open上注册得来的777测试商户号
        requestData.put("accessType", "0");             			  //接入类型,0:直连商户
        requestData.put("orderId",orderId);             //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则
        requestData.put("txnTime", txnTime);        //订单发送时间,取系统时间,格式为yyyyMMddHHmmss,必须取当前时间,否则会报txnTime无效(new SimpleDateFormat("yyyyMMddHHmmss").format(new Date().getTime()))
        requestData.put("currencyCode", "156");         			  //交易币种(境内商户一般是156 人民币)
        requestData.put("txnAmt", txnAmt);             			      //交易金额,单位分,不要带小数点
        //requestData.put("reqReserved", "透传字段");        		      //请求方保留域,如需使用请启用即可;透传字段(可以实现商户自定义参数的追踪)本交易的后台通知,对本交易的交易状态查询交易、对账文件中均会原样返回,商户可以按需上传,长度为1-1024个字节。出现&={}[]符号时可能导致查询接口应答报文解析失败,建议尽量只传字母数字并使用|分割,或者可以最外层做一次base64编码(base64编码之后出现的等号不会导致解析失败可以不用管)。

        requestData.put("riskRateInfo", "{commodityName=测试商品名称}");

        //前台通知地址 (需设置为外网能访问 http https均可),支付成功后的页面 点击“返回商户”按钮的时候将异步通知报文post到该地址
        //如果想要实现过几秒中自动跳转回商户页面权限,需联系银联业务申请开通自动返回商户权限
        //异步通知参数详见open.unionpay.com帮助中心 下载  产品接口规范  网关支付产品接口规范 消费交易 商户通知
        requestData.put("frontUrl", DemoBase.frontUrl);

        //后台通知地址(需设置为【外网】能访问 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);

        // 订单超时时间。
        // 超过此时间后,除网银交易外,其他交易银联系统会拒绝受理,提示超时。 跳转银行网银交易如果超时后交易成功,会自动退款,大约5个工作日金额返还到持卡人账户。
        // 此时间建议取支付时的北京时间加15分钟。
        // 超过超时时间调查询接口应答origRespCode不是A6或者00的就可以判断为失败。
        requestData.put("payTimeout", new SimpleDateFormat("yyyyMMddHHmmss").format(new Date().getTime() + 15 * 60 * 1000));

        //
        //
        //       报文中特殊用法请查看 special_use_purchase.txt
        //
        //

        /**请求参数设置完毕,以下对请求参数进行签名并生成html表单,将表单写入浏览器跳转打开银联页面**/
        Map<String, String> submitFromData = AcpService.sign(requestData,DemoBase.encoding);  //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。

        String requestFrontUrl = SDKConfig.getConfig().getFrontRequestUrl();  //获取请求银联的前台地址:对应属性文件acp_sdk.properties文件中的acpsdk.frontTransUrl
        String html = AcpService.createAutoFormHtml(requestFrontUrl, submitFromData,DemoBase.encoding);   //生成自动跳转的Html表单

        LogUtil.writeLog("打印请求HTML,此为请求报文,为联调排查问题的依据:"+html);
        //将生成的html写到浏览器中完成自动跳转打开银联支付页面;这里调用signData之后,将html写到浏览器跳转到银联页面之前均不能对html中的表单项的名称和值进行修改,如果修改会导致验签不通过
        resp.getWriter().write(html);
    }
}

 修改acp_sdk.properties文件,把图五中圈起来的地方改成前面下载的证书地址。

图五

源码中SDKConfig.java里有加载配置参数的方法:

	/**
	 * 从classpath路径下加载配置参数
	 */
	public void loadPropertiesFromSrc() {
		InputStream in = null;
		try {
			LogUtil.writeLog("从classpath: " + SDKConfig.class.getClassLoader().getResource("").getPath()+" 获取属性文件"+FILE_NAME);
			in = SDKConfig.class.getClassLoader().getResourceAsStream(FILE_NAME);
			if (null != in) {
				properties = new Properties();
				try {
					properties.load(in);
				} catch (IOException e) {
					throw e;
				}
			} else {
				LogUtil.writeErrorLog(FILE_NAME + "属性文件未能在classpath指定的目录下 "+ SDKConfig.class.getClassLoader().getResource("").getPath()+" 找到!");
				return;
			}
			loadProperties(properties);
		} catch (IOException e) {
			LogUtil.writeErrorLog(e.getMessage(), e);
		} finally {
			if (null != in) {
				try {
					in.close();
				} catch (IOException e) {
					LogUtil.writeErrorLog(e.getMessage(), e);
				}
			}
		}
	}

 需要一个类来初始化调用loadPropertiesFromSrc()方法读取acp_sdk.properties文件配置,在init包下创建UnionpayConfig.java:

package com.example.demo.init;

import com.example.demo.util.SDKConfig;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.context.annotation.Configuration;

@Configuration
public class UnionpayConfig implements ApplicationRunner {

    @Override
    public void run(ApplicationArguments args) {
        SDKConfig.getConfig().loadPropertiesFromSrc();
    }
}

SDKConfig.java FILE_NAME变量改成如图六所示,不然读不到acp_sdk.properties配置

图六

 3.测试

        可以写个页面表单提交参数进行测试,这里简单点直接在DemoController给参数赋值进行测试.

        //前台页面传过来的
        String merId = "777*****"; //商户号,请改成自己申请的777开头的测试商户号; 
        String txnAmt = "1000"; //req.getParameter("txnAmt");
        String orderId = String.valueOf(System.currentTimeMillis());  //req.getParameter("orderId");
        String txnTime = new SimpleDateFormat("yyyyMMddHHmmss").format(new Date().getTime()); //req.getParameter("txnTime");

 运行代码后,在浏览器输入localhost:8080/demo/pay访问,自动跳转到银联的支付页面:

 填上前面申请的测试账号进行支付,支付成功结果如下:

  • 2
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
### 回答1: Java银联商务支付接口是一种用于接入银联支付业务的开发工具,旨在帮助商户快速接入银联支付系统,实现线上线下支付的功能。 Java银联商务支付接口主要提供了以下几个核心功能: 1. 支付请求与应答的交互:商户可以通过该接口向银联支付平台发送支付请求,并获取到支付结果的应答信息。这包括了支付的金额、商户订单号、支付状态等相关信息。 2. 订单查询与退款:商户可通过该接口查询订单的支付状态和订单详细信息。此外,商户还可以发起退款请求,将支付金额退还给消费者,以实现订单的退款操作。 3. 回调通知功能:商户可以设置回调通知地址,用于接收银联支付平台的支付结果通知。当支付成功或失败时,银联支付平台会主动将支付结果发送给商户的回调地址,商户可以根据通知结果来更新订单状态等相关操作。 4. 其他功能:Java银联商务支付接口还提供了其他功能,如支付方式的限制、支付限额的控制、支付风险的评估等。商户可以根据自身需求进行相应的配置与调整。 综上所述,Java银联商务支付接口为商户提供了便捷的支付接入方式,帮助商户实现了与银联支付平台的连接,实现了支付功能的集成和支付结果的处理。通过该接口,商户可以更加方便地实现线上线下支付的功能,提升用户支付体验,并实现支付过程的安全性和稳定性。 ### 回答2: Java银联商务支付接口是一种用于在Java应用程序中连接到银联商务支付系统的接口。这个接口提供了一系列的方法和功能,使开发人员能够处理与付款、退款和查询交易相关的事务,以及与银联商务支付系统进行通信。 Java银联商务支付接口主要包含以下几个方面的功能: 1. 支付功能:开发人员可以使用这个接口来发起支付请求,将必要的支付参数传递给接口,以便与银联商务支付系统进行交互,并完成支付流程。这包括验证支付参数的合法性,生成并提交支付请求,处理支付结果等。 2. 退款功能:开发人员可以使用接口提供的方法来执行退款操作,包括查询可退款金额,创建并提交退款请求以及处理退款结果等。 3. 查询功能:通过接口提供的查询方法,开发人员可以查询支付交易、退款记录和交易状态等信息。这方面的功能可以帮助商户实时了解交易的状态和结果。 4. 异步通知:接口还提供了异步通知功能,当交易状态发生变化时,银联商务支付系统会向商户的回调地址发送通知,开发人员可以在接口中处理这些通知并更新相应的交易信息。 Java银联商务支付接口的使用可以帮助开发人员在Java应用程序中实现与银联商务支付系统的交互功能。这个接口的设计和功能使得开发人员可以方便地处理支付、退款和查询等事务,并及时获得交易结果和状态。同时,接口还提供了异步通知功能,能有效地帮助商户与银联商务支付系统进行实时的交互和信息更新。 总而言之,Java银联商务支付接口是一个强大且方便的工具,可以帮助开发人员在Java应用程序中实现与银联商务支付系统的支付、退款和查询等功能。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值