3.1.1. 银行直连客户端部署
(1) 根据银行提供的长沙银行现金管理工具和配置说明进行安装
(2) .运行执行程序HS.CMS.Transmitter.exe安装通讯机,如下图:
(3) 安装过程中请选择:
(4) 安装结束后,在快速启动栏中找到银企通讯平台V2.0,选择系统参数配置,如图:
(5) 或右键桌面快捷方式,打开文件所在目录,
(6) 通讯参数设置
通讯连接界面,如图:
参数解释:
名 称: 银企接入平台服务器(该名称可以用户自定义,用于标识,无实际意义)
服 务 器: 银企平台服务器IP,测试环境:218.xxxxx,以银行提供为准
交易端口: 银企平台侦听端口,交易端口:10030
文件端口: 银企平台文件传输端口,文件端口:64083
超时时间: 普通交易延时 (一般设置10—60秒之间)
启用SSL: 如果银企平台服务器为ssl所在机器地址则勾选上
企业代码: 企业用户在现金管理平台注册代码,测试环境(银行提供),生产环境不需要配置。
注意事项:目前测试环境无UEKY联调,SSL不启用。
网络代理界面,如图:
安全认证界面,如图:
代理类型:采用的代理模式(socket、http、不用代理)
服务器: 采用代理的服务器IP
端口: 代理服务侦听端口
用户名: 代理服务用户名
密码: 代理服务密码
参数解释:
启用安全证书:选中则采用安全认证模式,否则为普通模式。
证书类型:分为文件证书、以及硬件证书(USBKEY)两种模式。
用户证书:当证书类型选择为文件证书时,该选项可用。
根证书: 当证书类型选择为文件证书时,该选项可用。
注意事项:目前测试环境无UEKY联调,此处不启用。
生产环境暂时只支持硬件证书。
升级更新界面,如图:
参数解释:
名 称:银企接入升级服务器(用户可自定义,用户区分)
服务器:升级服务器IP:218.xxx(以银行实际给的为准)
端 口:升级服务器侦听端口(可为空,为空则表示不进行升级,生产上默认勾选上)
升级端口:64083
路 径:升级文件下载路径(ClientUpdate/Transmitter)
启用SSL: 如果银企接入升级服务器为ssl所在机器地址则勾选上
注意事项:测试环境不启用SSL
5.参数设置完成后,运行程序,如图:
输入用户名、密码登录系统,如上图,用户名和密码请联系开发人员创建后提供。
点击切换用户旁边钥匙图标进行申请授权(如果是测试的可以不用申请,若没授权每日交易笔数上限500笔)
将申请码发给开发人员进行授权申请(最好授权码保存成一个txt)
6.通讯机参数配置,点击菜单栏中参数配置选项,如图:
企业接入界面,如图
参数解释:
通讯协议:选择接入方式为socket(即TCP) (接入方式包括http、socket)
超时时间:普通交易超时间(一般设置为10~60秒)
交易端口:前置机作为服务器的交易端口默认10010,用于银企上配置前置机的安全服务端口号
文件端口:前置机作为服务器的文件端口默认20010,银企暂时未用上端口
访问控制界面,如图
参数解释:
允许以下列表网络ip进行通信:如果勾选此项则只允许下面列表的ip区间端进行通讯
禁止以下列表网络ip进行通信:如果勾选此项则只禁止下面列表的ip区间端进行通讯
7.启动通讯服务,如图:
前提:需要更新银企云最新补丁
(1)登录金蝶云星瀚,进入银企云的应用【查询与支付】
(2) 进入【银企连接通道配置】页面,选择长沙银行直联版,然后点击新增
(3) 进入前置机新增页面,对基础连接配置和网银登录配置参数进行配置
前置机IP地址:安装长沙银行前置机软件的服务器IP地址,需要先维护到菜单【安全访问白名单】中
端口号:长沙银行前置机,企业接入,通讯设置中的交易端口对应;
并发锁数量:同时提交银行前置机的并发锁设置,默认1,如果银行支持多并发则可以设置,但是并发锁数量之和不能大于银行前置机的最大并发,否则会导致交易出现问题。
金蝶代理服务器端口号:批量付款和交易明细都是文件,需要安装部署金蝶前置机代理程序进行解析和上传。
配置完成后,点击保存,然后点击测试连接;
注意:点击测试连接,代表银企到前置机安装的服务器端口通了;如果不通的话,请检查ip和端口的配置,如果是公有云环境,这里测试连接不通是正常的,需要通过网络代理连接配置中进行测试连接,请参考网络代理连接配置
如何添加银企账户
4.1.3. 银企联通测试
银企账户配置完成之后,可以在在【查询与支付】-银行账户查询内,查询该账户余额,如果余额能够成功查询,代表与银行前置机的通讯配置是成功的,可以进行实际的交易测试;
银行参数配置本身有默认参数,如果没有特殊情况可以不用配置。以下只对本银行的关键参数进行说明:
1、支付/非支付通道开关说明
2、业务单据防重付款验证开关
3、回单明细限制查询日期:
4、交易明细摘要取值:
5、付款摘要特殊字符池:
6、 代发业务参数:
是否启用代发工资业务:默认不启用,如需通过银企代发工资(工资代发单)则开启参数,不控制报销代发单。
关联接口:仅查看作用,仅查看银行代发工资有哪些接口,不影响实际路由走向