变更记录
产品版本
| 更新内容 | 更新日期 |
V5.0.006 | 初始版本 | 2022年06月28日 |
V6.0.4 | 新增支持国密证书
| 2023年12月26日 |
...... | ...... |
|
1. 背景
配置之前,先要和银行申请环境和资料,该版本为开放平台版,无需安装前置机,工商银行开放平台版(会提供API申请表格,填写提交银行来进行接口开通和获取测试资料)。
银行提供资料请参考:
(1) 客户相关数据;(密钥证书、APPID、客户编号、证书id)
(2) 测试使用账套数据;
请仔细阅读文档。清晰步骤了再进行配置。
2. 资料申请
和银行沟通申请版本时需要区分开放平台版和推广版(NC);
(1) API版本申请,需要填写申请表,并且需要在工行开放平台进行注册和配置;(后续补充申请材料样例)工行开放平台地址:https://open.icbc.com.cn/icbc/apip/index.html
(2) NC版需要安装前置机,并且需要申请实体U盾;NC前置机如图:
3. 安装部署银企云
3.1配置银企连接通道配置参数
(1) 登录金蝶云星瀚,进入银企云的应用【查询与支付】
(2) 进入【银企连接通道配置】页面,选择工商银行开放平台版,然后点击新增
(3) 进入前置机新增页面,对基础连接配置和网银登录配置参数进行配置
• 服务网关地址:正式环境不需要调整;测试环境需要根据银行提供的文档进行调整;
• APPID:由银行提供;
• 集团CIS号:客户编号,有银行提供;
• 银企互联证书名称:证书ID,由银行提供;
• 网关公钥:测试环境:API_GATEWAY.zip;生产环境需要自行在开放平台网站进行申请下载;
• 签名算法:支持CA和RSA/RSA2;默认为CA;
• CA私钥证书/CA公钥证书:由银行提供;私钥为.key格式;公钥为.cer格式;
• RSA应用私钥:待补充;
(4) 配置完成后,点击保存,然后点击测试连接;
注意:点击测试连接,代表银企到前置机安装的服务器端口通了;如果不通的话,请检查ip和端口的配置
注意事项:如果是国密证书,签名算法需要选择“CASM”,并且银行提供的国密证书可能需要用工具提取,具体可以参考帖子操作:工行开放平台国密配置
3.1配置银企账户
一般情况下,银企账户需要在资金云【账户管理】中维护并同步到银企云,更为具体步骤需要参考资金的指导文档,本文档只针对在银企云中的参数说明。
1) 进入【基础管理】-【银企账户】,新增或者修改银企账户
2) 账户参数说明如下:
默认可以根据资金云同步过来的信息展示,如不确定则非必填的参数都先不要填写:
3.3银企联通测试
银企账户配置完成之后,可以尝试测试余额及明细的查询;
在【查询与支付】-银行账户查询内,查询余额,如果余额能够成功查询,代表与银行前置机的通讯是成功的;
3.4银行参数配置
银行参数配置本身有默认参数,如果没有特殊情况可以不用配置。以下对常用的参数进行说明:
银行参数,根据实际用途分类为以下分类,可以根据实际使用时进行编辑调整;
(1) 基础参数:
• 银行前置机公用开关:支持相同集群下不同的数据中心的前置机共用一个;
(2) 安全防重参数:
• 银企支付通道开关:支持在业务调整或生产上线时不接受业务系统支付业务请求;避免前置机停机,导致支付业务堆积无法完成;
• 银行非支付通道开关:支持在业务调整或生产上线时不接受业务系统查询余额或明细业务请求;避免业务系统一直请求,前置机无法执行,任务堆积;
(3) 余额明细参数:
• 回单明细限制查询日志:主要用于新老系统切换时,不限制日期,导致业务系统里是交易明细及回单重复;如果不是切换系统的不需要管;
• 交易明细唯一主键组成规则:与银行约定协商的保障交易明细唯一性的规则;
(4) 付款业务参数:
• 付款摘要特殊字符池:付款单据内的摘要信息,如果包含配置的特殊字符,则可以直接置为失败;
(5) 代发业务参数:
• 代发业务参数展示,调整这里的参数不改变任何内容,只做展示
(6) 回单参数:对电子回单的完整度和任务执行情况的管理的配置
• 回单完整度检查开关:通过对比交易明细数量,检查回单是否下载完全,并一一对应;
• 回单任务失败自动重新下载开关:回单下载任务如果因为某些原因失败了,系统会自动执行重新下载;