目录
3.基础交易报文
3.1 批量收付交易报文组
报文调用关系
返回报文说明
3.1.1 批量收款(100001)
3.1.1.1 报文功能
l 批量收款实时返回只是通联受理成功，不代表该交易的已经有最终状态，受理成功只是处理中状态，非实时的，处理时效根据交易笔数限制，要发起交易查询。
l 建议批量发起的交易笔数不超过1000笔，还有批次中不能存在相同卡号的交易。
3.1.1.2 请求报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100001 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
LEVEL |
处理级别 |
是 |
N(1) |
|
|
|
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
|
|
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
|
|
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
BODY/ TRANS_SUM |
BUSINESS_CODE |
业务代码 |
是 |
C(6) |
|
见附录A2业务代码,接入生产前，业务人员会提供，测试时，可以从该文档3.2对应的业务吗中随便选一个 |
|
NOTIFYURL |
通知地址 |
否 |
C(1,256) |
|
|
|
|
TOTAL_ITEM |
总记录数 |
是 |
N (1,4) |
|
|
|
|
TOTAL_SUM |
总金额 |
是 |
N (1,12) |
|
整数，单位分 |
|
|
BODY/ TRANS_DETAILS/ TRANS_DETAIL |
SN |
记录序号 |
是 |
C(1,4) |
|
同一个请求内必须唯一。建议从0001开始递增,交易结果查询时，该字段会原样返回 |
|
ACCOUNT_TYPE |
账号类型 |
是 |
C(2) |
00银行卡，01存折，02信用卡。不填默认为银行卡00。存折不填写将失败 |
|
|
|
ACCOUNT_PROP |
账号属性 |
是 |
C (1) |
0私人，1公司。不填时，默认为私人0。 |
|
|
|
ACCOUNT_NO |
账号 |
是 |
N(1,32) |
银行卡或存折号码 |
|
|
|
ACCOUNT_NAME |
账号名 |
是 |
C(1,60) |
银行卡或存折上的所有人姓名 |
。 |
|
|
BANK_CODE |
银行代码 |
存折必须填写 |
C(4,8) |
4位或8位数，参见附录A.3银行代码 |
存折必须填写 |
|
|
UNION_BANK |
支付行号 |
否 |
C(1,12) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
BANK_NAME |
开户行名称 |
否 |
C (1,60) |
|
开户行详细名称，也叫网点，如 中国建设银行广州东山广场分理处。 |
|
|
E_USER_CODE |
用户编号 |
否 |
C(1,20) |
|
客户编号,开发人员可当作备注字段使用 |
|
|
ID_TYPE |
开户证件类型 |
否 |
C (1) |
参考A.1证件类型 |
看具体渠道，有些必须上送，联系客户经理 |
|
|
ID |
证件号 |
否 |
C (1,22) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
TEL |
手机号/小灵通 |
否 |
C (1,13) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
AMOUNT |
金额 |
是 |
N(1,12) |
|
整数，单位分 |
|
|
CURRENCY |
货币类型 |
否 |
C (3) |
|
人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。 |
|
|
PROTOCOL |
协议号 |
否 |
C (1,60) |
|
开发人员可省略该字段，也可以当作备注字段使用 |
|
|
PROTOCOL_USERID |
协议用户编号 |
否 |
C (1,30) |
|
开发人员可省略该字段，也可以当作备注字段使用 |
|
|
PROVINCE |
开户行所在省 |
否 |
C (1,20) |
不带“省”或“自治区”，如 广东，广西，内蒙古等。 建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。 |
看具体渠道，有些必须上送，联系客户经理 |
|
|
CITY |
开户行所在市 |
否 |
C(1,20) |
不带“市”，如 广州，南宁等。 如果是直辖市，则填区，如北京（市）朝阳（区）。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。 |
看具体渠道，有些必须上送，联系客户经理 |
|
|
CUST_USERID |
自定义用户号 |
否 |
C (0,128) |
|
商户自定义的用户号，开发人员可省略该字段，也可以当作备注字段使用,该字段会在对账文件中原样返回 |
|
|
REMARK |
备注 |
否 |
C (1,50) |
|
供商户填入备注信息。 |
|
|
TARGETSETTACCT |
二次结算账户 |
否 |
C(1,60) |
|
|
|
|
SUMMARY |
交易附言 |
否 |
C (1,140) |
|
填入网银的交易备注,可以在网银明细中查询到该字段信息，但部分银行可能不支持 |
3.1.1.3 响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100001 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
|
|
|
|
RET_MSG |
返回信息 |
是 |
C(10,60) |
|
|
3.1.2 批量付款(100002)
3.1.2.1 报文功能
批量收款实时返回只是通联受理成功，不代表该交易的已经有最终状态，受理成功只是处理中状态，，非实时的，处理时效根据交易笔数限制；要发起交易查询；建议批量发起的交易笔数不超过1000笔，还有批次中不能存在相同卡号的交易；
3.1.2.2 请求报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100002 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
LEVEL |
处理级别 |
是 |
N(1) |
|
|
|
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
|
|
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
|
|
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
BODY/ TRANS_SUM |
BUSINESS_CODE |
业务代码 |
是 |
C(6) |
|
见附录A2业务代码,接入生产前，业务人员会提供，测试时，可以从该文档3.2对应的业务吗中随便选一个 |
|
NOTIFYURL |
通知地址 |
否 |
C(1,256) |
|
|
|
|
TOTAL_ITEM |
总记录数 |
是 |
N (1,4) |
|
|
|
|
TOTAL_SUM |
总金额 |
是 |
N (1,12) |
|
整数，单位分 |
|
|
BODY/ TRANS_DETAILS/ TRANS_DETAIL |
SN |
记录序号 |
是 |
C(1,4) |
|
同一个请求内必须唯一。建议从0001开始递增,交易结果查询时，该字段会原样返回 |
|
ACCOUNT_TYPE |
账号类型 |
是 |
C(2) |
00银行卡，01存折，02信用卡。不填默认为银行卡00。 |
|
|
|
ACCOUNT_PROP |
账号属性 |
是 |
C (1) |
0私人，1公司。不填时，默认为私人0。 |
|
|
|
ACCOUNT_NO |
账号 |
是 |
N(1,32) |
银行卡或存折号码 |
|
|
|
ACCOUNT_NAME |
账号名 |
是 |
C(1,60) |
银行卡或存折上的所有人姓名。 |
|
|
|
UNION_BANK |
支付行号 |
否 |
C(1,12) |
|
对公和存折交易，支行名称和行号必填一个 |
|
|
BANK_CODE |
银行代码 |
存折必须填写 |
C(8) |
4位或8位数，参见附录A.3银行代码 |
不填根据卡bin匹配，存折必须填写 |
|
|
BANK_NAME |
开户行名称 |
否 |
C (1,60) |
开户行详细名称，也叫网点，如 中国建设银行广州东山广场分理处。 |
对公和存折交易，支行名称和行号必填一个 |
|
|
PROVINCE |
开户行所在省 |
否 |
C (1,20) |
不带“省”或“自治区”，如 广东，广西，内蒙古等。 建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。 |
对公和存折建议上送 |
|
|
CITY |
开户行所在市 |
否 |
C (1,20) |
不带“市”，如 广州，南宁等。 如果是直辖市，则填区，如北京（市）朝阳（区）。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。 |
对公和存折建议上送 |
|
|
AMOUNT |
金额 |
是 |
N(1,12) |
|
整数，单位分 |
|
|
CURRENCY |
货币类型 |
否 |
C (3) |
人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。 |
|
|
|
PROTOCOL |
协议号 |
否 |
C (1,60) |
|
开发人员可省略该字段，也可以当作备注字段使用 |
|
|
PROTOCOL_USERID |
协议用户编号 |
否 |
C (1,30) |
|
开发人员可省略该字段，也可以当作备注字段使用 |
|
|
ID_TYPE |
开户证件类型 |
否 |
C (1) |
参考A.1证件类型 |
看具体渠道，有些必须上送，联系客户经理 |
|
|
ID |
证件号 |
否 |
C (1,22) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
TEL |
手机号 |
否 |
C (1,13) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
CUST_USERID |
自定义用户号 |
否 |
C (0,128) |
|
商户自定义的用户号，开发人员可省略该字段，也可以当作备注字段使用,该字段会在对账文件中原样返回 |
|
|
E_USER_CODE |
用户编号 |
否 |
C(1,20) |
|
客户编号,开发人员可当作备注字段使用 |
|
|
SUMMARY |
交易附言 |
否 |
C (1,140) |
|
填入网银的交易备注,可以在网银明细中查询到该字段信息，但部分银行可能不支持 |
|
|
REMARK |
备注 |
否 |
C (1,50) |
|
供商户填入参考信息。若为信用卡，填有效期, 开发人员可省略该字段，也可以当作备注字段使用 |
|
|
SETTACCT |
指定付款账户 |
否 |
N(1,32) |
用于商户指定代付交易的出金账户，渠道参数需先配置。 |
||
|
CHNLFLAG |
渠道标识 |
否 |
N (1) |
传1，指定超网 传2，指定小额 传3，指定大额 |
针对民生代付增加渠道标识 |
3.1.2.3 响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100002 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
|
|
|
|
RET_MSG |
返回信息 |
是 |
C(10,60) |
|
|
3.2 单笔收付报文组
报文调用关系
返回码说明：
3.2.1 单笔实时收款(100011)
3.2.1.1报文功能
每次请求只有一笔交易，请求都是实时处理（即时到账）并返回最终结果，但不排除存在银行不能在规定时间内处理完成，这时通联返回接收结果超时（处理中的状态），银行处理完成通联会实时更新结果，商户发起交易查询更新交易结果；
3.2.1.2请求报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100011 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
01 |
详见报文头说明 |
|
|
LEVEL |
处理级别 |
是 |
N(1) |
|
详见报文头说明 |
|
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
详见报文头说明 |
|
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
详见报文头说明 |
|
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
详见报文头说明 |
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
详见报文头说明 |
|
|
BODY/ TRANS |
BUSINESS_CODE |
业务代码 |
是 |
C(6) |
|
见附录A2业务代码 |
|
ACCOUNT_TYPE |
账号类型 |
是 |
C(2) |
00银行卡，01存折，02信用卡。不填默认为银行卡00。 |
|
|
|
ACCOUNT_PROP |
账号属性 |
是 |
C(1) |
0私人，1公司。不填时，默认为私人0。 |
|
|
|
ACCOUNT_NO |
账号 |
是 |
N(1,32) |
银行卡或存折号码 |
|
|
|
ACCOUNT_NAME |
账号名 |
是 |
C(1,60) |
银行卡或存折上的所有人姓名。 |
|
|
|
CVV2 |
信用卡CVV2 |
否 |
C(3) |
|
仅用于信用卡 |
|
|
VALIDATE |
信用卡有效期 |
否 |
C(6) |
YYMMDD |
仅用于信用卡 |
|
|
PROVINCE |
开户行所在省 |
否 |
C (1,20) |
不带“省”或“自治区”，如 广东，广西，内蒙古等。 建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。 |
看具体渠道，有些必须上送，联系客户经理 |
|
|
CITY |
开户行所在市 |
否 |
C(1,20) |
不带“市”，如 广州，南宁等。 如果是直辖市，则填区，如北京（市）朝阳（区）。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。 |
||
|
BANK_CODE |
银行代码 |
存折必须填写 |
C(4,8) |
4位或8位数，参见附录A.3银行代码 |
不填根据卡bin匹配，存折必须填写 |
|
|
AMOUNT |
金额 |
是 |
N(1,12) |
|
整数，单位分 |
|
|
CURRENCY |
货币类型 |
否 |
C (3) |
|
人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。 |
|
|
ID_TYPE |
开户证件类型 |
否 |
C (1) |
|
参考A.1证件类型，看具体渠道，有些必须上送，联系客户经理 |
|
|
ID |
证件号 |
否 |
C (1,22) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
TEL |
手机号/小灵通 |
否 |
C (1,13) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
PROTOCOL |
协议号 |
否 |
C (1,60) |
|
开发人员可省略该字段，也可以当作备注字段使用 |
|
|
CUST_USERID |
自定义用户号 |
否 |
C (0,128) |
|
商户自定义的用户号，开发人员可当作备注字段使用 |
|
|
TARGETSETTACCT |
二次结算账户 |
否 |
C(1,60) |
|
|
|
|
SUMMARY |
交易附言 |
否 |
C (1,30) |
|
填入网银的交易备注 |
|
|
REMARK |
备注 |
否 |
C (1,50) |
|
供商户填入参考信息 |
|
|
NOTIFYURL |
通知地址 |
否 |
C(1,256) |
|
|
3.2.1.3响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100011 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
|
|
|
|
RET_MSG |
返回信息 |
是 |
C(1,128) |
|
|
|
|
BODY/ TRANSRET |
COMPLETE_TIME |
交易完成时间 |
是 |
C(14) |
|
yyyyMMddHHmmss |
|
TL_SEQ |
通联流水 |
是 |
C(10,60) |
|
|
3.2.2 单笔实时付款(100014)
3.2.2.1 报文功能
每次请求只有一笔交易，请求都是实时处理（即时到账）并返回最终结果，但不排除存在银行不能在规定时间内处理完成，这时通联返回接收结果超时（处理中的状态），银行处理完成通联会实时更新结果，商户发起交易查询更新交易结果；
3.2.2.2 请求报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100014 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
LEVEL |
处理级别 |
是 |
N(1) |
|
|
|
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
|
|
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
|
|
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
BODY/ TRANS |
BUSINESS_CODE |
业务代码 |
是 |
C(6) |
|
见附录A2业务代码 |
|
ACCOUNT_TYPE |
账号类型 |
是 |
C(2) |
00银行卡，01存折，02信用卡。不填默认为银行卡00。 |
|
|
|
ACCOUNT_PROP |
账号属性 |
是 |
C (1) |
0私人，1公司。不填时，默认为私人0。 |
|
|
|
ACCOUNT_NO |
账号 |
是 |
N(1,32) |
银行卡或存折号码 |
|
|
|
ACCOUNT_NAME |
账号名 |
是 |
C(1,60) |
银行卡或存折上的所有人姓名。 |
|
|
|
CVV2 |
信用卡CVV2 |
否 |
C(3) |
|
仅用于信用卡 |
|
|
BANK_CODE |
银行代码 |
存折必须填写 |
C(8) |
4位或8位数，参见附录A.3银行代码 |
不填根据卡bin匹配，存折必须填写 |
|
|
BANK_NAME |
开户行名称 |
否 |
C (1,60) |
|
对公和存折交易，支行名称和行号必填一个 |
|
|
UNION_BANK |
支付行号 |
否 |
C(1,12) |
|
对公和存折交易，支行名称和行号必填一个 |
|
|
AMOUNT |
金额 |
是 |
N(1,12) |
|
整数，单位分 |
|
|
CURRENCY |
货币类型 |
否 |
C (3) |
人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。 |
|
|
|
ID_TYPE |
开户证件类型 |
否 |
C (1) |
|
参考A.1证件类型，看具体渠道，有些必须上送，联系客户经理 |
|
|
ID |
证件号 |
否 |
C (1,22) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
TEL |
手机号/小灵通 |
否 |
C (1,13) |
|
看具体渠道，有些必须上送，联系客户经理 |
|
|
PROTOCOL |
协议号 |
否 |
C (1,60) |
|
开发人员可省略该字段，也可以当作备注字段使用 |
|
|
CUST_USERID |
自定义用户号 |
否 |
C (0,128) |
|
商户自定义的用户号，开发人员可当作备注字段使用 |
|
|
SUMMARY |
交易附言 |
否 |
C (1,30) |
|
填入网银的交易 |
|
|
REMARK |
备注 |
否 |
C (1,50) |
|
供商户填入参考信息 |
|
|
SETTACCT |
指定付款账户 |
否 |
N(1,32) |
用于商户指定代付交易的出金账户，渠道参数需先配置 |
||
|
PROVINCE |
开户行所在省 |
否 |
C (1,20) |
不带“省”或“自治区”，如 广东，广西，内蒙古等。 建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。 |
对公和存折建议上送 |
|
|
CITY |
开户行所在市 |
否 |
C (1,20) |
不带“市”，如 广州，南宁等。 如果是直辖市，则填区，如北京（市）朝阳（区）。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。 |
对公和存折建议上送 |
|
|
NOTIFYURL |
通知地址 |
否 |
C(1,256) |
|
||
|
CHNLFLAG |
渠道标识 |
否 |
N (1) |
传1，指定超网 传2，指定小额 传3，指定大额 |
针对民生代付增加渠道标识 |
3.2.2.3 响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100014 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
|
|
|
|
RET_MSG |
返回信息 |
是 |
C(1,128) |
|
|
|
|
BODY/ TRANSRET |
COMPLETE_TIME |
交易完成时间 |
是 |
C(14) |
可空 |
yyyyMMddHHmmss |
|
TL_SEQ |
通联流水 |
是 |
C(10,60) |
可空 |
|
3.3 通用报文组
返回码说明
3.3.1 交易结果查询(200004)
3.3.1.1 报文功能
只能查询40天之内的交易数据
响应报文报文体BODY/QTDETAILS/QTDETAIL，如果交易明细状态是处理中的，没有RESULT_CODE字段，有最终结果才会返回RESULT_CODE。
单笔实时交易结果的查询
l 对于某笔超时的实时交易需要查询结果，超时后3分钟内，相邻查询时间间隔不应短于20秒
l 在超时后3-10分钟内，相邻查询时间间隔不应短于1分钟
l 在超时后10分钟以上的，相邻查询时间间隔不应短于5分钟
l 对于30分钟内通联一直返回1002的，应确认该笔交易失败，通联没有成功接收，应立刻停止继续查询。
批量交易结果的查询
l 建议至少间隔5分钟查询一次
l 对于50分钟内通联一直返回1002的，应确认该笔交易失败，通联没有成功接收，应立刻停止继续查询。
3.3.1.2 请求报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
200004 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
LEVEL |
处理级别 |
是 |
N(1) |
|
|
|
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
|
|
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
|
|
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
BODY/ QTRANSREQ |
SRC_BATCHID |
要查询的交易流水 |
是 |
C(40) |
|
也就是原请求交易中的REQ_SN的值 |
|
SRC_SN |
记录序号 |
否 |
C(10) |
|
查整批次时该字段为空 |
3.3.1.3 响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
200004 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
|
|
|
|
RET_MSG |
返回信息 |
是 |
C(1,128) |
|
|
|
|
BODY/ QTSUM |
STATUS |
状态 |
是 |
C(1) |
0:处理中 1:处理完成 |
|
|
CNT_TOTAL |
总笔数 |
是 |
C(1,4) |
|
|
|
|
CNT_COMPLETE |
完成笔数 |
是 |
C(1,4) |
|
|
|
|
BODY/ QTDETAILS/ QTDETAIL |
BATCHID |
交易批次号 |
是 |
C(40) |
|
也就是原请求交易中的REQ_SN的值 |
|
SN |
记录序号 |
否 |
C(4) |
|
也就是原请求交易中的SN的值 |
|
|
TL_SEQ |
通联流水 |
否 |
C(10,60) |
|
|
|
|
TRXCODE |
交易代码 |
是 |
C(6) |
|
|
|
|
SETTDAY |
清算日期 |
是 |
C(8) |
yyyyMMdd |
|
|
|
FINTIME |
完成时间 |
否 |
C(14) |
yyyyMMddHHmmss |
|
|
|
SUBMITTIME |
提交时间 |
否 |
C(14) |
yyyyMMddHHmmss |
|
|
|
ACCOUNT_NO |
账号 |
否 |
C(1,32) |
|
只返回卡号后4位 |
|
|
ACCOUNT_NAME |
账号名 |
否 |
C(1,60) |
|
|
|
|
AMOUNT |
金额 |
否 |
N(1,12) |
|
单位，分 |
|
|
CUST_USERID |
自定义用户号 |
否 |
C (0,128) |
|
原收款付请求报文中的CUST_USERID字段 |
|
|
REMARK |
备注 |
否 |
C (1,50) |
|
交易请求中的原样返回 |
|
|
SUMMARY |
交易附言 |
否 |
C(1,140) |
|
|
|
|
RESULT_CODE |
返回码 |
否 |
C(4) |
|
0000处理成功，其他参考参考附录B6 |
|
|
RESULT_MSG |
返回信息 |
否 |
C(1,256) |
|
|
3.3.2 对账文件下载(200002)
3.3.2.1 报文功能
l 只能下载40天之内的数据，只能下载一天的数据，建议一天下载一次，下载条件必须是d+1日下载d日的对账文件，如果下载的对账文件需要显示手续费字段的，必须在d+1日8点之后下载d日的对账文件。
l 对账文件下载可以根据请求参数进行对账文件下载。
l 当某个渠道尚未完成对账或对账文件尚未生成时，则返回码为1003。
l 当某个渠道完成对账时，则该商户该渠道的对账文件汇总行有值，但“收款总笔数、收款总金额、付款总笔数、付款总金额”，这些相关值为0。
3.3.2.2 请求报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
200002 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
LEVEL |
处理级别 |
是 |
N(1) |
|
|
|
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
|
|
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
|
|
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
BODY/ RECONF_DOWN |
SETTACCT |
结算账号 |
是 |
C(30) |
|
|
|
DAY |
日期 |
是 |
C(8) |
YYYYMMDD |
|
3.3.2.3 响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
200002 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
|
|
|
|
RET_MSG |
返回信息 |
是 |
C(1,128) |
|
|
|
|
BODY/ DOWN_RSP |
URL |
下载链接 |
是 |
C(0，256) |
|
|
|
MD |
摘要 |
是 |
C(512) |
|
MD5 |
|
|
FILENAME |
文件名 |
是 |
C(128) |
|
|
3.3.3 电子回单下载(100055)
目前仅支持下载民生银行2年内的付款和退票回单。
3.3.3.1 报文功能
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100055 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
||
|
LEVEL |
处理级别 |
是 |
N(1) |
|
||
|
MERCHANT_ID |
商户号 |
是 |
C(10,20) |
|
||
|
SUBMIT_TIME |
提交时间 |
是 |
C(14) |
|
||
|
USER_NAME |
用户名 |
是 |
C(1,20) |
|
||
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
||
|
BODY/ELE_BILL |
SRC_BATCHID |
原交易流水号 |
是 |
C(60) |
目前仅支持民生银行的付款和退票回单 以及上海建行-银企直联渠道的收款回单
|
|
|
SRC_SN |
交易序号 |
是 |
C（4） |
实时交易填0 |
3.3.3.2 响应报文
|
接口 |
字段 |
字段解释 |
必填 |
类型 |
取值 |
备注 |
|
HEAD |
TRX_CODE |
交易代码 |
是 |
C(6,10) |
100055 |
详见报文头说明 |
|
VERSION |
版本号 |
是 |
C(2) |
|
|
|
|
REQ_SN |
请求流水号 |
是 |
C(36,60) |
|
|
|
|
RET_CODE |
返回码 |
是 |
C(4) |
1002:交易未找到1003: 不支持下载 2008: 生成中0000：生成成功3997: 该交易不存在回单3999：生成失败 |
||
|
RET_MSG |
返回信息 |
是 |
C(1,128) |
|
|
|
|
BODY/ ELE_BILL_RSP |
URL |
下载URL |
是 |
C(128) |
3.4 交易通知接口
异步通知类的发起方为通联服务器，接收端为商户服务器。
3.4.1 收付交易完成通知
3.4.1.1 报文功能
报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。
3.4.1.2 请求报文
|
URL参数名 |
说明 |
类型 |
取值 |
必填 |
备注 |
|
NOTIFYTYPE |
通知类型 |
C(1) |
0明细完成通知 1批次完成通知 |
是 |
|
|
REQ_SN |
交易批次号 |
C(40) |
原请求报文中的交易流水REQ_SN |
是 |
|
|
SN |
记录序号 |
C(1,4) |
单笔交易为0，批量交易为SN |
是 |
|
|
TL_SEQ |
通联流水号 |
C(30,60) |
|
否 |
单笔实时交易非空 |
|
RETCODE |
返回码 |
C(4) |
|
是 |
|
|
RETMSG |
错误信息 |
|
|
是 |
|
|
TRXCODE |
交易代码 |
C(6) |
|
否 |
|
|
ACCOUNT_NO |
账号 |
N(1,32) |
银行卡或存折号码 |
否 |
单笔实时交易非空 |
|
MOBILE |
手机号/小灵通 |
C (1,13) |
小灵通带区号，不带括号，减号 |
否 |
|
|
AMOUNT |
金额 |
N(1,12) |
整数，单位分 |
否 |
单笔实时交易非空 |
|
SUBMITTIME |
提交时间 |
C(14) |
yyyyMMddHHmmss |
否 |
|
|
COMPLETE_TIME |
交易完成时间 |
C(14) |
yyyyMMddHHmmss |
否 |
单笔实时交易非空 |
|
CUST_USERID |
用户代码 |
C(20) |
交易提交时CUST_USERID |
否 |
|
|
SIGN |
签名 |
|
使用SHA256withRSA签名。签名原始内容为 REQ_SN|SN|TRXCODE|RETCODE |
是 |
|
3.4.1.3 响应报文
商户系统返回一行内容
SUCCESS或者ERROR
3.4.2 退票通知接口
3.4.2.1 报文说明
报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。
3.4.2.2 请求报文
|
URL参数名 |
说明 |
类型 |
取值 |
必填 |
备注 |
|
NOTIFYTYPE |
退票通知 |
C(16) |
11 |
是 |
|
|
REQ_SN |
退票交易流水 |
C(30,60) |
|
是 |
|
|
SN |
退票交易序号 |
C(4) |
是 |
|
|
|
RETCODE |
返回码 |
C(4) |
|
是 |
|
|
RETMSG |
错误信息 |
C(1,256) |
|
否 |
退票原因 |
|
TRXCODE |
交易类型 |
C(6) |
100105 |
是 |
|
|
ACCOUNT_NO |
账号 |
N(1,32) |
|
是 |
|
|
AMOUNT |
金额 |
C(1,60) |
整数，单位分 |
是 |
|
|
SUBMITTIME |
提交时间 |
C(14) |
yyyyMMddHHmmss |
是 |
|
|
COMPLETE_TIME |
交易完成时间 |
C(14) |
yyyyMMddHHmmss |
是 |
|
|
SRC_REQ_SN |
原交易流水号 |
C(1,16) |
|
是 |
|
|
SRC_SN |
原交易序号 |
C(1,60) |
|
是 |
|
|
REMARK |
备注 |
C(1,60) |
|
否 |
|
|
SIGN |
签名 |
|
使用SHA256withRSA签名。签名原始内容为 REQ_SN|SN|TRXCODE|RETCODE |
是 |
|
3.4.2.3 响应报文
商户系统返回一行内容
SUCCESS(匹配成功)或者UNSUCCESS(匹配失败)或者ERROR(处理异常)
3.5 文件格式
3.5.1 对账文件
文件名规范：PDS_商户号_日期(yyyymmdd)_商户银行账户.txt
对账文件分成不同的字段，字段之间用|@|分开
对账文件的第一行是总摘要信息，格式为
|
字段 |
内容 |
说明 |
|
1 |
PDSMK |
PDS对账文件标记，固定为PDSMK |
|
2 |
V200 |
版本号,本说明的版本固定为V200 |
|
3 |
收款总笔数 |
对账文件的收款总笔数 |
|
4 |
收款总金额 |
对账文件的收款总金额（分） |
|
5 |
付款总笔数 |
对账文件的付款总笔数 |
|
6 |
付款总金额 |
对账文件的付款总金额（分） |
对账文件的第二行起是对账的明细内容，格式如下
|
字段 |
内容 |
说明 |
|
1 |
通联批次号 |
Xml中的REQ_SN |
|
2 |
通联序号 |
Xml中的SN |
|
3 |
交易状态 |
交易状态,参见附录定义 |
|
4 |
交易金额 |
单位分 |
|
5 |
对方账号 |
被付或被扣帐户 |
|
6 |
通联交易时间 |
格式YYYYMMDDhhmmss |
|
7 |
通联交易日期 |
格式YYYYMMDD |
|
8 |
自定义用户号 |
Xml中的CUST_USERID |
|
9 |
手续费 |
下载对账文件时手续费为空时以0表示 |
|
10 |
交易类型 |
100011实时收 100001批量收 100014实时付 100002批量付 |
|
11 |
交易方向 |
0：付 1：收 |
|
12 |
渠道交易日期 |
格式YYYYMMDD |
|
13 |
渠道流水 |
银行对账文件的流水 |
|
14 |
渠道金额 |
单位分 |
|
15 |
渠道摘要 |
|
|
16 |
关联交易 |
|
1) 金服宝平台按渠道给商户生成对账文件，因每个银行提供对账文件的时间不同，故金服宝给商户提供对账文件的时间为每天早上12:00。
2) 金服宝平台自动对交易账，对账逻辑为以渠道对账文件为基准，与交易明细进行一一勾兑，匹配上金服宝交易明细的对账文件明细，补充完善相关的交易明细信息，如对账文件中的字段1-11。
3) 若存在渠道对账文件明细，在金服宝交易明细中没找到情况，则对账文件明细字段1-11为空。
4) 商户根据对账文件中统计的金额与网银的明细进行资金对账，该步骤由商户线下处理，不在金服宝平台操作。
5) 由于每个银行的日切时间不一样，大多少银行的日切时间范围为晚上21:00-23:00,故在此期间若出现对账文件明细挂账或交易明细挂账，商户需T+2日做进一步对账方可确定是否为差错交易。