1. 余额-历史余额批量新增接口 1.1. 接口概要信息 | 接口名称 | 余额-历史余额批量新增接口 | 接口编码 | | | ----------------------- | ------------------------ | --------------------- | ----------- | | 接口类型 | 同步类 | 所属系统 | 资金管理系统 | | 数据类型 | 余额-历史余额数据 | 厂商 | | | 版本 | V3.8.3 | 服务端 | 资金系统 | | 数据流向 | 外系统→资金系统 | 接口调用方式 | 实时 | | 接口协议

业务场景说明： 1、共享启用了资金系统，由资金系统对接各个银行发送指令和查询付款结果，需要启用推送支付指令和查询指令支付状态定时器，推送支付指令定时器会定时把全量线上指令发给各个银行。查询指令支付状态会查所有线上的指令状态。（ 注意：开箱即用脚本删除付款信息同步和付款结果查询定时器 ，并重启定时器微服务 ， 这两定时器后续会有场景说明） ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:...

1、linux环境：http://tmpbbs.ztc.ztccloud.com.cn:6875/faq/1313139 2、Windows 环境 1、备份前置机原来的生产包 2、获取最新的接口机包，找资金组获取 3、如果applicantion.yml已经和jar同一目录，替换包，关闭 .bat,再双击 .bat重启接口机即可 4、如果applicantion.yml和jar包不是同一目录,从生产备份jar包中拿到applica...

银企直联接口机是企业与银行之间进行数据交换和业务处理的重要桥梁。开发银企直联接口机需要考虑多个方面，以确保系统的安全性、稳定性和高效性。本文将详细介绍在需求评审、开发、联调和部署过程中需要注意的关键事项，帮助开发人员更好地理解和实现银企直联接口机的开发工作。 需求评审注意事项 1. 提供分析后的银企接口清单 ：便于确定银行接口字段和资金入参的映射关系，确保接口调用的准确性。 2. 提供银行原版银企接口文档 ：用于确定接口调用方式和报文入参/出参的补充信息，确保接口实现符合银行要求。 3. 提供银行测试数据 ：如客户号、操作员号、测试账号等信息，便于在开发和测试过程中进行真实数据模拟。 4. 提供接口返回报文用于接口挡板模拟解析 ：如无银行公网测试环境，需提供接口返回报文，以便进行接口挡板模拟解析。 5. 提供前置机安装部署文档 ：如需开发部署银行前置机，需提供前置机安装部署文档，确保网络提前开通，保证部署顺利进行。 开发注意事项 1. 分析资金调用接口机流程 ：明确参数如何组装，收到接口机返回结果后如何入库，确保数据处理...

