3.4还款通报文组
报文调用关系
3.4.1 实时还款(100007)
3.4.1.1报文功能
用于同名信用卡还款，转出方为借记卡，转入方为信用卡。
3.4.1.2请求报文
|
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
|
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
100007 |
M |
|
|
VERSION |
版本 |
C(2) |
04 |
M |
|
|
|
DATA_TYPE |
数据格式 |
N(1) |
2：xml格式 |
M |
|
|
|
LEVEL |
处理级别 |
N(1) |
0-9 0优先级最低 |
M |
|
|
|
MERCHANT_ID |
商户代码 |
C(10,20) |
商户ID |
非空 |
|
|
|
USER_NAME |
用户名 |
C(1,20) |
|
M |
|
|
|
USER_PASS |
用户密码 |
|
|
C |
不校验，（无需填写或可置空） |
|
|
REQ_SN |
交易流水号 |
C(1,60) |
必须全局唯一，商户提交的批次号必须以商户号开头以保证与其他商户不冲突，一旦冲突交易将无法提交；建议格式：商户号+时间+固定位数顺序流水号。该字段值用于后续的查询交易、对账文件等的唯一标识，对应通联系统中的交易文件名，可以在通联系统交易查询页面查询到该值 |
M |
商户系统交易查询页面应显示该字段值，以便交易出问题时，可直接找到该流水号给通联技术人员进行排除 |
|
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
|
TRANSFER |
MERCHANT_ID |
商户代码 |
C(10,20) |
商户ID |
M |
|
|
SUBMIT_TIME |
提交时间 |
C (14) |
YYYYMMDDHHMMSS |
M |
|
|
|
ACCOUNT_NAME |
账号名 |
C(1,60) |
持卡人姓名 |
M |
|
|
|
FROM_AMOUNT |
扣款金额 |
N(1,12) |
扣款金额 |
C |
为空时等于还款金额 |
|
|
AMOUNT |
金额 |
N(1,12) |
还款金额，整数，单位分。 |
M |
|
|
|
CURRENCY |
货币类型 |
C (3) |
人民币：CNY，默认为人民币。 |
M |
|
|
|
BUSINESS_CODE |
业务代码 |
C(6) |
转出方业务代码，见附录A2业务代码 |
M |
|
|
|
FROM_BANK_CODE |
银行代码 |
C(8) |
银行代码，标识化必须填写。参见附录A.3银行代码 针对账户类型传06的，必须上送银行代码 |
标识化卡号必须填写 |
不填根据卡bin决定 |
|
|
FROM_ACCOUNT_NO |
账号 |
N(1,32) |
转出方借记卡号码 |
M |
|
|
|
FROM_ACCOUNT_TYPE |
账号类型 |
C(2) |
00银行卡，01存折，02信用卡,03准贷记卡，04标识化借记卡，05标识化贷记卡。不填默认为银行卡00。 新增06:银联token账号 |
C |
|
|
|
FROM_ACCOUNT_PROP |
账号属性 |
C(1) |
0私人，1公司。不填时，默认为私人0。 |
C |
|
|
|
TO_BANK_CODE |
银行代码 |
C(8) |
银行代码，标识化必须填写。参见附录A.3银行代码 针对账户类型传06的，必须上送银行代码 |
标识化卡号必须填写 |
不填根据卡bin决定 |
|
|
TO_ACCOUNT_NO |
账号 |
N(1,32) |
转入方信用卡号码 |
M |
|
|
|
TO_ACCOUNT_TYPE |
账号类型 |
C(2) |
00银行卡，01存折，02信用卡,03准贷记卡，04标识化借记卡，05标识化贷记卡。不填默认为银行卡00。 新增06:银联token账号 |
M |
信用卡还款场景默认上传05 |
|
|
TO_ACCOUNT_PROP |
账号属性 |
C(1) |
0私人，1公司。不填时，默认为私人0。 |
C |
|
|
|
ID_TYPE |
开户证件类型 |
C (1) |
参考A.1证件类型 |
M |
看具体渠道，有些必须上送，联系客户经理 |
|
|
ID |
证件号 |
C(1,22) |
|
M |
看具体渠道，有些必须上送，联系客户经理 |
|
|
TEL |
手机号/小灵通 |
C(1,13) |
小灵通带区号，不带括号，减号 |
M |
看具体渠道，有些必须上送，联系客户经理 |
|
|
CUST_USERID |
自定义用户号 |
C(0,128) |
商户自定义的用户号，开发人员可当作备注字段使用 |
C |
|
|
|
REMARK |
备注 |
C(1,50) |
供商户填入备注信息 |
C |
|
|
|
SUMMARY |
交易附言 |
C(1,30) |
填入网银的交易备注 |
C |
|
|
|
TERMINFO
|
TRX_IP |
交易时的设备IP
|
C(23) |
|
C |
|
|
TERM_TYPE |
设备类型 |
C(2) |
|
07电脑 08手机 10平板设备 18可穿戴设备 19数字电视 20条码支付受理终端 00其它
|
||
|
TERM_MAC |
设备MAC
|
C(20) |
|
C |
C |
|
|
TERM_IMEI |
终端设备标识号IMEI
|
C(15) |
|
C |
|
|
|
TERM_NO |
终端编号
|
C(5) |
|
C |
|
|
|
TERM_MODE |
设备型号 |
C(2) |
|
C |
|
|
|
TERM_SIM |
SIM卡号
|
C(30) |
|
C |
|
|
|
GPS |
GPS信息 |
C(10) |
|
C |
|
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
||||||
3.4.1.3响应报文
|
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
|
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
100007 |
M |
|
|
VERSION |
版本 |
C(2) |
04 |
M |
|
|
|
DATA_TYPE |
数据格式 |
N(1) |
2：xml格式 |
M |
|
|
|
REQ_SN |
交易流水号 |
C(1,60) |
原请求报文的流水号，原样返回 |
M |
|
|
|
RET_CODE |
C(4) |
参考附录B9与B6 |
M |
|
||
|
ERR_MSG |
错误信息 |
C(1,256) |
|
M |
|
|
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
|
TRANSRET |
RET_CODE |
返回码 |
C(4) |
参考附录B9与B6 |
M |
|
|
ERR_MSG |
错误文本 |
C(1,256) |
|
M |
|
|
|
VOUCHERNO |
银行流水 |
C(1,46) |
银行流水 |
C |
|
|
|
SETTLE_DAY |
清算日期 |
C(8) |
YYYYMMDD |
M |
|
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
||||||
3.4.2 还款通结果查询(200008)
3.4.2.1 报文功能
只能查询40天之内的交易数据
还款通结果查询
l 对于某笔超时的实时交易需要查询结果，超时后3分钟内，相邻查询时间间隔不应短于20秒
l 在超时后3-10分钟内，相邻查询时间间隔不应短于1分钟
l 在超时后10分钟以上的，相邻查询时间间隔不应短于5分钟
l 对于30分钟内通联一直返回1002的，应确认该笔交易失败，通联没有成功接收，应立刻停止继续查询。
l 响应报文中的QTSFRSP/TSFDTL，包括两条或以上记录（有退款交易时包含2条以上）。
3.4.2.2 请求报文
|
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
|
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200008 |
M |
|
|
VERSION |
版本 |
C(2) |
04 |
M |
|
|
|
DATA_TYPE |
数据格式 |
N(1) |
2：xml格式 |
M |
|
|
|
REQ_SN |
交易批次号 |
C(40) |
|
M |
|
|
|
MERCHANT_ID |
商户代码 |
C(10,20) |
商户ID |
非空 |
|
|
|
USER_NAME |
用户名 |
C(1,20) |
|
M |
|
|
|
USER_PASS |
用户密码 |
|
|
C |
不校验，（无需填写或可置空） |
|
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
|
QTRANSREQ |
MERCHANT_ID |
商户代码 |
C(15) |
商户ID |
M |
|
|
QUERY_SN |
要查询的交易流水 |
C(40) |
也就是原请求交易中的REQ_SN的值 |
M |
|
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
||||||
3.4.2.3 响应报文
|
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
|
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200008 |
M |
|
|
VERSION |
版本 |
C(2) |
04 |
M |
|
|
|
DATA_TYPE |
数据格式 |
N(1) |
2：xml格式 |
M |
|
|
|
REQ_SN |
交易批次号 |
C(40) |
|
M |
|
|
|
RET_CODE |
N |
0000处理完毕 |
M |
|
||
|
ERR_MSG |
错误信息 |
C(1,256) |
|
C |
|
|
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
|
QTSFRSP |
ORDERSTATUS |
订单状态 |
C(1) |
1扣款成功，付款成功 2扣款成功，付款失败，退款成功 3扣款成功，付款失败，退款处理中 4扣款成功，付款失败，退款失败（针对退款失败的，一般为渠道原因，需通联进一步退款） 5扣款成功，付款处理中 6扣款失败，付款终止 7扣款处理中，付款没发起 8扣款处理中，付款终止（8的情况，为系统关单任务触发了对付款交易置了失败，后续扣款成功则走9,10，11流程。扣款失败则走6流程） 9扣款成功，付款终止，退款成功 10扣款成功，付款终止，退款处理中 11扣款成功，付款终止，退款失败（针对退款失败的，一般为渠道原因，需通联进一步退款）。 |
|
|
|
QTSFRSP/TSFDTL |
BATCHID |
交易批次号 |
C(40) |
也就是原请求交易中的REQ_SN的值 |
C |
|
|
SN |
记录序号 |
C(4) |
也就是原请求交易中的SN的值 |
C |
|
|
|
TRXCODE |
交易类型 |
C(6) |
交易类型 100007转入 100010转出 100012转出回退/100009清算前退款 |
M |
|
|
|
TRXDIR |
交易方向 |
C(0) |
0 付 1收 |
C |
|
|
|
SETTDAY |
清算日期 |
C(8) |
YYYYMMdd |
C |
|
|
|
FINTIME |
完成时间 |
C(14) |
|
C |
|
|
|
SUBMITTIME |
提交时间 |
C(14) |
yyyyMMddHHmmss |
C |
|
|
|
ACCOUNT_NO |
账号 |
C(1,32) |
只返回卡号后4位 |
C |
|
|
|
AMOUNT |
金额 |
N(1,12) |
|
C |
|
|
|
CUST_USERID |
自定义用户号 |
C (0,128) |
原代收付请求报文中的CUST_USERID字段 |
C |
交易请求中的原样返回 |
|
|
REMARK |
备注 |
C (1,50) |
|
C |
交易请求中的原样返回 |
|
|
SUMMARY |
交易附言 |
C(1,140) |
|
C |
|
|
|
VOUCHERNO |
银行流水 |
C(1,46) |
转入方银行流水 |
C |
TRXCODE为100007时显示 |
|
|
RET_CODE |
返回码 |
C(4) |
0000处理成功，其他参考参考附录B6 |
C |
|
|
|
ERR_MSG |
错误文本 |
C(1,256) |
|
C |
|
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
||||||