常见问题Q&A

Q：在进行系统对接时，银联能否提供一些测试数据以供检测系统对接是否成功？

A：银联不会提供相应的测试数据。银行可以使用数据测试时使用的，特别是我们可以准确给出反馈结果的测试样本，作为检测系统对接是否成功的样例。如果银行之前没有进行过数据测试，则可以询问己方业务部门提供相应测试数据。

Q：按照《接入指南》和《中国银联天擎产品API服务接口规范》进行发送调用请求没有响应，有哪些可能的问题？

A：可能的问题如下：

    （1）请求报文key中的签名秘钥（signature）有误。签名秘钥是用户在开放平台个人中心里自行设置的身份确认用凭证；

    （2）请求报文key和body顺序有误，或者body组成部分顺序有误；

    （3）使用Postman发送请求时，有时会出现无反应的情况。此时需要删掉body中json语句里的所有换行和空格，或者直接通过Java代码发送HTTP请求。

Q：入参加密的方式是什么？

A：入参使用RSA加密，相应公钥通过：个人中心-个人信息-API认证账号-API认证账号详情 进行生成和查看。注意每次重新生成RSA公钥的时候，请务必重置己方系统里的加密程序，以免出现解密失败的情况。

(在离线库服务上线之后，入参需要先经过SM3加密再进行RSA加密进行传输）

Q：正式生产环境的对接信息和测试环境一样吗？需要加IP白名单吗？

A：进行系统对接测试的环境即为正式服务环境，因此正式生产中得到的对接信息是一样的，也同样需要添加到IP白名单里。

Q：所有入参都是必填字段吗？可以只使用企业主身份证、不输入电话号进行查询吗？

A：原则上所有在《中国银联天擎产品API服务接口规范》中明确为必填的入参都是必填字段，否则系统会产生输入参数解析错误。如果银行希望仅通过部分信息查询相应信息，可以将不想输入的字段留空（但是不能没有这个字段），就可以得到相应的返回结果。但是同时，入参越少，对企业和企业主的定位越模糊，可能会导致指数与子指数不够精确，因此建议银行在条件允许的情况下填写所有入参。

Q：respCd返回“9991：银联技术开放平台系统内部错误：产品服务调用失败”，如何解决？

A：对于返回码为999X的报错，都是技术开放平台内部的错误导致的，一般为网络波动等硬件性问题。如果碰到此类错误，首先联系业务对接人，之后可以致电021-20633521咨询技术开放平台管理人员张昊，或通过邮箱zhanghao1@unionpay.com进行联系。

Q：系统返回 “isdisconnect”：“1” “respMsg”:"处理成功" "respCd":"0000"，但是却没有其他任何参数返回，是什么原因？

A：这是因为本次查询的企业/企业主在银联系统内没有记录，查询不到相应的信息，因此返回空值。

Q：若机构在银联没有机构号，如何解决？

A：可注册个人账号，并与“天擎”产品负责人约定一个未被占用的8位数字作为“虚拟机构号”，在后续调用接口时即以该“虚拟机构号”入参即可。