FAQ交易问题总体说明
以下为收付通交易返回失败问题，涉及的配置问题分类图测试一下。
收付通失败交易分为两大类：1、系统拦截导致的失败，2、渠道原因导致的失败。
FAQ1.并发限制
FAQ1.1
问题描述：
并发超限拦截:并发过高拒绝交易，请稍后再试（系统页面查询不到对应的交易）
响应报文样例：
解决方法：
系统默认TPS 20,可根据商户交易特征，向数据中心申请调高TPS配置。
FAQ1.2
问题描述：
查询速度过快，请稍后再试：调用200004接口，报查询速度过快，请稍后再试。
解决方法：
同一笔流水号的查询请求间隔应在5秒后才能再次发起。
FAQ2.接口参数检查
FAQ2.1
问题描述：
报文字段错误拦：报文响应1000，系统繁忙，请稍后再试（系统页面查询不到对应的交易）
响应报文样例：
解决方法：
字段标签没按报文规范约定上送，引导商户对比接口报文规范，仔细检查报文字段。
FAQ2.2
问题描述：
验签错误拦截：签名不符
响应报文样例：
解决方法：
（1）排查商户生成的私钥和在通联系统上传的公钥是否是一对，如不是可在对应角色更新公钥。
（2）排查是否在生产环境中使用了测试环境的私钥证书，这种情况，只需要替换成生产的私钥证书即可；
（3）测试环境联调的时候，证书正确，用户名正确，但是还是前面失败，则考虑是签名的方法有问题，签名算法：SHA1withRSA，编码格式GBK，签名的内容是整个报文串除了 <SIGNED_MSG> </SIGNED_MSG>；请商户技术自行检查，或参考该文档的数字签名域；
（4）检查接口地址与参数是否一致，比如是否用生产的商户的私钥证书加签发到了测试环境；
（5）证书上传到后，要5分钟之后才生效。
FAQ2.3
问题描述：
报文字段超长：报文响应3999，入库异常，请检查字段是否超长（系统页面查询不到对应的交易。）
响应报文样例：
解决方法：
字段长度没按报文规范约定上送，引导商户参照接口报文字段长度，仔细检查每个字段的长度，特别是户名的长度。
FAQ2.4
问题描述：
交易流水号重复拦截：报文响应1000，交易流水重复（系统页面查询不到对应的交易。)
响应报文样例：
解决方法：
商户方原因导致流水号重复，引导商户检查相关程序是否有自动重试功能，或者商户本身程序逻辑上有缺陷。
FAQ2.5
问题描述：签名报错 data isn't an object ID
解决方法：DEMO中把
AIPGSignature signature = new AIPGSignature(AIPGSignature.SHA1_RSA, false);
把false改为true AIPGSignature signature = new AIPGSignature(AIPGSignature.SHA1_RSA, ture);
FAQ2.6
问题描述
接口报错提示ForbiddenClassException
解决方法：
类com.allinpay.demo.xml.XmlParser 按以下截图调整配置，这个是由于Xstream版本问题导致。
FAQ3.产品配置检查
FAQ3.1
问题描述：
无接口权限拦截:1000，权限不足
- 响应报文样例：
解决方法：
- 检查上送的用户名是否与商户签名的私钥证书名称一致，一般用户名是商户号+04。
- 找总部运营确认下是否开通了04用户的系统对接角色权限，比如交易类要开通系统对接（交易/查询/账务）权限，验证和签约类要开通系统对接（验证）权限；如对应的角色缺少权限则联系总部运营添加。
- 检查上送的接口地址是否正确，比如是否用生产的参数发到了测试的地址。
FAQ3.2
问题描述：
商户状态不正常拦截:3999，客户状态不在可用范围内
响应报文样例：
解决方法：
查看商户是否被冻结了。
FAQ3.3
问题描述：
交易类型未开通拦截:未开通此产品或产品状态不在可用范围内
响应报文样例：
解决方法：
检查是否有开通对应的产品或商户是否用错交易代码，比如开通了批量代付产品而商户调用了单笔代付，如未开通产品联系运营配置。
FAQ3.4
问题描述：
业务类型未开通拦截:开通的业务类型/业务类型与商户信息中设置的业务类型不一致
解决方法：
检查上送的业务类型（BUSINESS_CODE）是否与配置的一致。
在产品配置-》业务参数进行查看。
FAQ3.5
问题描述：
受理渠道未开通拦截:目前未开通此受理渠道
解决方法：
- 生产的相应产品下的受理渠道没有配置，联系运营配置：接口对接方式需配置XML系统对接受理渠道；手工报盘方式需配置浏览器受理渠道。
FAQ3.6
问题描述：
退款参数未配置拦截:原交易产品不支持退款
响应报文样例：
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>REFUND</TRX_CODE>
<VERSION>09</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000014012-0001718936004032</REQ_SN>
<RET_CODE>3999</RET_CODE>
<ERR_MSG>原交易产品不支持退款</ERR_MSG>
<SIGNED_MSG>7b3c1664c4c16a871308c3755be874334cda6e689e517f60a0bf701f499cf99cbd344209ff9ba098d771a53eb52b3170fe481574e4f359d2836205c672d22ff3952ba7b234fdeb76c6cdd1dc9e647262c9f27486987db77a8bc75a7a770a16405ed6ff4fa5182b76405caafc9ce49744e84f22ee17ab19ece403713ecc65bee3257e441cde9e1115eeb674ba323409b8ba2a250e118e18aac7962e122dd3757b4af7adecc11d3aae69e82ff7ec2ddf6d2bb28a5beee34eaf7c01eeeecd335e9d427007d66314a673f704fa436b1a8aea2516ecbfd995211df9148ac9d63c83edc3e6a2473bf5fe7af8c8079e806fe05130dfae1c70f6e4010ad5b56ab4b64300</SIGNED_MSG>
</INFO>
<TRANSRET>
<RET_CODE>3999</RET_CODE>
<ERR_MSG>原交易产品不支持退款</ERR_MSG>
</TRANSRET>
</AIPG>解决方法：
查到对应的产品，比如快捷协议支付，查看的产品是否配置允许退款
FAQ3.7
问题描述：
退款收款户余额不足拦截:3999 退款账务处理失败
响应报文样例：
解决方法：
查看如下可能的原因：
1 收款户余额不足，不够资金退款
2 如余额充足，则可能是收款户被冻结，可联系运营确认
FAQ3.8
问题描述：
一键绑卡签约返回全卡号和手机号的配置,不跳转通联页面直接到银行网关的，一键绑卡是否返回通联H5页面选择否
解决方法：
FAQ3.9
问题描述：
电子回单下载返回403
解决方法：
检查链接是否已经点击过2次或者链接超时效。
有效时长为1分钟。
FAQ3.10
问题描述：
分账信息未配置拦截:未配置分账商户号，请检查
解决方法：
分账交易的分账收款方需在交易发起的商户号下做关联配置，其他参数-》分账配置，分账类型也要核对清楚，按金额还是比例
FAQ3.11
问题描述：
转账授权未配置拦截:找不到商户**to**授权信息
响应报文样例：
解决方法：
联系总部运营，配置商户号之间的内部转账授权配置
FAQ4.商户持卡人协议检查
FAQ4.1
问题描述：
收款类交易未签约拦截:报文响应3403，协议号未找到或失效
响应报文样例：
解决方法：
返回3043 协议号未找到或失效分两种情况：
1、一种是该卡的协议在发起交易前在我司系统已失效，该情况不会入库，页面查询不到记录；
先在用户协议管理-》统一协议查询页面查询该卡号是否有对应的通联协议号，且协议状态是否正常。
2、一种该卡的银行协议在发起交易前在我司系统仍是正常状态，但发到渠道后返回失效，该情况有入库，页面可以查询到交易记录，该原因可能是本身持卡人自己解约了，银行协议已失效，但银行可能没有通知到通联，因此通联端的协议状态仍是正常，在发起交易后根据3043返回码自动触发置协议失效，持卡人需要重新发到渠道签约才能扣款。
3、检查交易上送的姓名是否跟签约的姓名一致
FAQ5.风控检查
FAQ5.1
问题描述：
风控协议拦截:合同（协议）号在协议库里不存在
响应报文样例：
解决方法：
检查商户交易控制，是不是配置错。
FAQ5.2
问题描述：
对公交易拦截:不允许进行对公交易
响应报文样例：
解决方法：
报错原因是风控拦截，说明在交易发起时对公的风控没配置或有修改过风控未生效则马上发起交易。
该情况请联系运营人员检查商户级风控：客户-》风控参数管理-》交易控制管理是否配置允许对公，以及检查产品配置里的对公对私配置是否支持全部，如确认
都无问题再重新发起交易。
FAQ6.渠道匹配
FAQ6.1
问题描述：
匹配不到渠道:渠道不支持，该卡号交易无法进行
响应报文样例：
解决方法：
1 看是否签约。
2 看是否超过行业限额
3 配置的银行支不支持
4 用户名是否正确
FAQ6.2
问题描述：
不支持对公:代付报错 不支持对公
响应报文样例
解决方法：
无路由渠道可走，对应产品配置的路由渠道不支持该对公交易，如需修改路由组，提oa申请-交易渠道调整变更类型。
FAQ7.渠道原因失败
FAQ7.1
问题描述：
渠道异常重试: 3999 交易失败，请稍后重试[TL0001]、交易失败，请稍后重试[TL0004] 、交易处理失败，请更换流水号后重新发起[TL0002]
响应报文样例：
解决方法：
渠道受理失败，更换流水号 ，交易重提。