附录C.常见问题汇总

目录

• 一、常见报错问题

• 1.1 配置类问题
• 1.2 权限与签名类问题
• 1.3 交易类问题
• 1.4 退款类问题
• 1.5 其他报错

• 二、交易问题排查
• 三、其他问题说明
• 四、快速索引表

一、常见报错问题

1.1 配置类问题

1.1.1 找不到客户产品配置的业务信息

原因：未开通对应产品，或商户使用了错误的交易代码。

解决方法：

• 检查是否开通了对应产品（如开通批量代付但调用了单笔代付接口）
• 如未开通产品，联系运营配置
• ⚠️ 配置完成后需等待缓存生效，不要立即发起交易

1.1.2 未开通的业务类型/业务类型与商户信息中设置的业务类型不一致

原因：上送的 BUSINESS_CODE 与配置不一致。

解决方法：

• 在「产品配置 → 业务参数」查看已配置的业务类型
• 确保上送的业务类型与配置一致
• ⚠️ 配置完成后需等待缓存生

1.1.3 未配置分账商户号，请检查

原因：分账交易的收款方未在商户号下做关联配置。

解决方法：

• 在「其他参数 → 分账配置」添加分账收款方
• ⚠️ 配置完成后需等待缓存生效

1.1.4 目前未开通此受理渠道

原因：生产环境相应产品下的受理渠道未配置。

解决方法：

• 在「产品配置 → 受理渠道」开通对应参数
• 接口对接方式：配置 XML系统对接 受理渠道，初始交易状态为【处理中】
• 手工报盘方式：配置 浏览器 受理渠道，初始交易状态为【等待商户审核】
• ⚠️ 配置完成后需等待缓存生效

1.1.5 接口业务类型未映射

原因：商户接口上送的业务类型未做映射。

解决方法：反馈给事业部，联系机构部完成映射

1.2 权限与签名类问题

1.2.1 权限不足

排查步骤：

1.2.2 签名不符

排查清单：

1. 证书配对：检查商户私钥与通联系统上传的公钥是否是一对
2. 证书环境：确认生产环境使用的是生产证书，而非测试证书
3. 签名算法：

• 算法：SHA1withRSA
• 编码：GBK
• 签名内容：整个报文串（除 <SIGNED_MSG> 标签外）

4. 地址一致性：确认接口地址与证书环境匹配
5. 生效时间：证书上传后需等待 5分钟 才生效

签名相关报错汇总

1.3 交易类问题

1.3.1 卡号所属银行与发卡行不一致

原因：上送的银行代码有误或未做映射。

排查步骤：

1. 在「银行 → 行号管理 → 银行卡BIN维护」查询卡BIN对应的银联机构代码
2. 检查该银联机构代码是否有映射对应的银行代码
3. 如无映射，联系运营添加映射

1.3.2 不允许进行对公交易

原因：风控拦截，对公风控未配置或配置后立即发起交易导致未生效。

排查步骤：

1. 检查「商户级风控：客户 → 风控参数管理 → 交易控制管理」是否配置允许对公
2. 检查「产品配置 → 对公对私配置」是否支持全部
3. 确认是否支持该银行的对公交易
4. 配置完成后等待缓存生效再重新发起交易

1.3.3 返回码 3066：不支持对公

原因：无路由渠道可走，对应产品的路由渠道不支持对公交易。

解决方法：

• 提交 OA 申请「交易渠道调整变更」修改路由组

1.3.4 商户收款对公户信息不存在

原因：银行结算账户的账户用途配置不正确。

解决方法：

• 检查账户用途是否为「收付款」
• 若仅为「收款」会报此错，需改为「收付款」

1.3.5 账号属性超长

原因：手工提交模板中的账户类型值填写错误。

解决方法：

• 检查账户类型值，如「0（私人）」是否误填为「00」

1.3.6 交易报错：付款方商户未注册，触发限额

原因：商户未报备成功或报备未生效。

排查步骤：

• 在「渠道管理 → 渠道商户号管理 → 渠道报备查询」查看报备情况
• 银联报备当天成功，第二天生效

1.3.7 当日通兑业务累计金额超过规定金额

原因：

• 超过通联设置的风控参数限额
• 或该卡当日扣款金额已超限

1.3.8 找不到商户授权信息

原因：商户号之间的内部转账授权未配置。

解决方法：联系运营配置商户号授权关系

1.3.9 付款类交易报 3008：余额不足

排查清单：

1. 检查商户余额是否充足（扣除手续费后）
2. 检查充值时间是否在代付交易发起之前
3. 检查账户是否被冻结（风险交易冻结、证件到期冻结）
4. 通联头寸不足（可重试）

1.3.10 结算交易报错：客户代码未注册

原因：259号文银联结算交易管控，需重新触发银联代付报备。

