3.5联贷通报文组


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全文。

 


huangwg 2025年4月1日 15:24 299 0 条评论 收藏文档