目录
本文档描述通联收付通接口返回码的分类、处理逻辑及具体含义。
目录
一、处理逻辑说明
基本处理原则
状态分类
|
分类 |
说明 |
处理方式 |
|
✅ 成功 |
交易处理完成 |
更新状态为成功 |
|
❌ 失败 |
交易处理失败 |
更新状态为失败 |
|
⏳ 处理中 |
交易正在处理 |
发起交易查询，更新状态 |
|
🔁 中间状态 |
需进一步确认 |
继续发起交易查询 |
二、返回码分类处理
B1 快捷协议支付与直接支付类
|
报文头返回码 |
明细返回码 |
处理方式 |
分类 |
|
0000 |
0000 |
批次已经处理完成 |
✅ 成功 |
|
0000 |
除 0000、2000、2007、2008 外；特殊：3043（未与银行签约） |
批次已经处理完成 |
❌ 失败 |
|
除 0000、2000、2007、2008、1108、1000 外 |
不需要对比 |
批次已经处理完成 |
❌ 失败 |
|
0000 |
2000、2007、2008 |
发起交易查询，更新交易状态 |
⏳ 处理中 |
|
2000、2007、2008、1108、1000 |
不需要对比 |
继续发起交易查询 |
⏳ 处理中 |
B2 批量交易类（批量代收付与批量协议支付）
|
报文头返回码 |
明细返回码 |
处理方式 |
分类 |
|
0000（系统接收成功，非最终状态） |
0000 |
接收成功，发起交易查询 |
🔁 中间状态 |
|
2000、2001、2003、2005、2007、2008 |
不需要对比 |
发起交易查询 |
🔁 中间状态 |
|
1108、1000 |
不需要对比 |
批次号重复，发起查询查看是否已受理 |
🔁 中间状态 |
|
1101~1107、1xxx、1999、1099、2002、2004、2006 |
不需要对比 |
失败 |
❌ 失败 |
B3 单笔实时代收付类
|
报文头返回码 |
明细返回码 |
处理方式 |
分类 |
|
0000、4000（已发送银行，仅跨行代付） |
0000、4000 |
交易处理成功 |
✅ 成功 |
|
除 0000、4000、2000、2001、2003、2005、2007、2008 外 |
除上述返回码外 |
失败（报文头与明细一致） |
❌ 失败 |
|
2000、2001、2003、2005、2007、2008 |
不需要对比 |
处理中，发起交易查询 |
⏳ 处理中 |
|
1108、1000 |
不需要对比 |
发起交易查询，更新交易状态 |
🔁 中间状态 |
B5 交易结果查询类
|
报文头返回码 |
明细返回码 |
处理方式 |
分类 |
|
0000 |
0000、4000（成功）；其他返回码（失败） |
批次已经处理完成 |
✅ 成功/❌ 失败 |
|
0000 |
无明细返回码 |
继续发起交易查询 |
🔁 中间状态 |
|
1000、1001、1002（无此交易） |
不需要对比 |
继续发起交易查询（1002需在发起交易10分钟后查询，30分钟仍无此交易则停止） |
🔁 中间状态 |
|
2002、2004、2006 |
不需要对比 |
失败 |
❌ 失败 |
|
2000、2001、2003、2005、2007、2008 |
有明细：0000/4000=成功，其他=失败；无明细：继续查询 |
继续发起交易查询 |
🔁 中间状态 |
B8 联贷通类
|
报文头返回码 |
明细返回码 |
处理方式 |
分类 |
|
0000 |
0000、4000 |
批次已经处理完成 |
✅ 成功 |
|
0000 |
除 0000、4000、2000、2007、2008 外 |
批次已经处理完成 |
❌ 失败 |
|
除 0000、2000、2007、2008、1108、1000 外 |
不需要对比 |
批次已经处理完成 |
❌ 失败 |
|
0000 |
2000、2007、2008 |
发起交易查询，更新交易状态 |
⏳ 处理中 |
|
2000、2007、2008、1108、1000 |
不需要对比 |
继续发起交易查询 |
⏳ 处理中 |
B9 还款通类
|
报文头返回码 |
明细返回码 |
处理方式 |
分类 |
|
0000 |
0000、4000 |
批次已经处理完成 |
✅ 成功 |
|
0000 |
除 0000、4000、2000、2007、2008 外 |
批次已经处理完成 |
❌ 失败 |
|
除 0000、2000、2007、2008、1108、1000 外 |
不需要对比 |
批次已经处理完成 |
❌ 失败 |
|
0000 |
2000、2007、2008 |
发起交易查询，更新交易状态 |
⏳ 处理中 |
|
2000、2007、2008、1108、1000 |
不需要对比 |
继续发起交易查询 |
⏳ 处理中 |
三、返回码含义说明
B6 返回码说明
⚠️ 重要：3XXX 开头的返回码仅表示当前状态，商户系统需支持新增的 3XXX 返回码处理。
|
代码 |
含义 |
|
0000 |
处理成功 |
|
4000 |
已发送银行（默认成功，银行不能及时返回结果；若最终失败会生成退票交易，需对接退票通知接口） |
|
3001 |
查开户方原因 |
|
3002 |
没收卡 |
|
3003 |
不予承兑 |
|
3004 |
无效卡号 |
|
3005 |
受卡方与安全保密部门联系 |
|
3006 |
已挂失卡 |
|
3007 |
被窃卡 |
|
3008 |
余额不足 |
|
3009 |
无此账户 |
|
3010 |
过期卡 |
|
3011 |
密码错 |
|
3012 |
不允许持卡人进行的交易，请联系发卡行 |
|
3013 |
超出提款限额 |
|
3014 |
原始金额不正确 |
|
3015 |
超出取款次数限制 |
|
3016 |
已挂失折 |
|
3017 |
账户已冻结 |
|
3018 |
已清户 |
|
3019 |
原交易已被取消或冲正 |
|
3020 |
账户被临时锁定 |
|
3021 |
未登折行数超限 |
|
3022 |
存折号码有误 |
|
3023 |
当日存入的金额当日不能支取 |
|
3024 |
日期切换进行中 |
|
3025 |
PIN格式出错 |
|
3026 |
发卡方保密子系统失败 |
|
3027 |
原始交易不成功 |
|
3028 |
系统忙，请稍后再提交 |
|
3029 |
交易已被冲正 |
|
3030 |
账号错误 |
|
3031 |
账号户名不符 |
|
3032 |
账号货币不符 |
|
3033 |
无此原交易 |
|
3034 |
非活期账号 |
|
3035 |
找不到原记录 |
|
3036 |
货币错误 |
|
3037 |
磁卡未生效 |
|
3038 |
非通兑户 |
|
3039 |
账户已关户 |
|
3040 |
金额错误 |
|
3041 |
非存折户 |
|
3042 |
交易金额小于该储种的最低支取金额 |
|
3043 |
未与银行签约 |
|
3044 |
超时拒付 |
|
3045 |
合同（协议）号在协议库里不存在 |
|
3046 |
合同（协议）号还没有生效 |
|
3047 |
合同（协议）号已撤销 |
|
3048 |
业务已经清算，不能撤销 |
|
3049 |
业务已被拒绝，不能撤销 |
|
3050 |
业务已撤销 |
|
3051 |
重复业务 |
|
3052 |
找不到原业务 |
|
3053 |
批量回执包未到规定最短回执期限（M日） |
|
3054 |
批量回执包超过规定最长回执期限（N日） |
|
3055 |
当日通兑业务累计金额超过规定金额 |
|
3056 |
退票 |
|
3057 |
账户状态错误 |
|
3058 |
数字签名或证书错 |
|
3059 |
密码挂失 |
|
3060 |
格式错误 |
|
3061 |
密码初始状态不正确 |
|
3062 |
无折账号不允许交易 |
|
3063 |
证件类型和证件号码未输 |
|
3064 |
账户不支持 |
|
3065 |
户名错 |
|
3066 |
渠道不支持，交易无法支持 |
|
3067 |
该账户已欠费，不能办理此业务 |
|
3068 |
非个人活期结算户 |
|
3069 |
长期不动户，请到柜台办理业务 |
|
3070 |
处理活期产品主档错误 |
|
3071 |
外部系统错误 |
|
3072 |
提交金额等于或低于应收取的手续费 |
|
3073 |
省份信息错误或账号户名不符 |
|
3074 |
省份信息空缺或错误 |
|
3075 |
商户需要在银行或中心登记 |
|
3076 |
账号类型不正确 |
|
3077 |
证件类型或号码错误 |
|
3078 |
渠道金额超限 |
|
3079 |
手机号错或非银行预留手机号 |
|
3080 |
出资方余额不足（只针对联合付款接口） |
|
3082 |
客户证件有效期过期 |
|
3083 |
Ⅱ、Ⅲ类户日累计或年累计交易限额超限 |
|
3084 |
不支持信用卡交易 |
|
3085 |
不支持Ⅱ、Ⅲ类户交易 |
|
3086 |
贷款资金不得用于固定资产、股权等投资 |
|
3087 |
客户在银行预留的信息不全或不符 |
|
3088 |
银行黑名单账户或因风控拒绝交易 |
|
3089 |
暂停非柜面交易，请到柜面或网点处理 |
|
3090 |
行名或行号不存在 |
|
3810 |
非渠道有效交易时间 |
|
3888 |
身份验证失败 |
|
3900 |
风控异常 |
|
3998 |
验证码错误 |
|
3999 |
其他错误 |
B7 还款通查询接口返回状态说明
|
状态码 |
含义 |
|
1 |
扣款成功，付款成功 |
|
2 |
扣款成功，付款失败，退款成功 |
|
3 |
扣款成功，付款失败，退款处理中 |
|
4 |
扣款成功，付款失败，退款失败（需通联进一步退款） |
|
5 |
扣款成功，付款处理中 |
|
6 |
扣款失败，付款终止 |
|
7 |
扣款处理中，付款未发起 |
|
8 |
扣款处理中，付款终止（后续扣款成功走9/10/11流程，失败走6流程） |
|
9 |
扣款成功，付款终止，退款成功 |
|
10 |
扣款成功，付款终止，退款处理中 |
|
11 |
扣款成功，付款终止，退款失败（需通联进一步退款） |
B10 报文格式错误返回码
以下返回码仅在 version > 04 时有效
|
状态码 |
含义 |
|
1001 |
报文解释错 |
|
1002 |
冲正时无此交易 |
|
1101 |
金额格式有问题 |
|
1102 |
记录序号重复 |
|
1103 |
汇总与明细金额不等 |
|
1104 |
汇总笔数和明细笔数不等 |
|
1105 |
商户参数错 |
|
1106 |
签名验证错 |
|
1107 |
权限不足 |
|
1108 |
批次号重复 |
|
1xxx |
交易被整包拒绝的错误（客户端必须兼容新增1xxx错误码） |
|
1999 |
本批交易已经全部失败（最终结果） |
|
1099 |
冲正失败请重试 |
B11 2开头返回码说明
|
状态码 |
含义 |
|
2000 |
系统正在对数据处理 |
|
2001 |
等待商户审核 |
|
2002 |
商户审核不通过 |
|
2003 |
等待受理 |
|
2004 |
不通过受理最终失败 |
|
2005 |
等待复核 |
|
2006 |
不通过复核 |
|
2007 |
提交银行处理中 |
|
2008 |
交易返回结果超时 |
四、签约解约接口处理逻辑
B12 接口 310001 签约响应处理逻辑
|
报文头返回码 |
明细返回码 |
处理方式 |
结果分类 |
|
0000 |
0000 |
签约申请成功 |
✅ 成功 |
|
0000 |
3XXX |
签约申请失败，检查客户信息是否正确 |
❌ 失败 |
|
其他返回码 |
不需要对比 |
重新发起签约申请 |
❌ 失败 |
B13 接口 310002 签约响应处理逻辑
|
报文头返回码 |
明细返回码 |
处理方式 |
结果分类 |
|
0000 |
0000 |
签约成功 |
✅ 成功 |
|
0000 |
3XXX |
签约失败 |
❌ 失败 |
|
其他返回码 |
不需要对比 |
重新发起签约申请 |
❌ 失败 |
B14 接口 310003 解约响应处理逻辑
|
报文头返回码 |
明细返回码 |
处理方式 |
结果分类 |
|
0000 |
0000 |
解约成功 |
✅ 成功 |
|
0000 |
3045 |
无此卡号协议，检查协议是否存在 |
⚠️ 无此协议 |
|
其他返回码 |
不需要对比 |
重新发起解约 |
❌ 失败 |
五、返回码快速索引
按返回码范围索引
|
返回码范围 |
类型 |
说明 |
|
0000 |
成功 |
处理成功 |
|
1000~1999 |
报文错误 |
报文格式、参数、签名等错误 |
|
2000~2008 |
处理中 |
系统处理中、等待审核/复核/受理等 |
|
3001~3016 |
卡/账户状态 |
挂失、冻结、密码错、余额不足等 |
|
3017~3039 |
账户问题 |
已清户、关户、非通兑户等 |
|
3040~3056 |
交易状态 |
金额错误、协议问题、退票等 |
|
3057~3090 |
信息校验 |
户名错、证件错、风控拦截等 |
|
3900~3999 |
其他错误 |
风控异常、验证码错误等 |
|
4000 |
已发送银行 |
默认成功，可能退票 |
常见返回码速查
|
返回码 |
含义 |
处理建议 |
|
0000 |
处理成功 |
更新为成功 |
|
1000 |
报文内容错或处理错 |
发起交易查询 |
|
1108 |
批次号重复 |
发起查询查看是否已受理 |
|
2000 |
系统处理数据中 |
发起交易查询 |
|
2007 |
提交银行处理中 |
发起交易查询 |
|
2008 |
交易返回结果超时 |
发起交易查询 |
|
3008 |
余额不足 |
检查商户余额 |
|
3043 |
未与银行签约 |
检查签约状态 |
|
3065 |
户名错 |
检查户名信息 |
|
3066 |
渠道不支持 |
调整路由配置 |
|
3082 |
证件有效期过期 |
更新证件信息 |
|
4000 |
已发送银行 |
默认成功，关注退票通知 |
处理中返回码汇总
|
返回码 |
含义 |
需发起交易查询 |
|
2000 |
系统处理数据中 |
✅ |
|
2001 |
等待商户审核 |
✅ |
|
2003 |
等待受理 |
✅ |
|
2005 |
等待复核 |
✅ |
|
2007 |
提交银行处理中 |
✅ |
|
2008 |
交易返回结果超时 |
✅ |
|
1000 |
报文内容错或处理错 |
✅ |
|
1108 |
批次号重复 |
✅ |