解决方法：重新报备后，一般 D1（次日）生效

1.3.11 无效卡号，卡号不存在

原因：部分银行内部户或特殊类型不支持走网联，仅支持人行大小额。

解决方法：联系运营申请调整路由

1.3.12 返回码 310002：该批次号不存在或处理中

原因：原确认 SRCREQSN 的 310001 短信申请触发失败或已发起确认

1.3.13 快捷签约报错 3999：请求的功能尚不支持

原因：签约的银行不支持该功能

1.3.14 银行卡或证件为异常交易名单不允许交易

原因：银行卡或证件号命中投诉黑名单。

解决方法：如有疑问联系金融事业部

1.4 退款类问题

1.4.1 退款接口报 3999：原交易产品不支持退款

原因：原交易产品未配置允许退款。

解决方法：在对应产品的「产品配置->退款参数配置」中开启允许退款

1.4.2 退款报 3999：退款账务处理失败

原因：

1.4.3 原交易状态不允许退货

原因：邮储银行二类卡日累积存入金额超限（1万）。

解决方法：第二天重试

1.5 其他报错

1.5.1 测试环境短信验证码

适用场景：

• 修改密码
• 上传公钥

1.5.2 签约报错：报文格式错误 (smsCode) [6100030]

原因：持卡人验证码填写错误

二、交易问题排查

2.1 渠道不支持：卡号未签约

问题：卡号已签约，但返回「渠道不支持，卡号未签约」。

排查思路：

1. 是否配置了符合的路由渠道（如签约协议类型是网联，需配置网联渠道）
2. 签约完成时间是否先于扣款提交时间
3. 扣款户名与签约户名是否一致（路由匹配时会校验）

案例 1：签约与扣款户名不一致

案例 2：签约协议类型与路由渠道不匹配

2.2 协议号未找到或失效

返回码：3043

情况分析：

额外检查：交易上送的姓名是否与签约姓名一致

2.3 汇入金产品打款后无交易记录

A. 检查网银打款收款人信息

B. 检查商户配置

• 是否开通汇入金产品
• 业务类型是否默认选择「代收其它 19900」

C. 查询 ACS 网银明细

联系业管查询是否收到汇入交易

D-E. 进一步处理

• ABC 检查无误后联系技术进一步排查
• 若网银有记录但配置错误，与业管协商退款

2.4 协议支付扣款：先失败后成功

问题表现：某持卡人在商户的快捷支付，某天扣款返回协议无效，之后某天又成功（持卡人未做解约重签）。

原因分析：

协议关系说明：

• 快捷协议为三方协议：持卡人 + 支付机构 + 银行
• 通联协议号规则：商户号 + 卡号（同一持卡人在不同商户有不同协议号）
• 银行端解约后，商户端协议状态可能仍为有效

处理建议：

• 将卡号发给运营，通过「用户协议管理 → 银行快捷协议查询」查看银行协议更新时间

三、其他问题说明

3.1 调试返回信息：cannot be cast to

原因：请求报文格式标签错误。

解决方法：查看接口文档，检查请求报文格式

3.2 对账文件下载得到空文件

排查：

• 检查请求参数格式是否正确
• 检查签名字段值是否正确

3.3 PEM 文件生成方法

# 生成私钥
openssl genrsa -out rsa_private_key.pem 1024

# 生成公钥
openssl rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem

# 从 p12 转换私钥（密码：111111）
openssl pkcs12 -nocerts -nodes -in 20060400000044502.p12 -out 20060400000044502.pem

# 从 cer 转换公钥
openssl x509 -inform DER -in allinpay-pds.cer -out allinpay-pds.pem

3.4 接口并发限制

3.5 HTTP 通讯异常处理

3.6 返回码 4000：已发送银行

说明：

• 批量付款走跨行时无法直接获取结果，状态为「已发送银行」
• 可将 4000 当做成功处理（与 0000 同等对待）
• 若发生退票（2-5天），运营手工发起退票，商户根据退票通知更新状态

退票通知配置：

• 可配置退票通知地址
• 退票时系统发送通知，包含原付款交易流水号

3.7 对外出口 IP

测试环境

101.95.191.142
116.228.64.49
140.207.168.194

生产环境

140.206.57.166
117.184.121.6
222.72.143.68
222.72.143.69
140.206.57.164
101.95.129.116
117.184.121.4
101.95.191.142
210.22.100.126
220.248.8.94
117.144.212.130（新增）
210.22.139.90（新增）

3.8 HTTPS 403 报错

原因：除下载接口外，其他 403 错误通常是触发了安全协议拦截。

处理：提供商户出口地址、请求接口、请求时间，联系数据中心处理。

3.9 签约通知返回全卡号和手机号配置

3.10 version 版本号与返回报文格式

四、快速索引表

按问题索引