在上一篇文章中，我们介绍了如何通过HTTP方式进行挡板测试，详见[银企直联接口机开发之-挡板测试（HTTP请求方式）](http://tmpbbs.ztc.ztccloud.com.cn:6875/article/1332531)。然而，在接口机开发的实际场景中，我们经常会遇到需要通过Socket请求方式与银行系统进行通信的情况。与HTTP请求不同，Socket请求通常是基于IP地址和端口号的，这意味着我们不能通过URL参数来区分不同银行的请求。为了解决这一问题，我们需要深入分析原有接口机的调用流程，并在每个使用Socket请求的银行接口中引入挡板逻辑。 为了实现这一目标，我们将创建一个Socket服务端，它将作为接口机的一部分。当接口机需要与银行系统通信时，它将向这个内置的服务端发送请求。这样，我们就可以在本地处理逻辑，而不是直接与远程银行服务器交互。这种方法不仅有助于我们在开发和测试阶段模拟银行系统的行为，而且还能提高整体的开发效率。下面，我将详细介绍如何实现这一Socket挡板测试的具体方法。 1、启动一个Socket服务端，可自定义端口（注意不要端口冲突） ![imag...

1.基础环境准备 1.1.硬件准备 1.2.软件安装 由于接口机需要在jdk环境下运行，因此需要安装jdk文件，安装时一直点击“下一步”直到安装完成即可

在资金银企直联接口的开发过程中，我们常常面临一个问题：部分银行不提供公网请求地址，或者我们没有配置前置机，这使得我们在开发完成后缺乏合适的环境来进行接口联调。这种情况迫使我们将接口部署到生产环境中进行测试，但这样做存在诸多风险，包括测试不充分和无法执行大规模数据测试等问题。 为了解决这些问题，开发一个前置机挡板程序，通过模拟银行的接口响应，来进行本地测试。这种方法不仅提高了测试的效率和安全性，还允许我们在开发阶段就能进行全面的接口测试。下面，我将详细介绍如何使用HTTP请求方式进行挡板测试的步骤。 1、在我们正常开发完接口时，将配置文件中接口请求地址改为我们部署的挡板服务地址，并带上大行简称，如： http://127.0.0.1:28112/cmb。 招商银行配置 cmb: 操作员号 cusopr: 直联票据测试用户1 收票方 gatherUser: 直联票据测试用户1 dateType: 2 业务模式编号 busmod: '00002' type: 接口查询URL

前置条件：保证本方接口机部署环境与银行测试环境互通（项目需先申请开通网络） 1、获取建行接口机jar包 项目部署建行CCIP版本，先提供银行测试数据和接口文档，向产品邮件申请后获取接口机部署包 2、建行密钥交互操作步骤 1、修改客户编号、密钥交互URL（银行提供测试数据） 2、密钥交互-银行方：与银行人员沟通提供我方公钥下载接口地址：[http://127.0.0.1: 9988/ccb/transKey ](http://127.0.0.1:9988/ccb/transKey) 3、密钥交互-本方：获取DES银行对称密钥（get请求）：http://127.0.0.1:9988/ccb/getKey?type=des 4、密钥交互-本方：获取银行RSA公钥...

接口描述 请求地址： /outapi/accountTransQuery 接口编号：FSSC-API-000089 所属系统：资金管理系统 接口诞生版本：3.6.1 所属微服务：zfs-fms 接口说明：用于提供给外系统查询资金交易明细调用 单次调用最大条数：1000 报文编码格式：UTF-8 注意事项：暂无 请求参数 | 参数名 | 中文名称 | 类型 | 是否必填 | 示例 | 参数说明 | | -------------- | ----------------- | ------ | ------- | ------------------ | ----------------------------------------------------------

1. 基础环境准备 1.1. 硬件准备 1.2. 软件安装 由于接口机需要在jdk环境下运行，因此需要安装jdk文件，安装时一直点击“下一步”直到安装完成即可 软件SVN地址：https://svn.ztccloud.com.cn:18080/svn/springcloud_product/trunk/doc/产品经营中心/03-原型产品研发过程资料/接口机/jdk-8u181-windows-x64.exe 1.3. 网络调试 1.3.1. 司库和前置机网络 需要保证司库服务器的网络和前置机的网络打通，建议前置机和司库的服务器最好放到同一机房，若没有放在一起则需要客户的信息部门协助打通一下网络。 测试网络是否联通的方式，linux命令：ping 192.168.234.1，此处IP地址换成前置机ip地址即可 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/de...

1. 基础环境准备 1.1. 硬件准备 1.2. 软件安装 由于接口机需要在jdk环境下运行，因此需要安装jdk文件，安装时一直点击“下一步”直到安装完成即可 软件SVN地址：https://svn.ztccloud.com.cn:18080/svn/springcloud_product/trunk/doc/产品经营中心/03-原型产品研发过程资料/接口机/jdk-8u181-windows-x64.exe 1.3. 网络调试 1.3.1. 司库和前置机网络 需要保证司库服务器的网络和前置机的网络打通，建议前置机和司库的服务器最好放到同一机房，若没有放在一起则需要客户的信息部门协助打通一下网络。 测试网络是否联通的方式，linux命令：ping 192.168.234.1，此处IP地址换成前置机ip地址即可 ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/de...

背景： 绿发项目银企需对接上海银行，且该银行之前未通过接口机开发，因此本次通过DT对接。 银企分析流程： 1. 请求基本流程： 1. DT请求银行的签名服务，将交易报文签名并获取签名后密文。 2. DT用密文再进行登录交易，获取登录的session_id。 3. DT用获取的session_id加上密文发起业务请求，或DT用获取的session_id加上原文发起业务请求。注：查询类交易可用明文，转账以及登录交易用密文。 4. DT获取返回报文后，进行业务处理。并返回给资金系统 5. 资金系统展示数据，完成银企直联流程。 上海银行特殊报文分析： 1. 登录交易： 上海银行在进行交易之前需要模拟登录，并获取关键字段session_id. 且登录返回的报文为固定格式dse_sessionId+ “|” + 交易返回XML包. 需处理返回报文，解析出dse_sessionId以及XML包。 2. 部分交易需要签名，签名的固定报文格式如下： ...

资金管理

视频操作： [接口机升级步骤](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group1/2023/04/14/A04ABFCBFFFF8AD2346453D5B1B7B2AE07B9.mp4) 1.与客户沟通更新时间 更新时与客户沟通好，提前通知客户停止操作系统 2.关闭接口机程序 3.备份资金接口机程序 找到对应的资金接口机程序包，备份文件（改名成zfs-bank-server-yyyy-MM-dd.jar） ![image.png](http://tmpbbs.ztc.ztccloud.com.cn:6875/developers-server/rest/file/group...

SAAS项目银企直连交付流程【适用于本地化项目资金系统银企直连】 备注：SAAS交付与运维实施经验，仅供参考 | 一、前期准备工作 | 1、客户准备前置机、固定IP地址2、确定银企直连银行，对接银行客户经理，填写银企直连申请表3、安装银行直联机，配置数据 | | --------------- | ---------------------------------------------------------------------------------------------------------------- | | 二、开发测试工作 | 1、安装新云接口机，进行接口开发2、测试环境资金系统配置及内部测试3、提交银行银企直连测试报告 | | 三、环境切换工作 | 1、客户与银行对接，签约合同发盾2、银行和新云转生产环境配置3、收集客户数据，配置资金系统生产环境，上线运行 | SAAS项目银企直连交付整体流程： A.根据合同确认银企直连对接银行------B.与产品沟通是否有标准接口