记录建行外联平台退款操作
ps: 这是我对接最复杂繁琐的一个接口，需要先安装行方提供的外联平台客户端，才可以调用退款接口；小白的我，安装过程中一堆的坑，网上搜了个遍没有找到一个可以参考的过程，在此做个记录。
主要分为以下几步
和行方对接沟通好一定要(一定要多问行方对接人员，不要自己去猜，不懂就问！)去建行商户平台创建操作员账户（后面退款操作需要用到）准备操作员-商户证书（这里这个证书是个最大的坑）安装建行客户端具体退款操作
先说第一点，沟通，一定要多问（血泪史），行方从开始对接退款给我的文档，一共给了三个版本。上图：
经过测试，对，没错，我把三个版本文档给的东西都试了，最后一个版本可行，当时第一个版本里面提示安装要windows server 2003环境，这东西我上阿里云看了，都找不到了，阿里镜像说不提供2003的淘汰了，微软不维护2003版本了。第一个版本里面讲的是用网盾的方式(百度过说要一直放在前置机上，不现实)，这玩意儿一般都在公司财务那里，也不好随便拿来用。第二个版本文档和第三个版本文档接近，主要用第三个版本文档，选择的安装方式是安装在linux服务器。内容如下：
解压文件方式：
先解压part1会自动解压part2(是两个压缩分卷)
解压完可以得到如下目录
然后主要根据如下三个文档提示操作：
开始客户端安装操作
1、创建操作员账号
登录主商户号，进入“服务管理”-》“操作员管理”，点击新增
依次填写如下信息，因为我们需求是单笔退款即可，所以我勾选的是单笔退款（根据需求来选择权限）
添加完账户后开始下载证书。
2、准备证书（注：证书只能下载一次，请妥善保存；没找到可联系行方重置证书重新下载）
在建行商户服务平台下载"E路护航"工具，此工具用于安装证书文件
运行"E路护航"工具，点击 证书更新-》商户证书下载，第一步 依次填写相关字段，点击提交；进行到第二步的时候选择加密导出；（注：操作员的客户号，默认格式是 商户号-操作员号，手机号码填写新增操作员时填写的手机号）
执行完后会出现如下画面
点击进入商户服务平台，会跳转到设置密码的页面；第二次进入商户平台会提示选择证书，点击确定，即可 以操作员账户登录商户平台
如何下载到本地
打开ie浏览器，点击internet选项
点击 内容->证书
证书列表，点击导出
点击下一步，选择 “是，导出私钥，继续下一步”
到设置密码这里填写证书密码，加密方式默认即可，填写的密码记得备份记录，然后下一步，填写文件名称选择证书保存路径，继续下一步
点击完成，即可导出证书到本地目录
3、将证书放在解压好的文件的cert目录下
4、上传整个解压文件到linux服务器
根据文档 “网银外联平台安装手册”来安装建行外联平台客户端
打开bin目录，运行外联平台客户端启动脚本sh startService.sh,依次输入参数
看到如图所示，即客户端安装启动完成
PS补充:启动乱码可尝试修改服务器系统字符集编码：
vim /etc/locale.conf
替换：LANG=en_US.UTF-8 为：LANG=zh_cn.GB18030
source /etc/locale.conf
客户号：建行给的商户号
操作员号：上面新建的操作员号 格式：商户号-操作员号
交易密码：支付密码
证书密码：导出证书时填写的密码
端口号：连接服务的端口
是否使用专线：默认选择N就可以
----------------------------------------------------------------------------------------
补充内容：常见报错
0130Z1101018
ps：客户号不存在或客户没有开通外联平台业务
可能原因：
1、创建好操作员账号必须登录一次；（可以登录表示有下载登录证书）
2、操作员客户号格式是 商户号-操作员号
3、证书必须用操作员的证书 （操作员证书和商户证书是两个，需要单独下载）
安装完外联平台客户端后，即可开始退款接口的调用啦！
具体退款操作参考说明文档中的外联平台商户开发接口V40.chm和网银外联平台用户手册_V5.1_20180511.pdf
具体退款封装的工具类
import com.baosoft.utility.tools.Conv;
import com.snsoft.ymbank.schedule.services.BrBase;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.net.Socket;
import java.text.SimpleDateFormat;
import java.util.Date;
/**
* @author Ljx
* @date 2021/7/6 18:09
* @description 建行外联平台退款工具类
*/
public class WailianSocketUtil extends BrBase {
private final static String ipAddress = "";//公网地址
//private final static String ipAddress = "";//内网地址
private final static int nPort = ;//部署的外联平台客户端端口
private static String sendSocketRequest(String ipAddress, int nPort, String sRequest) throws IOException {
Socket socket = null;
socket = new Socket(ipAddress, nPort);
BufferedReader ins = new BufferedReader(new InputStreamReader(socket.getInputStream(), "GB18030"));
PrintWriter outs = new PrintWriter(socket.getOutputStream());
outs.print(sRequest);
outs.flush();
socket.shutdownOutput();
String sLine = null;
StringBuffer sb = new StringBuffer();
while ((sLine = ins.readLine()) != null) {
sb.append(sLine);
}
ins.close();
outs.close();
socket.close();
return sb.toString();
}
/**
* @return
* @date: 2021/7/7 13:48
* @params userId 操作员号
* @params password 操作员支付密码
* @params money 退款金额
* @params orderId 订单号
* @description:
*/
public static String payByCcbRefund(String userId, String password, double money, String orderId) {
/*if (StringUtils.isEmpty(userId)) {
throw new Exception("退款参数操作员号不能为空!!!");
}
if (StringUtils.isEmpty(password)) {
throw new Exception("退款参数操作员支付密码不能为空!!!");
}
if (StringUtils.isEmpty(money)) {
throw new Exception("退款参数退款金额不能为空!!!");
}
if (StringUtils.isEmpty(orderId)) {
throw new Exception("退款参数订单号不能为空!!!");
}*/
//生成序列码
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
String REQUEST_SN = sdf.format(new Date());
//参数对象
StringBuffer sb = new StringBuffer();
sb.append("");
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("");
sb.append("");
String sRequest = sb.toString();
logger.info("退款请求报文:"+sRequest);
String result = null;
try {
result = sendSocketRequest(ipAddress, nPort, sRequest);
} catch (IOException e) {
logger.error(e.getMessage());
e.printStackTrace();
}
System.out.println(result);
return result;
}
/**
* @return
* @date: 2021/7/7 13:48
* @description:退款查询接口
*/
public static String payByCcbRefundQuery(String userId, String password, String orderId,String kind) {
//生成序列码
//SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
//String REQUEST_SN = sdf.format(new Date());
String REQUEST_SN = Conv.toStr(System.currentTimeMillis());
//参数对象
StringBuffer sb = new StringBuffer();
sb.append("");
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("");
sb.append("");
String sRequest = sb.toString();
logger.info("退款流水查询请求报文:"+sRequest);
String result = null;
try {
result = sendSocketRequest(ipAddress, nPort, sRequest);
} catch (IOException e) {
logger.error(e.getMessage());
e.printStackTrace();
}
System.out.println(result);
return result;
}
/**
* @return
* @date: 2021/7/7 13:48
* @description: 支付流水查询
*/
public static String payByCcbQuery(String userId, String password, String orderId,String kind) {
//生成序列码
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
String REQUEST_SN = sdf.format(new Date());
//参数对象
StringBuffer sb = new StringBuffer();
sb.append("");
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("
sb.append("");
sb.append("");
String sRequest = sb.toString();
logger.info("支付流水查询请求报文:"+sRequest);
String result = null;
try {
result = sendSocketRequest(ipAddress, nPort, sRequest);
} catch (IOException e) {
logger.error(e.getMessage());
e.printStackTrace();
}
System.out.println(result);
return result;
}
}