3.5联贷通报文组
3.5.1 联合付款(100072)
3.5.1.1 报文功能
l 在联合放贷类产品,联合付款交易,指两个出资方都在通联通开设商户号,分别将放贷资金通过线下汇款或系统对接充值方式,将资金预存到对应的通联通商户号下。两个出资方在通联通同时开设一个联名商户号,用于交易的发起。联名商户号收到交易指令后,实时向两个出资方进行付款资金归集,先余额归集再对公户扣款归集,归集成功后向持卡人合并一笔进行付款。
l 每次请求只有一笔交易,请求都是实时处理(即时到账)并返回最终结果,但不排除存在银行不能在规定时间内处理完成,这时通联返回接收结果超时(处理中的状态),银行处理完成通联会实时更新结果,商户发起交易查询更新交易结果。
3.5.1.2 请求报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
限制 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
100072 |
M |
|
VERSION |
版本 |
C(2) |
06 |
M |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
M |
|
|
LEVEL |
处理级别 |
N(1) |
0-9 0优先级最低 |
M |
|
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID,十位或十五位 |
M |
|
|
USER_NAME |
用户名 |
C(1,20) |
|
M |
|
|
USER_PASS |
用户密码 |
|
|
C |
不校验,(无需填写或可置空) |
|
REQ_SN |
交易流水号 |
C(40) |
必须全局唯一,商户提交的批次号必须以商户号开头以保证与其他商户不冲突,一旦冲突交易将无法提交;建议格式:商户号+时间+固定位数顺序流水号。该字段值用于后续的查询交易、对账文件等的唯一标识,对应通联系统中的交易文件名,可以在通联系统交易查询页面查询到该值 |
M |
商户系统交易查询页面应显示该字段值,以便交易出问题时,可直接找到该流水号给通联技术人员进行排除 |
|
SIGNED_MSG |
签名信息 |
C |
|
M |
|
|
JOINTTRANS |
BUSINESS_CODE |
业务代码 |
C(6) |
见附录A2业务代码 |
M |
|
MERCHANT_ID |
商户代码 |
C(15) |
商户ID |
M |
|
|
SUBMIT_TIME |
提交时间 |
C (14) |
YYYYMMDDHHMMSS |
M |
|
|
E_USER_CODE |
用户编号 |
C(1,20) |
客户编号,开发人员可当作备注字段 |
C |
|
|
BANK_CODE |
银行代码 |
C(8) |
银行代码,存折必须填写。参见附录A.3银行代码,针对账户类型传06的,必须上送银行代码 |
存折必须填写 |
无法通过银联卡bin识别出银行代码的,都需要上送银行代码 |
|
BANK_NAME |
开户行名称 |
C (1,60) |
开户行详细名称,也叫网点,如 中国建设银行广州东山广场分理处。 |
C |
|
|
ACCOUNT_TYPE |
账号类型 |
C(2) |
00银行卡,01存折,02信用卡。不填默认为银行卡00。新增06:银联token账号 |
C |
|
|
ACCOUNT_NO |
账号 |
N(1,32) |
银行卡或存折号码 |
M |
|
|
ACCOUNT_NAME |
账号名 |
C(1,60) |
银行卡或存折上的所有人姓名。 |
M |
|
|
PROVINCE |
开户行所在省 |
C (1,20) |
不带“省”或“自治区”,如 广东,广西,内蒙古等。 建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。 |
C |
看具体渠道,有些必须上送,联系客户经理 |
|
CITY |
开户行所在市 |
C (1,20) |
不带“市”,如 广州,南宁等。 如果是直辖市,则填区,如北京(市)朝阳(区)。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。 |
C |
看具体渠道,有些必须上送,联系客户经理 |
|
ACCOUNT_PROP |
账号属性 |
C (1) |
0私人,1公司。不填时,默认为私人0。 |
M |
|
|
AMOUNT |
金额 |
N(1,12) |
整数,单位分 |
M |
|
|
CURRENCY |
货币类型 |
C (3) |
人民币:CNY, 港元:HKD,美元:USD。不填时,默认为人民币。 |
M |
|
|
ID_TYPE |
开户证件类型 |
C (1) |
参考A.1证件类型 |
C |
看具体渠道,有些必须上送,联系客户经理 |
|
ID |
证件号 |
C (1,22) |
|
C |
看具体渠道,有些必须上送,联系客户经理 |
|
TEL |
手机号/小灵通 |
C (1,13) |
小灵通带区号,不带括号,减号 |
C |
看具体渠道,有些必须上送,联系客户经理 |
|
CVV2 |
CVV2 |
C (3) |
|
C |
|
|
VAILDDATE |
有效期 |
C (4) |
|
C |
|
|
CUST_USERID |
自定义用户号 |
C (0,128) |
商户自定义的用户号,开发人员可当作备注字段使用 |
C |
|
|
UNION_BANK |
支付行号 |
C(1,12) |
支付行号 |
C |
|
|
SUMMARY |
交易附言 |
C (1,140) |
填入网银的交易备注 |
C |
|
|
REMARK |
备注 |
C (1,50) |
供商户填入参考信息 |
C |
|
|
JOINT/JOINTDTL |
MERCHANT_ID |
联合放款成员商户号 |
C(15) |
商户ID |
M |
该节点为联合放款的成员列表,列表内成员放款金额之和等于放款金额 |
AMOUNT |
该成员放款金额 |
N(1,12) |
整数,单位分 |
M |
||
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |
3.5.1.3 响应报文
接口 |
字段ID |
字段名称 |
类型 |
取值 |
可空 |
备注 |
INFO |
TRX_CODE |
交易代码 |
C(1, 20) |
100072 |
否 |
|
VERSION |
版本 |
C(2) |
04 |
否 |
|
|
DATA_TYPE |
数据格式 |
N(1) |
2:xml格式 |
否 |
|
|
REQ_SN |
交易流水号 |
C(40) |
|
否 |
|
|
RET_CODE |
C(4) |
|
否 |
|
||
ERR_MSG |
错误信息 |
C(1,256) |
|
可 |
|
|
SIGNED_MSG |
签名信息 |
C |
|
否 |
|
|
TRANSRET |
RET_CODE |
返回码 |
C(4) |
参考附录B8与B6 |
可 |
|
SETTLE_DAY |
清算日期 |
C(8) |
YYYYMMDD |
非空 |
|
|
ERR_MSG |
错误文本 |
C(1,256) |
|
可 |
|
|
VOUCHERNO |
银行流水号 |
C(1,16) |
|
C |
VERSION为06才返回该值 |
|
数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。 |