3.5联贷通接口组
3.5.1 联合付款(100072)
C：字符串
C (x,y)：最小长度 x、最大长度 y 的字符串
N (x)：固定 x 位整数
N (x,y)：最小长度 x、最大长度 y 的整数
限制类型：M - 必填，C - 选填
（2）请求报文模块说明：
- INFO模块：包含交易基本信息，如交易代码、版本、数据格式等，为必填模块，用于标识和控制交易的基础参数。
- JOINTTRANS模块：包含业务相关信息，如业务代码、商户代码、提交时间、账号信息、金额信息等，为必填模块，用于明确交易的业务属性、参与方账号及交易金额等核心业务数据。
- JOINT/JOINTDTL模块：包含联合放款成员信息，如成员商户号、成员放款金额，为必填模块，用于明确联合放款各成员的具体信息，且成员放款金额之和需等于总放款金额。
（3）响应报文模块说明：
- INFO模块：包含交易响应的基础信息，如交易代码、版本、数据格式、交易流水号、返回代码、错误信息、签名信息等，用于反馈交易的基础响应状态和标识信息。
- TRANSRET模块：包含交易结果的详细信息，如返回码、清算日期、错误文本、银行流水号等，用于反馈交易的具体处理结果、清算相关信息及银行层面的流水标识（VERSION为06时返回银行流水号）。
3.5.1.1 接口功能
l 在联合放贷类产品的联合付款交易中，支持两个出资方在通联通分别开设商户号，并通过线下汇款或系统对接充值方式将放贷资金预存到各自对应的通联通商户号，同时双方在通联通开设联名商户号，该联名商户号可接收交易指令。
l联名商户号接收交易指令后，会实时向两个出资方进行付款资金归集，归集顺序为先余额归集再对公户扣款归集，归集成功后向持卡人合并一笔进行付款
l每次请求仅处理一笔交易，请求实时处理并返回最终结果（即时到账）；若银行未在规定时间内处理完成，通联会返回接收结果超时（处理中的状态），待银行处理完成后，通联会实时更新结果，商户可发起交易查询以更新交易结果。
l 支持商户通过交易流水号（REQ_SN）进行后续的查询交易、对账等操作，该字段在通联系统交易查询页面可查，且商户系统交易查询页面应显示该字段，以便交易出现问题时提供给通联技术人员排查。
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全文。 |
||||||