【银企平台】银企平台对接招商银行云直连无前置机版（SM加密签名）

招商银行云直连(CMB_CMP)有前置机模式配置请参考：

------------------------------------------------------------------------------------

下面开始则是银企平台对接招商银行云直连无前置机版的相关配置指导

首先：招商银行云直连开通流程建议咨询银行技术，也可参考附件：招商银行云直联开发指南(2.4)-新直联。（实施人员主要关注1,2章节）

注意：

首先需要确认银行跟客户签的云直连模式是 【标准免前置机模式（SM签名）】还是 【SAAS模式（SM签名）】。

【标准免前置机模模式（SM签名）】：需要先连招行测试环境测试，给出银行需要的测试报告并审核通过后才能上生产环境。

【SAAS模式（SM签名）】： 可直接上生产环境，要多一个银企平台私钥证书kingdee.txt（最新补丁已自带）。

招行测试环境访问地址：http://cdctest.cmburl.cn/cdcserver/api/v2

2、银行业务配置-招商银行无前置机版-云直联模式选择 -根据客户与银行签约情况选择对应模式（招行当前新推出的都是SM加密签名）

3、获取几个秘钥文件

如果是 【标准免前置机模模式（SM签名）】：测试环境银行会直接提供这些秘钥文件,跟下图国密生成工具上的备注是对应的，生产环境的这些密钥也是由银行提供给客户（不是通过工具生成）。
如果是 【SAAS模式（SM签名）】：直接用附件国密生成工具选生产来生成密钥即可（如下图），另外还需要部署kingdee.txt（银企平台最新补丁已自带，无需替换）

3.1、银企平台（ebservice705\ebservice\configs\banks\CMB_CMP下）需要配置的3个（aes.txt,bank.txt,rsa.txt）

bank.txt：存放银行公钥

aes.txt：存放用户对称秘钥

rsa.txt：存放用户私钥

3.2、生产环境需要在网银端需上传2个（加密后的对称密钥，用户公钥），可参考下图，具体咨询银行技术。

4、完成以上配置即可去查询账户余额测试。

1、查询余额银行返回：DCPG028-报文格式非法，请确认你的请求报文是否满足json格式或你的加密密钥是否正确。

解决：请求报文格式无问题，银行解密数据失败，是由于客户公钥和加密后的aes对称密钥更新了要重新上传到网银端

2、查询余额银行返回报错：字符串类型字段bbknbr长度不合法

解决：招行账户地区码不对，查询参考：http://web20.kingdee.com/eb_cloud_cnaps/cmbcode

3、查询余额银行返回报错：您的IP未定义在白名单中[xxx.xxx.xxx.xxx]

解决：银企平台服务器出口ip未定义在银行服务器的白名单中，找银行技术咨询解决

0U}A(}4%_TQ$O29$JY1[9LP.webp

4、查询余额银行返回报错：*****无效签名

解决：

如果是标准免前置机模式生产环境：注意银企平台存放的几个密钥文件（aes.txt,bank.txt,rsa.txt）需要银行提供给客户，而不是用工具生成。

如果是SAAS模式（默认生产环境）：

1）、新客户：一般是平台私钥kingdee.txt不对，上述最新补丁自带的kingdee.txt是生产环境的，且正确。如果你是通过其他渠道获取的可能不正确。

2）、老客户：客户之前是SAAS模式用的老的RSA密钥且一直正常使用，现在招行切换了国密（SM）后报改错，所以需要更换银企平台的bank.txt和kingdee.txt这两个密钥文件，可提工单获取。

5、对私付款默认走代发接口，报错：银行返回：“有审批业务模式不可直接经办，请选择正确的无审批业务模式

与银行进行签名验签交互成功后，其他业务配置问题