RiskGo安全合作平台文档
风险推送失败常见错误码及解决方案
更新时间：2018/04/17
访问次数：12122
|
错误码
|
描述
|
解决方案
|
|
UGW_ILLEGAL_SIGN
|
商户返回结果验证签名失败
|
常见排查方案：
1，需确认验签方式（RSA/RSA2）与申请服务权限中填写的保持一致。如不一致请与申请服务权限时填写内容保持一致。如一致请看第二步。
2，需检查验签用的支付宝公钥是否正确。如为RSA2签名，请用已配置安全服务权限的支付宝账号登录开放平台，进入此账号下有配置过RSA2秘钥的应用中，点击查看支付宝公钥重新获取下支付宝公钥并配置到代码中，重试验签。如还是不通过请看下一步。
3，检查接受到的通知是否有乱码。接受到的通知有中文，安全服务推送是以GBK编码格式POST推送，如商户框架层等为UTF-8编码，需要对此通知做转码，具体转码方案因各商户实际情况而定，由您团队开发人员给出方案。如还是不通过请看下一步。
4，在确保以上内容全部正确的情况下，请断点到验签算法代码中，打印下最终代签名字符串、sign并与获取到的原始值进行对比，看是否有特殊字符如/ -等被转义。如要查看验签拼接规则进入这个文档连接查看七常见FAQ第17条：
https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.PQduPH&treeId=482&articleId=107731&docType=1#s7
|
|
UGW_ILLEGAL_SIGN_TYPE
|
签名类型不正确_
|
需确认验签方式（RSA/RSA2）与申请服务权限中填写的保持一致。如不一致请与申请服务权限时填写内容保持一致。
|
|
UGW_SERVICE_SECURITY_NOT_EXIST
|
调用接口密钥信息不存在
|
1，首先确认签名方式是否是RSA。如为RSA，请到（）连接处点击mapi秘钥配置，上传RSA秘钥，上传后点击查看支付宝公钥，复制支付宝公钥到项目中用于验签。 2，RSA2签名的话，请用已配置安全服务权限的支付宝账号登录开放平台，进入此账号下任意一应用中，配置RSA2秘钥，RSA2秘钥生成可查看服务事情文档或到开放平台搜索。上传RSA2公钥后，点击查看支付宝公钥重新获取下支付宝公钥并配置到代码中用于验签。
3，如果都确认了还是报这个错误，请联系支付宝技术支持（）。
|
|
UGW_PARTNER_SECURITY_NOT_EXIST
|
合作伙伴安全配置信息不存在
|
1，首先确认签名方式是否是RSA。如为RSA，请到（）连接处点击mapi秘钥配置，上传RSA秘钥，上传后点击查看支付宝公钥，复制支付宝公钥到项目中用于验签。 2，RSA2签名的话，请用已配置安全服务权限的支付宝账号登录开放平台，进入此账号下任意一应用中，配置RSA2秘钥，RSA2秘钥生成可查看服务事情文档或到开放平台搜索。上传RSA2公钥后，点击查看支付宝公钥重新获取下支付宝公钥并配置到代码中用于验签。
|
|
UGW_SERVICE_NOT_EXIST
|
调用接口service不存在
|
您填写的“推送接收地址”可能无法正常访问，请勿使用静态页面、有302跳转逻辑的页面作为接收地址，并确保外网能够访问。
如果是在riskgo平台线上测试出现这个问题，就是您申请服务时填写的推送地址问题了，如需要修改此地址，请邮件至支付宝风控人员。
|
|
UGW_SERVICE_MULTI_MATCH
|
不能定位到唯一的接口配置
|
安全服务权限未配置完成，请在服务申请工单状态为“待联调”后再开始联调或在沙箱联调。
2，如已经确认当前工单状态是“待联调”，还报这个错误请联系支付宝技术支持（）。
|
|
UGW_ASSIGN_URI_IS_NOT_CORRECT
|
接口分发uri值不正确
|
一般为申请服务时勾选的通知方式如http/https，与填写的商户推送接收地址通知方式不匹配；如勾选的推送方式是http，实际推送地址写的是https://开头。
可以联系支付宝技术支持解决；
|
|
UGW_ILLEGAL_URI_OR_PROTOCOL
|
接口分发类型或uri值为空
|
如出现这个问题请联系支付宝技术支持（）；
|
|
UGW_TARGET_SYSTEM_ERROR
|
调用外部商户异常
|
请检查推送网关外网是否可以正常访问，如防火墙拦截、地址外部不可访问、地址有重定向等。如网关地址需要添加ip访问白名单才能访问，请联系小二获取支付宝网关推送ip段（）。
|
|
UGW_ILLEGAL_XML
|
解析XML错误
|
请按规范返回正确XML响应报文（截图）
|
|
UGW_UNKNOWN_HOST_ERROR
|
无法解析请求url
|
推送地址域名无法解析，请排查推送地址。
|
|
UGW_IO_EXCEPTION
|
请求io异常
|
首先确认自己服务器是否支持SNI。证书在线校验地址：
如果本工具验证通过，但线上依然存在问题,执行以下命令行校验:
1、DNS解析校验： dig ${host} +short 或者 nslookup 回车输入域名再回车查看。
2、连接有效校验： time curl -vk https://${host}
3、SSL证书校验： openssl s_client -connect ${host}:${port} 或参考 SSL验证
4，确认以上都没有问题，还报此错误，请联系技术支持（）。
|
|
UGW_SYSTEM_ERROR
|
支付宝系统调用错误
|
请联系支付宝技术支持（）
|
|
UGW_PACKETS_MERGE_ERROR
|
报文组装错误
|
请按规范返回正确XML响应报文：
|
|
UGW_PACKETS_PARSE_ERROR
|
报文解析错误
|
同请按规范返回正确XML响应报文：
|
