2. 公共接口规范

1.1 公共请求参数

1.2 公共响应参数

1.3 接口代码

1.4 回调通知说明

1.4.1 异步通知公共参数

1.4.2 异步通知机制

1、订单类结果通知规则

（1）云商通后台通知商户地址后，以下两种场景会判定为结果通知成功，不再进行重复推送
后台通知收到的 http通讯响应码为:200
后台通知收到的 http 响应信息为:success(注:不是"success")

接收通知及相应的代码示例：[附件]AsyncMessageHandDemo.java.zip

（2）对于交易时效非常高的场景，建议商户建立主动查询机制【查询订单状态】。

（3）订单后台通知条件：

2、会员类结果通知规则

（1）云商通后台通知商户地址后，以下两种场景会判定为结果通知成功，不再进行重复推送
后台通知收到的 http通讯响应码为:200
后台通知收到的 http 响应信息为:success(注:不是"success")

（2）会员通知条件：

3、通知重发规则

（1）同样的通知可能会多次发送给接收方系统。接收方系统必须能够正确处理重复的通知。

（2）后台通知交互时，如果接收方反馈给通知方的应答不符合规范或超时（链接保持5s），通知方服务器会不断重发通知，直到收到接收方正确的反馈或超过6小时。一般情况下，6小时以内完成共8次通知（通知的间隔频率一般是：0s/5s/15s/1m/10m/30m/1h/6h）,但通知方不保证通知最终一定能成功。

（3）在订单状态不明或者没有收到支付结果通知的情况下，建议接收方主动调用【交易结果查询】确认订单状态。

1.5 验签机制/敏感信息加密说明

1.5.1 验签机制

1. 筛选并排序

获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign、signType字段，剔除值为空的参数，并按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

1. 拼接

将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。

1. 将签名参数（sign）使用 base64 解码为字节码串。
2. 调用验签函数：使用各自语言对应的Sm2签名验证函数，传入待验签字段、服务商或者客户公钥、签名内容(经过base64解码)进行验签，根据返回结果判定是否验签通过。

1.5.2 敏感信息加解密

客户端与服务端之间传递敏感信息，请使用SM4 对称加密算法进行加密后传输。

SM4加密：将传入的密钥（secretKey）的字节数组作为因子通过SHA1PRNG生产一个64位的随机源，构造出原始密钥，通过ECB模式对明文数据进行加密，加密后的字节码转为16进制大写输出。

1.5.3 签名验签API服务

独立部署一个api服务，加解密调用此服务，方法见附件：

【签名验签API_V2】https://kdocs.cn/l/cnO6tubee5wq

1.6 中信银行测试数据说明

1.6.1 二代银行存管测试应用参数：

appid=21783065698184253441;

secretKey = "878427523d3525e070298d44481b8d2e";

privateKeyStr="MIGTAgEAMBMGByqGSM49AgEGCCqBHM9VAYItBHkwdwIBAQQgTI6DEvfB/Zk/L61JUvyOljK3zjaBRd5T076hlYsDipGgCgYIKoEcz1UBgi2hRANCAASebeTJ7OGucvLghYuglH+DIMVw67i72NWKJN5Ye1QcbsrijwPQDswN3ymZFvoCkM+S5mSZUIq+o0MF66tyvySr";

allinpayPublicKeyStr="MFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAEu9LNkJlyLtjJxtQWIGlcZ/hyHt5eZ7LEH1nfOiK1H9HsE1cMPu5KK5jZVTtAyc7lPMXixUMirf6A3tMbuMbgqg==";

1.6.2 接口上传参数说明

【企业会员实名开户】接口中需要上送真实的企业工商信息，可上“天眼查”搜索真实有效的企业信息调用接口测试

用户绑卡时，对公账户需要在中信处登记，命中中信的白名单才可绑卡，需要测试绑卡需联系中信测试人员添加白名单