目录1.背景.................................................................................................................................................................22.资料申请.........................................................................................................................................................23.银企平台配置.................................................................................................................................................33.1.配置前置机.........................................................................................................................................33.2.放置证书文件：.................................................................................................................................53.3.配置银企账户.....................................................................................................................................53.4.银企联通测试.....................................................................................................................................64.常见问题：.....................................................................................................................................................64.1.前置机测试余额时报错如下图：.....................................................................................................61/91.背景配置之前，先要和银行申请环境和资料，该版本为开放平台版，无需安装前置机，工商银行开放平台版（会提供API申请表格，填写提交银行来进行接口开通和获取测试资料）。银行提供资料请参考：（1）客户相关数据；（密钥证书、APPID、客户编号、证书id）（2）测试使用账套数据；请仔细阅读文档。清晰步骤了再进行配置。2.资料申请和银行沟通申请版本时需要区分开放平台版和推广版（NC）；（1）API版本申请，需要填写申请表，并且需要在工行开放平台进行注册和配置；（后续补充申请材料样例）工行开放平台地址：https://open.icbc.com.cn/icbc/apip/index.html；（2）NC版需要安装前置机，并且需要申请实体U盾；NC前置机如图：2/93.银企平台配置3.1.配置前置机（1）进入【前置机配置】页面，选择工商银行开放平台版，然后点击新增（2）进入前置机新增页面，对参数进行配置平台网关地址：正式环境不需要调整；测试环境需要根据银行提供的文档进行调整；应用ID，即APPID：由银行提供；网关公钥文件名：由银行提供（需要从SDK包中获取）；将文件名填写在输入框内，格式参考：API_GATWAY.pub;应用私钥文件名：当下方的签名算法是RSA/RSA2时，必填；CA证书密码：由银行提供；当签名算法是CA时必填；3/9CA私钥证书/CA公钥证书：由银行提供；私钥为.key格式；公钥为.cer格式；当签名算法是CA时必填；签名算法：支持CA和RSA/RSA2；集团CIS号：客户编号，由银行提供；银企互联证书名称：证书ID，由银行提供；（3）配置完成后，点击保存，然后点击测试连接；3.2.放置证书文件：将银行提供的证书信息，需要放到银企平台安装文件夹的如下文件夹内：（1）找到银企平台安装地址：找到这个文件夹ebservice\configs\banks（2）新增一个工行开放银行的文件夹，命名为ICBC_CLOUD;（3）然后将银行提供的证书信息，放在这个文件夹内；4/93.3.配置银企账户一般情况下，银企账户需要从业务系统同步过来，但是测试时可以先在银企手动添加；1）进入【业务管理】-【银行账户】，新增或者修改银企账户2）账户参数说明如下：默认可以根据同步过来的信息展示，如不确定则非必填的参数都先不要填写：5/93.4.银企联通测试银企账户配置完成之后，可以尝试测试余额的查询；4.常见问题4.1.前置机测试余额时报错如下图：报错详情：解决方案：检查银行公钥：将如图的内容全部删掉；重新保存；然后放在证书文件夹内；（注意文件夹内的证书要保证唯一）6/94.2.其它常见问题https://vip.kingdee.com/article/455425055552438784?productLineId=8&isKnowledge=24.3.网关公钥有问题查询余额报错如下：查看银企日志发现：7/9看日志，Causedby:com.icbc.api.IcbcApiException:icbcsignverifynotpassed.atcom.icbc.api.DefaultIcbcClient.parseJsonWithIcbcSign(DefaultIcbcClient.java:298)atcom.icbc.api.DefaultIcbcClient.parse(DefaultIcbcClient.java:262)atcom.icbc.api.DefaultIcbcClient.execute(DefaultIcbcClient.java:192)atcom.icbc.api.DefaultIcbcClient.execute(DefaultIcbcClient.java:155)联系银行，重新发了API_GATEWAY.pub文件，注意备份一下文件，且文件内容只保留红色矩形框内的部分：8/99/9
