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