springboot 银联支付（企业网银支付）

---

springboot 银联支付（企业网银支付）

 

应用：企业与企业之间的资金转账、支付等

官方文档：https://open.unionpay.com/tjweb/acproduct/list?apiSvcId=452

 

 

*************************

示例

 

**********************

配置文件

 

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://gzx7g4.natappfree.cc/notify

#前台通知地址，填写银联前台通知的地址，必须外网能访问
acpsdk.frontUrl=http://gzx7g4.natappfree.cc/return

#########################入网测试环境签名证书配置 ################################
# 多证书的情况证书路径为代码指定，可不对此块做配置。
# 签名证书路径，必须使用绝对路径，如果不想使用绝对路径，可以自行实现相对路径获取证书的方法；测试证书所有商户共用开发包中的测试签名证书，生产环境请从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 {
 
    String pay(String orderId,String txnAmt);    //支付接口
}

 

**********************

serviceImpl 层

 

UnionpayServiceImpl

@Service
public class UnionpayServiceImpl implements UnionpayService {
 
    @Override
    public String pay(String orderId, String txnAmt, String termId) {
        Map<String, String> requestData = new HashMap<>();

        /***银联全渠道系统，产品参数，除了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", "000202");             //业务类型 000202: B2B
        requestData.put("channelType", "07");             //渠道类型 固定07


        /***商户接入参数***/
        requestData.put("merId", "777290058180063");      //商户号码，请改成自己申请的正式商户号或者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("accNo","123456789001");

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


        //实现网银前置的方法：
        //上送issInsCode字段，该字段的值参考《平台接入接口规范-第5部分-附录》（全渠道平台银行名称-简码对照表）2）联系银联业务运营部门开通商户号的网银前置权限
        //requestData.put("issInsCode", "ABC");                 //发卡机构代码

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


        // 请求方保留域，透传字段，查询、通知、对账文件中均会原样出现，如有需要请启用并修改自己希望透传的数据。
        // 出现部分特殊字符时可能影响解析，请按下面建议的方式填写：
        // 1. 如果能确定内容不会出现&={}[]"'等符号时，可以直接填写数据，建议的方法如下。
        //requestData.put("reqReserved", "透传信息1|透传信息2|透传信息3");

        // 2. 内容可能出现&={}[]"'符号时：
        // 1) 如果需要对账文件里能显示，可将字符替换成全角＆＝｛｝【】“‘字符（自己写代码，此处不演示）；
        // 2) 如果对账文件没有显示要求，可做一下base64（如下）。
        //    注意控制数据长度，实际传输的数据长度不能超过1024位。
        //    查询、通知等接口解析时使用new String(Base64.decodeBase64(reqReserved), DemoBase.encoding);解base64后再对数据做后续解析。
        //requestData.put("reqReserved", Base64.encodeBase64String("任意格式的信息都可以".toString().getBytes(DemoBase.encoding)));


        /**请求参数设置完毕，以下对请求参数进行签名并生成html表单，将表单写入浏览器跳转打开银联页面**/
        Map<String, String> reqData = AcpService.sign(requestData,DemoBase.encoding);  //报文中certId,signature的值是在signData方法中获取并自动赋值的，只要证书配置正确即可。
        String requestFrontUrl = SDKConfig.getConfig().getFrontRequestUrl();  //获取请求银联的前台地址：对应属性文件acp_sdk.properties文件中的acpsdk.frontTransUrl
        return AcpService.createAutoFormHtml(requestFrontUrl,reqData,DemoBase.encoding);   //生成自动跳转的Html表单
    }
 
}

 

**********************

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.pay8(DemoBase.getOrderId(),"20000"));
    }
 
    @RequestMapping("/return")
    public String fun(HttpServletRequest request){
        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);
                }
            }
        }
    }

    @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");
    }
}

 

 

*************************

使用测试

 

localhost:8080/pay