记录建行外联平台退款操作

已于 2023-11-24 11:03:15 修改
阅读量9.9k 收藏 25
点赞数 13
分类专栏： 日常整理 文章标签： 接口
于 2021-08-10 20:45:20 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_40431100/article/details/119008674
版权
本文详细记录了对接建设银行外联平台退款接口的全过程，包括创建操作员账户、下载证书、安装客户端以及退款接口调用的步骤。还特别提到了在安装和配置过程中遇到的问题，如不兼容的系统环境、证书管理等，并给出了错误代码的解析。同时，提供了退款接口的Java工具类代码示例，帮助开发者理解和实现退款操作。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

记录建行外联平台退款操作

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("<?xml version=\"1.0\" encoding=\"GB2312\" standalone=\"yes\" ?>");
        sb.append("<TX>");
        sb.append("<REQUEST_SN>" + REQUEST_SN + "</REQUEST_SN>");//请求序列码
        sb.append("<CUST_ID>商户号</CUST_ID>");//商户号
        sb.append("<USER_ID>" + userId + "</USER_ID>");//操作员号 
        sb.append("<PASSWORD>" + password + "</PASSWORD>");//操作员支付密码
        sb.append("<TX_CODE>5W1004</TX_CODE>");//交易请求码
        sb.append("<LANGUAGE>CN</LANGUAGE>");//语言
        sb.append("<TX_INFO>");
        sb.append("<MONEY>" + money + "</MONEY>");//退款金额
        sb.append("<ORDER>" + orderId + "</ORDER>");//退款订单号
        sb.append("</TX_INFO>");
        sb.append("</TX>");
        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("<?xml version=\"1.0\" encoding=\"GB2312\" standalone=\"yes\" ?>");
        sb.append("<TX>");
        sb.append("<REQUEST_SN>" + REQUEST_SN + "</REQUEST_SN>");//请求序列码
        sb.append("<CUST_ID>商户号</CUST_ID>");//商户号
        sb.append("<USER_ID>" + userId + "</USER_ID>");//操作员号
        sb.append("<PASSWORD>" + password + "</PASSWORD>");//操作员支付密码
        sb.append("<TX_CODE>5W1003</TX_CODE>");//交易请求码
        sb.append("<LANGUAGE>CN</LANGUAGE>");//语言
        sb.append("<TX_INFO>");
        sb.append("<KIND>" + kind + "</KIND>");//0:未结流水,1:已结流水
        sb.append("<ORDER>" + orderId + "</ORDER>");//退款订单号
        sb.append("<NORDERBY>2</NORDERBY>");//排序 1:交易日期,2:订单号
        sb.append("<PAGE>1</PAGE>");//当前页次
        sb.append("<STATUS>3</STATUS>");//流水状态 0:交易失败,1:交易成功,2:待银行确认(针对未结流水查询);3:全部
        sb.append("</TX_INFO>");
        sb.append("</TX>");
        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("<?xml version=\"1.0\" encoding=\"GB2312\" standalone=\"yes\" ?>");
        sb.append("<TX>");
        sb.append("<REQUEST_SN>" + REQUEST_SN + "</REQUEST_SN>");//请求序列码
        sb.append("<CUST_ID>商户号</CUST_ID>");//商户号
        sb.append("<USER_ID>" + userId + "</USER_ID>");//操作员号
        sb.append("<PASSWORD>" + password + "</PASSWORD>");//操作员支付密码
        sb.append("<TX_CODE>5W1002</TX_CODE>");//交易请求码
        sb.append("<LANGUAGE>CN</LANGUAGE>");//语言
        sb.append("<TX_INFO>");
        sb.append("<KIND>" + kind + "</KIND>");//0:未结流水,1:已结流水
        sb.append("<ORDER>" + orderId + "</ORDER>");//退款订单号
        sb.append("<DEXCEL>1</DEXCEL>");//DEXCEL
        sb.append("<NORDERBY>2</NORDERBY>");//排序 1:交易日期,2:订单号
        sb.append("<PAGE>1</PAGE>");//当前页次
        sb.append("<STATUS>3</STATUS>");//流水状态 0:交易失败,1:交易成功,2:待银行确认(针对未结流水查询);3:全部
        sb.append("</TX_INFO>");
        sb.append("</TX>");
        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;
    }
}
_网银外联平台用户手册(Jar包版)_V1.11_201901241
08-04
（1） 每个操作员在发送交易之前，须先调用 RequestProcess 类的 （2） 调用参数说明： （1） RequestProcess 类的 sendRe
通过建设银行外联平台进行转账/提现操作（Java）
F2Zf的博客
08-13 1万+
由于公司业务发展，需要对接建行的一些接口，我这边负责的是用户提现功能（从公司账户转账到用户账户的转账操作）。建行那边给了一些资料，下面就详细介绍一下实现过程。 以上为建行提供的一些文档和所需要用得到的软件。 从第一个文件开始解释： CCB_EBSClient_B2BV5.3Build20160618 这个文件就是建行提供的外联平台，需要安装到前置机（服务器）上。 龙支付 这个文件与本
外链平台有哪些？2025年最全外链资源汇总
最新发布
vlogbbs的博客
02-19 679
外链平台是指允许用户发布链接的网站或平台，通过这些平台发布的外链可以引导用户访问目标网站，同时传递权重。外链平台的质量直接影响外链的效果，因此选择高权重、相关性强的平台至关重要。外链平台的选择直接影响SEO效果，合理利用外链平台有哪些这一关键词，可以帮助您找到适合的外链资源。无论是论坛、博客还是社交媒体，都需要根据网站需求制定外链建设策略。希望本文能为您的外链建设提供有价值的参考！
php 建行外联平台退款
yangtao3300的博客
08-17 897
因为公司业务需要最近对接了建行的支付，在完成了支付和jar包验签之后。发现还剩下一个退款功能，然后联系建行那边给发了一个外联平台的文档。我想知道退款是必须要用这个外联平台吗？没有那种直接调用接口直接交互的吗，现在实在是不知道怎么下手啊，急求 ...
对接建行支付
A-bing的博客
11-18 7730
对接建行支付，通过微信或龙支付H5进行付款。
建行对接微信支付
热门推荐
方圆师兄
05-29 1万+
/为了安全情况下，需要把参数，进行校验，一下方法简写，忽略校验了。为了方便可以在本地将证书添加到外联品台里，或者使用pv挂载。kubectl create -f 文件名称。
建行USB
06-15
建行网银个人网银握奇驱动程序
PHP 之建行龙支付 - 退款
weixin_42674576的博客
01-11 2821
PHP 建行龙支付 退款
对接银行处理退票的解决方案
路漫漫其修远兮 吾将上下而求索
05-11 1237
在跨行支付时，付款请求提交汇出行后，由汇出行转交至人民银行支付系统，经人民银行大小额系统处理后会先返回交易成功的结果，再由人民银行转至收款行，收款行在清算过程中会将收款人账户信息、状态、款项用途信息不符、异常、不合规等无法入账的款项原路退回至原汇出行，这个过程就是退票。因此交易成功的状态不一定表示收款账户已入账。产生原因：若收款账号输入错误、收款人姓名与开户银行预留户名不符或开户银行信息不正确、款项用途信息不符等都有可能造成退票。表现形式：会查回一笔金额、对方信息完全一致的收款；
建行退款隔天退不了逻辑
cainiao1923的博客
12-25 2179
支付金额>=退款 才能退款 支付<退款 退款-支付 的部分 是退不了的 退36 ，今天进40 ，退完后还进4， 再退40，就只能退4，剩下36退不了 退账跟进账对应起来，先有进才有退，但是昨天的进跟今天的退对不起来，所以隔天退不了。（简单说，每天不能出现负账） ...
Windows2008Server64(.NET平台)建行验签组件
11-05
之前做建行的网上支付，遇到验签接口不支持winserver2008的情况，后来是将服务器换成server2003了，现在这个接口可以支持server2008、win7了，运行环境.net4.0
PHP后端银联支付及退款实例代码
10-19
本篇文章主要介绍了PHP后端银联支付及退款实例代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
中国建设银行电子商务金融服务平台商城账户操作手册.doc
11-21
【中国建设银行电子商务金融服务平台】是中国建设银行推出的一项创新服务，旨在为商家和消费者提供便捷、安全的在线交易环境。该平台集成了多种金融服务功能，包括但不限于账户管理、支付结算、风险管理、数据分析等...
1.商业银行外联业务系统-商业银行外联网接入平台探讨[归类].pdf
10-19
【外联网建设】的目标是建立统一、安全、高效的外联平台。这包括在一级分行设立技术规范一致的接入点，实施严格的安全控制，如DMZ前置区，以隔离内外网，并利用防火墙和入侵检测设备加强安全管理。二级分行则通过VP
5.1-夏慧+青年秀+基于统一外联平台的银医建设模式.zip
01-08
【标题】：“5.1-夏慧+青年秀+基于统一外联平台的银医建设模式.zip”这一压缩包文件，主要围绕的是智慧医院的建设，特别是如何利用现代信息技术实现银医合作的创新模式。这一方案的核心是构建一个统一的外联平台，以...
java建行转账接口开发_建行网银接口开发注意事项
weixin_42557656的博客
02-27 1300
建行网银开发过程并不复杂，但就是部署的时候经常出现一些异常的错误。实际就是实例化CCBRSA.RSASig rsa = new CCBRSA.RSASigClass();的时候会有问题。Retrieving the COM class factory for component with CLSID {A5C5C388-A972-4CCF-93E2-7F97E82C9EBA} failed du...
java Map转XML XML转JSON
weixin_38342534的博客
06-13 655
最近项目要接建行的外联平台，与建行的通讯是通过xml进行的，xml在对接微信的时候也是用过的，所以就想着直接拿工具类来使用，报错了。 首先看下建行要求的xml格式 ，如下图，首先是这个xml头不一样 （<?xml version="1.0" encoding="GB2312" standalone="yes" ?>）首先是encoding 不是utf8 还多了一个standalon...
niushop单用户商城的退款和提现接口怎么写
u011988923的博客
05-28 433
这里写自定义目录标题欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 有人知道ni...
评论 32
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值