3.7通用报文组
3.7.1 退款(REFUND)
3.7.1.1 报文功能
该接口适合收款类交易类型的退款,包括单笔/批量协议支付、直接支付、批量代收、实时代收。
退款接口业务类型用:09200 商户退款
3.7.1.2 请求报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
REFUND |
否 |
|
VERSION |
版本 |
C(2) |
04 |
否 |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
|
LEVEL |
处理级别 |
N(1) |
0-9 0优先级最低 |
否 |
|
|
MERCHANT_ID |
商户号 |
C(15) |
商户号 |
否 |
|
|
USER_NAME |
用户名 |
C(1,20) |
|
否 |
|
|
USER_PASS |
用户密码 |
|
|
是 |
不校验,(无需填写或可置空) |
|
REQ_SN |
交易流水号 |
C(0,60) |
建议格式:商户号-System.currentTimeMillis()
该字段值,对应通联系统中的交易文件名,可以在通联系统交易查询页面查询到该值 |
否 |
商户系统交易查询页面应显示该字段值,以便交易出问题时,可直接找到该流水号给通联技术人员进行排除 |
|
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
|
REFUND |
BUSINESS_CODE |
业务代码 |
C(6) |
见附录A2业务代码 |
非空 |
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID |
非空 |
|
|
ORGBATCHID |
原批次 |
C(0,60) |
原交易的REQ_SN |
非空 |
原批次号和原文件号至少填一个 |
|
ORGBATCHSN |
原批次序号 |
C(1,4) |
原交易的记录序号,原交易为单笔实时交易时填0 |
非空 |
|
|
ACCOUNT_NO |
账号 |
N(1,32) |
银行卡或存折号码 |
可空 |
|
|
AMOUNT |
退款金额 |
N(1,12) |
整数,单位分 |
非空 |
|
|
LEDGER_BACK |
分账回退标识 |
C(0,1) |
1:走分账回退逻辑,原交易如已分账,退款时已分账部分从原分账入金方先回退到交易发起方再进行退款处理;非1走原逻辑退款,即不管是否分生分账,退款从交易发起方出金进行退款处理 |
可空 |
走1分账回退方式 |
|
NOTIFYURL |
通知地址 |
C(200) |
|
可空 |
|
|
LEDGERS/ LEDGERDTL
|
SN |
退款出资序号 |
C(1,4) |
记录序号 |
可空 |
如走 1 分账回退方式,部分金额退款,填写退款出资序号(全额退款可不填写) |
MERCHANT_ID |
退款出资商户号 |
C(10,20) |
商户ID |
可空 |
如走 1 分账回退方式,部分金额退款,填写退款出资序号(全额退款可不填写) |
|
AMOUNT |
退款出资金额 |
C(12) |
整数,单位分 |
可空 |
如走 1 分账回退方式,部分金额退款,填写退款出资序号(全额退款可不填写) |
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
3.7.1.3 响应报文
交易名称 |
支付经办 |
报文类型 |
响应报文 |
|||
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
REFUND |
否 |
|
VERSION |
版本 |
C(2) |
06 |
否 |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
|
REQ_SN |
交易流水号 |
C(40) |
原请求报文的流水号,原样返回 |
否 |
|
|
RET_CODE |
C(4) |
参考附录B3与B6 |
否 |
|
||
ERR_MSG |
错误信息 |
C(1,256) |
|
可 |
|
|
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
|
TRANSRET |
RET_CODE |
返回码 |
C(4) |
参考附录B3与B6 |
可 |
|
SETTLE_DAY |
清算日期 |
C(14) |
YYYYMMDD HHMMSS |
非空 |
|
|
ERR_MSG |
错误文本 |
C(1,256) |
|
可 |
|
|
VOUCHERNO |
银行流水号 |
C(1,46) |
|
可 |
VERSION为06才返回该值 |
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
3.7.1.4 例子
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>REFUND</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<USER_NAME>20060400000044502</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>1394619610993</REQ_SN>
<SIGNED_MSG>94039860......6cd2c220</SIGNED_MSG>
</INFO>
<REFUND>
<BUSINESS_CODE>00600</BUSINESS_CODE>
<MERCHANT_ID>200604000000445</MERCHANT_ID>
<ORGBATCHID>14031200041358</ORGBATCHID>
<ORGBATCHSN>0001</ORGBATCHSN>
<ACCOUNT_NO>11111111111111111111</ACCOUNT_NO>
<ACCOUNT_NAME>张三</ACCOUNT_NAME>
<AMOUNT>46000</AMOUNT>
<REMARK>REMARK</REMARK>
</REFUND>
</AIPG>
======================响应内容======================
返回报文:
<?xml version="1.0"
encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>REFUND</TRX_CODE>
<VERSION>03</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>1394619610993</REQ_SN>
<RET_CODE>0000</RET_CODE>
<SIGNED_MSG>1db0a12eb……..40b85</SIGNED_MSG>
</INFO>
<TRANSRET>
<RET_CODE>0000</RET_CODE>
<SETTLE_DAY>20130821</SETTLE_DAY>
</TRANSRET>
</AIPG>
3.7.2 交易结果查询(200004)
3.7.2.1 报文功能
接口只支持15天之内的交易查询。
l超时实时交易查询时间间隔:
某笔超时实时交易需要查询结果,相邻查询时间间隔不应短于10秒;当查询到最终结果,应立刻停止继续查询。
l批量交易查询时间间隔:
批量交易同步响应只代表通联受理成功,不代表交易最终状态,要发起查询更新交易结果,建议至少间隔5分钟查询一次。
l响应或查询返回1002的处理:
对于查询后一直返回1002,必须30分钟后才确认通联没有成功接收,认为该笔交易失败,并立刻停止继续查询。
3.7.2.2 请求报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200004 |
M |
|
VERSION |
版本 |
C(2) |
06 |
M |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
M |
|
|
REQ_SN |
交易批次号 |
C(60) |
|
M |
|
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID,十位或十五位 |
非空 |
|
|
USER_NAME |
用户名 |
C(1,20) |
|
M |
|
|
USER_PASS |
用户密码 |
|
|
C |
不校验,(无需填写或可置空) |
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
QTRANSREQ |
|
|
|
|
|
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID |
M |
|
|
QUERY_SN |
要查询的交易流水 |
C(60) |
也就是原请求交易中的REQ_SN的值 |
M |
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
3.7.2.3 响应报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
|
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200004 |
M |
|
|
VERSION |
版本 |
C(2) |
06 |
M |
|
||
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
M |
|
||
REQ_SN |
交易批次号 |
C(60) |
|
M |
|
||
RET_CODE |
N |
0000处理完毕 |
M |
参考b5处理 |
|||
ERR_MSG |
错误信息 |
C(1,256) |
|
C |
|
||
SIGNED_MSG |
签名信息 |
C |
|
M |
|
||
QTRANSRSP/QTDETAIL |
BATCHID |
交易批次号 |
C(40) |
也就是原请求交易中的REQ_SN的值 |
C |
|
|
SN |
记录序号 |
C(4) |
也就是原请求交易中的SN的值 |
C |
|
||
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) |
|
C |
返回卡号前 6 后 4
|
||
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 |
上送06版本和还款通交易类型才会返回该值 |
||
FEECYCLE |
收费周期 |
c(1,4) |
|
|
上送06版本 才会返回该字段 0其他 1预收 |
||
RET_CODE |
返回码 |
C(4) |
0000处理成功,其他参考附录B6 |
C |
|
||
ERR_MSG |
错误文本 |
C(1,256) |
|
C |
|
||
|
MFEE |
商户手续费 |
N(1,12) |
|
C |
上送06版本 才会返回该字段 |
|
|
UFEE |
此卡人手续费 |
N(1,12) |
|
C |
上送06版本 才会返回该字段 |
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
|
||||||
|
|
|
|
|
|
|
|
3.7.2.4 例子
3.7.5 卡bin查询(200007)
3.7.5.1 报文功能
l 查询银联卡卡BIN信息。
3.7.5.2 请求报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200007 |
否 |
|
VERSION |
版本 |
C(2) |
04 |
否 |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
|
REQ_SN |
交易批次号 |
C(60) |
|
否 |
|
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID,十位或十五位 |
非空 |
|
|
USER_NAME |
用户名 |
C(1,20) |
|
否 |
|
|
USER_PASS |
用户密码 |
|
|
是 |
不校验,(无需填写或可置空) |
|
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
|
QCARDBINREQ |
ACCTNO |
卡号 |
C(32) |
卡号 |
非空 |
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
3.7.5.3 响应报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
|
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200007 |
否 |
|
|
VERSION |
版本 |
C(2) |
04 |
否 |
|
||
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
||
REQ_SN |
交易批次号 |
C(60) |
|
否 |
|
||
RET_CODE |
N |
0000处理完毕 1002匹配不到卡bin |
否 |
见3.4 |
|||
ERR_MSG |
错误信息 |
C(1,256) |
|
可 |
|
||
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
||
QCARDBINRSP |
ACCTNO |
卡号 |
C(32) |
卡号 |
非空 |
|
|
ISSNAME |
机构名称 |
C(60) |
机构名称 |
非空 |
|
||
ISSCODE |
机构代码 |
C(10) |
机构代码 |
非空 |
|
||
ISSID |
ISSID |
C(10) |
|
非空 |
|
||
ISSIDLEN |
ISS长度 |
N(1) |
|
非空 |
|
||
CARDTYPE |
账号类型 |
C(1) |
1借记卡2准贷记卡 3贷记卡4预付卡 |
非空 |
|
||
|
BANKCODE |
银行代码 |
C(8) |
银行代码 |
可空 |
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
|
||||||
|
|
|
|
|
|
|
|
3.7.5.4 例子
3.7.7 电子回单异步下载接口(100055)
3.7.7.1 请求报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
100055 |
M |
|
VERSION |
版本 |
C(2) |
04 |
M |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
M |
|
|
LEVEL |
处理级别 |
N(1) |
0-9 0优先级最低,默认为5 |
M |
|
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID |
M |
|
|
USER_NAME |
用户名 |
C(1,20) |
|
M |
|
|
USER_PASS |
用户密码 |
|
|
C |
不校验,(无需填写或可置空) |
|
REQ_SN |
请求流水号 |
C(60) |
|
M |
不重复流水 |
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
ELE_BILL |
MERCHANT_ID |
商户代码 |
C(15) |
商户号ID |
M |
|
FILENAME |
原回单交易请求流水 |
C(60) |
原交易的流水号 |
M |
|
|
FSN |
交易序号 |
C(60) |
单笔默认为0,批量对应明细sn |
M |
|
3.7.7.2 响应报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
100055 |
M |
|
VERSION |
版本 |
C(2) |
04 |
M |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
M |
|
|
REQ_SN |
请求流水号 |
C(60) |
|
M |
|
|
RET_CODE |
C(4) |
0000:正常返回 1002:交易未找到 1000:报文格式有问题 |
M |
|
||
ERR_MSG |
错误信息 |
C(1,256) |
|
C |
|
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
ELE_BILL_RSP |
URL |
URL路径 |
C(256) |
|
M |
返回的URL只有文件路径和参数,域名根据对接网络自行添加。 |
举例:
返回的URL值如下(用浏览器打开链接去掉amp;)
/signpdf/20211101/通联通业务电子凭证_7316283608530953_0.pdf?key=6Hy2A9dajyvPkJaINh9Dhw&expires=1635753741,连接下载有效时长为1分钟。
测试环境 对应的电子回单下载链接为https://tlt-test.allinpay.com/tlttransfile/signpdf/20211101/通联通业务电子凭证_7316283608530953_0.pdf?key=6Hy2A9dajyvPkJaINh9Dhw&expires=1635753741
生产环境公网域名为tlt.allinpay.com,对应的电子回单下载链接为
https://tlt.allinpay.com/newrpdownload/signpdf/20211101/通联通业务电子凭证_7316283608530953_0.pdf?key=6Hy2A9dajyvPkJaINh9Dhw&expires=1635753741。
3.7.8 对账文件异步下载(200009)
3.7.8.1 报文功能
1,时间范围:只能下载过去45天内的成功交易明细(按交易完成时间统计)。每天(D日)可下载从D-1日至D-45日任意一天的数据。
2,请求处理:请求返回2008时,请每间隔10分钟再次发起请求,直到明细的返回码DOWNURL/RET_CODE返回0000,获取到url为止。
3,链接解码:返回的url通过BASE64编码,需进行BASE64解密,链接有效期为5分钟
。
4,文件下载与解压:下载解码后的链接指向zip文件。解压密码由报文签名的私钥(SM2或RSA)解密返回报文中的KEY字段获得,详细参考DEMO
3.7.8.2 请求报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200009 |
否 |
|
VERSION |
版本 |
C(2) |
13 |
否 |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
|
LEVEL |
处理级别 |
N(1) |
0-9 0优先级最低 |
否 |
|
|
USER_NAME |
用户名 |
C(1,20) |
|
否 |
|
|
USER_PASS |
用户密码 |
|
|
是 |
不校验,(无需填写或可置空) |
|
REQ_SN |
交易流水号 |
C(60) |
商户号+唯一标识流水 |
否 |
不重复流水 |
|
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
|
RECONREQ |
MERCHANT_ID |
商户代码 |
C(15) |
商户ID |
非空 |
|
RECON_DATE |
日期 |
C(8) |
YYYYMMDD |
非空 |
|
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
3.7.8.3 响应报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
200009 |
否 |
|
VERSION |
版本 |
C(2) |
13 |
否 |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
|
REQ_SN |
交易流水号 |
C(60) |
|
否 |
|
|
RET_CODE |
C(4) |
|
否 |
|
||
ERR_MSG |
错误信息 |
C(1,256) |
|
可 |
|
|
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
|
DOWNURL |
RET_CODE |
返回码 |
C(4) |
1000 :不支持非历史日期对账文件下载 2008:生成中 0000:生成完成 |
否 |
|
ERR_MSG |
返回信息 |
C(1,256) |
可 |
|||
URL |
下载链接 |
C(1,256 ) |
返回的url通过BASE64编码,需进行BASE64解密 |
可 |
|
|
KEY |
对账文件压缩包密码 |
C(1,512) |
使用报文签名对应的私钥以及算法(SM2或者RSA)进行解密,详见Demo |
可 |
||
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |