1. 整体介绍
首先星展银行是外资银行,与大部分中资银行不同,它是没有前置机的。
是通过API报文接口方式:需要服务器开通网络策略能访问到星展银行的API接口域名。
测试域名:testcld-enterprise-api.dbs.com;
正式域名:enterprise-api.dbs.com;
使用API格式需要https证书,星展银行一般会提供2个crt格式的证书文件,测试前需要在银企云所在服务器上,先安装证书到受信任的根证书颁发机构。
最后星展银行配置较多,开始搭建星展银行前,需要至少认真阅读该文档两遍,按步骤进行配置。
1.1. 代理程序下载途径
金蝶前置机代理程序下载地址(代理程序在查询付款状态时,如果银行是文件推送的形式来获取,则需要安装代理程序)(如果查询付款状态是通过API接口请求,则不需要安装代理程序,请根据实际和银行的沟通情况确定)
https://vip.kingdee.com/article/95932679937684992
1.2. PGP密钥生成
和银行交互,需要通过密钥加密,下面介绍是和银行交换密钥的生成工具及内容。请参照步骤执行:
测试环境和生产环境都需要使用PGP密钥,用同一套或者不同一套都可以,和银行沟通好即可
1.2.1. 下载安装生成软件
下载地址:https://pan.baidu.com/s/10UCweRVm3NSmwei1eXQKDQ (提取码:9olp)
安装时,记得勾选安装kleopatra
1.2.2. 生成密钥
打开kleopatra,点击File-New Certificate
选择第一个,openPGP密钥
下一步,填写名称、邮箱和备注,作用是生成密钥之后,做个记录标志一下
点击Advanced Settings,密钥类型选择RSA,长度选择4096。
过期日期Valid until选择25个月后的今天,例如今天是2021年4月23日,则选择2023年5月23日(星展银行规定)
最后点击OK。
点击Next,再点击Create Key
下一步,为这个密钥设置一个密码,设置后请妥善记住。密码尽量设置数字字母组合,例如kingdee2020。
输入2次密码后,等待密钥生成,生成成功如下图。
点击 Make a Backup Of Your KeyPair,勾选ASCII armor,文件可以命名为private.asc,存放好该文件,该文件为私钥文件
点击Finish,可以看到列表已经显示该密钥。选择该密钥,右键Export Certificates,文件可以命名为public.asc,存放好该文件,该文件为公钥文件。
保存后,选择该密钥,右键Certify Certificate,勾上2个勾后,点击Next
选择刚刚生成的密钥,点击Certify,完成
1.2.3. 发送邮件
把生成的公钥文件邮件发送给星展银行
2. 安装部署银企云
银企云基于苍穹平台开发,通过在MC系统部署银企云补丁进行环境更新。
2.1. 安装银企云环境
参考苍穹银企云补丁安装与部署进行补丁安装部署
2.2. 配置【查询与支付】参数
2.2.1. 配置银企连接通道配置
(1) 登录金蝶云星瀚,进入银企云的应用【查询与支付】
(2) 进入【银行启用管理】,启用“星展银行直联版”;外资银行有根据业务国家区分版本,请根据实际请求来启用不同版本!(注意)
(3) 进行【银企连接通道配置】,新增或修改“星展银行直联版”,参数配置说明如下:
基础连接配置:
(1) 基础连接配置
(1) 星展银行API接口的IP或域名:测试域名:testcld-enterprise-api.dbs.com;正式域名:enterprise-api.dbs.com;(可以和银行确认是否有调整)
(2) 星展银行API接口的端口:默认为443;
(3) 同步付款状态接口方式:根据和银行签约的方式选择,支持主动请求或银行推送文件获取;(如果是银行推送文件获取,需要安装代理程序);
(2) 金蝶前置代理配置(如果同步付款状态使用主动请求则不需要安装代理程序)
(1) 金蝶代理服务器所在IP:安装代理程序的服务器的ip地址;
(2) 金蝶代理服务器端口:代理程序星展银行开放的端口;
(3) 网银登录配置
(1) swfit bic code:由银行来提供;
(2) 各类API请求接口的地址,可直接使用默认值;
(4) 证书密钥配置
(1) 星展银行PGP公钥:由银行提供;
(2) 客户PGP私钥:通过PGP密钥工具生成的私钥,需要上传;(请参考1.2模块PGP密钥的生成)
(3) 客户PGP私钥密码:生成私钥时的密码;
基础配置内的其他参数,如果没有特殊要求,可以不做调整,使用默认值即可。
2.2.2. 配置银企账户
一般情况下,银企账户需要在资金云【账户管理】中维护并同步到银企云,具体步骤需要参考资金的指导文档,本文档只针对在银企云中的参数说明。
(1) 进入【基础管理】-【银企账户管理】,新增或者修改银企账户
(2) 账户参数说明如下:
(1) company ID:由银行提供;
(2) Key-id:由银行提供;
2.2.3. 银行参数配置
银行参数配置本身有默认参数,如果没有特殊情况可以不用配置。以下对常用的参数进行说明:
可根据实际需要配置,如无特殊情况可以不用配置