3.6账务报文组


3.6账务报文组

3.6.1  账户信息查询(300000)

3.6.1.1  报文功能

l  查询商户在通联的虚拟账户的基本信息,一般情况下商户只需查询付款的虚拟账户余额,一般以商户号+001。具体去通联通平台账务=>商户账户查询对应的账户

3.6.1.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300000

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

非空

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

ACQUERYREQ

ACCTNO

账户号

C(30)

查询的账户,具体值联系运营查看

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.1.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300000

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

REQ_SN

交易流水号

C(40)

 

 

RET_CODE

返回代码

C(4)

0000 查询成功

 

ERR_MSG

错误信息

C(1,256)

 

 

SIGNED_MSG

签名信息

C

 

 

ACQUERYREP/ACNODE

ACCTNO

账户号

C(30)

 

 

 

ACCTNAME

账户名

C(256)

 

 

 

BALANCE

余额

N(30)

 

 

 

USABLEBAL

可用余额

N(30)

 实际可用余额

 

 

BALBY

余额方向

N(1)

 1借方 2贷方

 

 

DEPOSIT

是否允许充值

N(1)

0否1是

 

 

WITHDRAW

是否允许提现

N(1)

0否1是

 

 

TRANSFERIN

是否允许转入

N(1)

0否1是

 

 

TRANSFEROUT

是否允许转出

N(1)

0否1是

 

 

PAYABLE

是否允许支付

N(1)

0否1是

 

 

DEFCLR

默认结算户

N(1)

是否默认结算户

 

 

数字签名原文为没有SIGNED_MSG   签名信息项的xml全文。

3.6.1.4 例子

请求报文:
?xml version="1.0"
  encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>300000</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1526543036319</REQ_SN>
<SIGNED_MSG>84d0761ddfc9bf72ee68478046343744b875fcc0a377a81658c4c13d5f94d43ad646d66a6eb7a57c5b1da0102b779e51912109147ac69c6ba2e4f973112cfebe7bb496c17bd5ddd2be2acb504b5f6071672d9b28dc4d6d4cace17efdc2c4529a0263eea8ed6f81062cb86de69f4dffc3fed2ac43aab04d9035cd0cfbaf607769</SIGNED_MSG>
</INFO>
<ACQUERYREQ/>
</AIPG>
返回报文:
<?xml version="1.0"
  encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>300000</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526543036319</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>查询成功</ERR_MSG>
<SIGNED_MSG>5fa003a893fd96bbe521d61a0c3c879541288c6393f8ad06103abc223646ecd524874e1177aa3dd28b4cbe87577ec46e01911d594c2c36579562a91414f41f9389e9cb83285994a456733a695fc7b36bfe83701b704a03e49571b1161f189194d44495e35be12237441907088c76b5e86d10e4279318772d025b30323dd86cd538461542ec15d6f28e4844d2a79ecdb2096e0130b7cff9513bb2c8c763610dc2bb8cb5442a4ff2cb427a59a03e0a9c51f058dbd777425227e805d02ec833c8322cb50b9069704a96fb41ff5a69e922d25d6b56dcde3a8fd78821616085bdb08d94c35f2ec30b470c161d569305139753d7fec9120ffc2050665565ed5410778f</SIGNED_MSG>
</INFO>
<ACQUERYREP>
<ACNODE>
<ACCTNO>200604000004497000</ACCTNO>
<ACCTNAME>联调测试接口V-退款户</ACCTNAME>
<BALANCE>0</BALANCE>
<USABLEBAL>0</USABLEBAL>
<BALBY>2</BALBY>
<DEPOSIT>0</DEPOSIT>
<WITHDRAW>0</WITHDRAW>
<TRANSFERIN>0</TRANSFERIN>
<TRANSFEROUT>0</TRANSFEROUT>
<PAYABLE>0</PAYABLE>
<DEFCLR>0</DEFCLR>
</ACNODE>
<ACNODE>
<ACCTNO>200604000004497001</ACCTNO>
<ACCTNAME>联调测试接口V</ACCTNAME>
<BALANCE>-47763200</BALANCE>
<USABLEBAL>0</USABLEBAL>
<BALBY>2</BALBY>
<DEPOSIT>1</DEPOSIT>
<WITHDRAW>1</WITHDRAW>
<TRANSFERIN>1</TRANSFERIN>
<TRANSFEROUT>1</TRANSFEROUT>
<PAYABLE>1</PAYABLE>
<DEFCLR>0</DEFCLR>
</ACNODE>
<ACNODE>
<ACCTNO>200604000004497002</ACCTNO>
<ACCTNAME>联调测试接口V-客付手续费收入</ACCTNAME>
<BALANCE>0</BALANCE>
<USABLEBAL>0</USABLEBAL>
<BALBY>2</BALBY>
<DEPOSIT>0</DEPOSIT>
<WITHDRAW>0</WITHDRAW>
<TRANSFERIN>0</TRANSFERIN>
<TRANSFEROUT>0</TRANSFEROUT>
<PAYABLE>0</PAYABLE>
<DEFCLR>0</DEFCLR>
</ACNODE>
<ACNODE>
<ACCTNO>200604000004497003</ACCTNO>
<ACCTNAME>联调测试接口V-收款户</ACCTNAME>
<BALANCE>4383808</BALANCE>
<USABLEBAL>0</USABLEBAL>
<BALBY>2</BALBY>
<DEPOSIT>0</DEPOSIT>
<WITHDRAW>0</WITHDRAW>
<TRANSFERIN>0</TRANSFERIN>
<TRANSFEROUT>0</TRANSFEROUT>
<PAYABLE>0</PAYABLE>
<DEFCLR>0</DEFCLR>
</ACNODE>
<ACNODE>
<ACCTNO>200604000004497004</ACCTNO>
<ACCTNAME>联调测试接口V- 自付手续费收入</ACCTNAME>
<BALANCE>1240</BALANCE>
<USABLEBAL>0</USABLEBAL>
<BALBY>2</BALBY>
<DEPOSIT>0</DEPOSIT>
<WITHDRAW>0</WITHDRAW>
<TRANSFERIN>0</TRANSFERIN>
<TRANSFEROUT>0</TRANSFEROUT>
<PAYABLE>0</PAYABLE>
<DEFCLR>0</DEFCLR>
</ACNODE>
<ACNODE>
<ACCTNO>200604000004497005</ACCTNO>
<ACCTNAME>联调测试接口V-应收手续费</ACCTNAME>
<BALANCE>920</BALANCE>
<USABLEBAL>0</USABLEBAL>
<BALBY>1</BALBY>
<DEPOSIT>0</DEPOSIT>
<WITHDRAW>0</WITHDRAW>
<TRANSFERIN>0</TRANSFERIN>
<TRANSFEROUT>0</TRANSFEROUT>
<PAYABLE>0</PAYABLE>
<DEFCLR>0</DEFCLR>
</ACNODE>
</ACQUERYREP>
</AIPG>

3.6.2  历史余额查询(300001)

3.6.2.1  报文功能

l  查询商户在通联的虚拟账户的历史余额信息,一般用于查询虚拟账户余额,也就是余额查询接口,账号具体去通联通平台账务=>商户账户查询对应的账户,

只能查询一天;

3.6.2.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300001

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

非空

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

AHQUERYREQ

ACCTNO

账户号

C(30)

查询的账户

非空

 

STARTDAY

开始日期

C(8)

yyyyMMdd

非空

只能查一天

ENDDAY

结束日期

C(8)

yyyyMMdd

非空

只能查一天,跟开始日期一样的值

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.2.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300001

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

REQ_SN

交易流水号

C(40)

 

 

RET_CODE

返回代码

C(4)

0000 查询成功

1000 日期格式错误

 

ERR_MSG

错误信息

C(1,256)

 

 

SIGNED_MSG

签名信息

C

 

 

AHQUERYREP

ACCTNO

账户号

C(30)

 

 

 

AHQUERYREP/BALNODE

PERIODDAY

日期

N(8)

yyyyMMdd

 

 

BALANCE

余额变动

N(30)

单位分

 

 

OPENINGBAL

期初余额

N(30)

单位分

 

当日凌晨的余额值

CLOSINGBAL

期末余额

N(30)

单位分

 

也就是当前虚拟户余额

DRBALANCE

借方发生额

N(30)

单位分

 

版本号VERSION为06有

CRBALANCE

贷方发生额

N(30)

单位分

 

版本号VERSION为06有

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

3.6.2.4  例子

 

请求报文:<?xml
  version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>300001</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1526544861702</REQ_SN>
<SIGNED_MSG>19d3035023975f0cccc1d2be3bd296fdb196339db8ba4b3fc241458c286a29de529d5cbf4fe60e12f9e78bc85ef0ffdd81eb4dec6eb15bb069ee4e70aa6ec9e22586be256a13fbca5be0c2a0b5d2336b1a714e4f55748616f81401daa0f741f290bd288516ac006f72c57fcda84f5dedb703a552ffb15584a71f37df28ea2c63</SIGNED_MSG>
</INFO>
<AHQUERYREQ>
<ACCTNO>200604000004497001</ACCTNO>
<STARTDAY>20180516</STARTDAY>
<ENDDAY>20180517</ENDDAY>
</AHQUERYREQ>
</AIPG>
返回报文:
<?xml version="1.0"
  encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>300001</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526544861702</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>查询成功</ERR_MSG>
<SIGNED_MSG>7fe7b55ecd5b270598b5bee7cc5fdf34a0d91a3d61e9c269e365e1ee03ae7db000310f9ee4201e3d47fa916c40780b68236e9b5b9928b6a4ffbed332ce718f95fc417ea5dbdbf0dd32da79884e34f40f9f28af93f897d9ca7ce20e14d3403a3b22e67aeef2dc8abd80364a40d395dcfdffe9dcf6e33922ef34ab946f13821655b0c27ffdc8e73999b3d997b75332b546ceff3b27644aa0fa06b546d291be8124b3aa291fe7e0311c55915acfcdfb208c2928b5a6340518d725cdce00fdbb6b20a4e65dec61fc76645c3488d37bc786d8ece55fb0a94943479cd9135afa559d6fbf09739035da70f99f1a047522bd09c09bd99555a336cc97a72e4e4be178b8a4</SIGNED_MSG>
</INFO>
<AHQUERYREP>
<ACCTNO>200604000004497001</ACCTNO>
<BALNODE>
<PERIODDAY>20180516</PERIODDAY>
<BALANCE>-47480832</BALANCE>
<OPENINGBAL>-24320</OPENINGBAL>
<CLOSINGBAL>-47505152</CLOSINGBAL>
</BALNODE>
<BALNODE>
<PERIODDAY>20180517</PERIODDAY>
<BALANCE>-258048</BALANCE>
<OPENINGBAL>-47505152</OPENINGBAL>
<CLOSINGBAL>-47763200</CLOSINGBAL>
</BALNODE>
</AHQUERYREP>
</AIPG>

3.6.3  汇款充值通知(300002)

3.6.3.1  报文功能

l  商户汇款到通联的对公户后,通过该接口通知通联通系统入账商户的余额户。

3.6.3.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300002

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

非空

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

TUQNOTIFYREQ

MERCHANT_ID

商户代码

C(10)

 商户ID

非空

 

ACCTNO

充值帐户

C(30)

充值进账帐户,必须是允许充值的通联帐户

 

 

INACCT

汇入户

C(30)

汇入的通联银行帐户

 

 

OUTACCT

汇出户

C(30)

汇出款项的商户银行账户

非空

 

AMOUNT

金额

N(12)

单位为分

 

 

CUST_USERID

自定义用户号

C (0,128)

商户自定义的用户号,用户号要唯一

可空

 

MEMO

银行备注

C(50)

汇款时填写的银行备注

 

 

 

 

 

 

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.3.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300002

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

REQ_SN

交易流水号

C(40)

 

 

RET_CODE

返回代码

C(4)

返回2000表示接收成功

返回0000表示充值成功

 

ERR_MSG

错误信息

C(1,256)

 

 

SIGNED_MSG

签名信息

C

 

 

TUNOTIFYREP

ACCTNO

账户号

C(30)

 

 

 

TRXID

充值交易流水

C(40)

 

可空

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.4  账户提现(300003)

3.6.4.1  报文功能

l  从虚拟户提现到指定的银行账号,银行账号必须是商户入网是配置的银行账号。

3.6.4.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300003

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

非空

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

CASHREQ

ACCTNO

通联账户

C(30)

通联账户,必须允许提现

 

BANKACCT

银行帐户

C(30)

银行帐户,必须预先报备给通联

 

AMOUNT

金额

N(12)

单位分,

 

 

USAGE

摘要

C(30)

摘要

 

 

CUST_USERID

自定义用户号

C (0,128)

商户自定义的用户号,用户号要唯一

可空

 

MEMO

备注

C(30)

备注

 

 

 

 

 

 

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.4.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300003

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

REQ_SN

交易流水号

C(40)

 

 

RET_CODE

返回代码

C(4)

 

 

ERR_MSG

错误信息

C(1,256)

 

 

REPTIME

响应时间

C(14)

yyyyMMdd

 

SIGNED_MSG

签名信息

C

 

 

CASHREP

AMOUNT

金额

N(30)

单位分

 

 

 

 

 

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

3.6.4.4 例子

请求报文:
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>300003</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1526547276080</REQ_SN>
<SIGNED_MSG>50652819fc622d0eaa8549c9450097f6ce0306e4fb2de807806614df723f162ad69d8d4e286058d0d702ad3d056b5962e12bd551e4a6e79db659f6c62a79bc5532dabc54f0f2ccc25da390f816ef685fded51089d0dd28ecd09483e15f150b42b9d8712f2998ceff5f4975300d71d1a9cd07ad5abfccec3bd4456dc1d4ad9676</SIGNED_MSG>
</INFO>
<CASHREQ>
<ACCTNO>201303000000000130440</ACCTNO>
<BANKACCT>622484848393030244</BANKACCT>
<AMOUNT>1000001</AMOUNT>
</CASHREQ>
</AIPG>
返回报文:
<?xml version="1.0"
  encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>300003</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526547276080</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>提现成功</ERR_MSG>
<SIGNED_MSG>284aedce32cac1ee28fea5a0c084901223603ae0e0574a96c30e1cf2d9c94df9effa33c27c39cf42566c7aa45fb92c7f80cb176fa3a3a5572e337102c4da8ef4f7feb3e0dce6a148f07d39393f7bda02df4c5e1cfdaa323fefa00c04d4a5810be0f2fee127b02fa81026220bf83ce9dc5e37e7916a7f447d776c394c8b2375ca5c7b56aabc49de37fa0c82ee5b15e78aa2ff864e6a899289a2058e63537f035fdad482f610052abd6ac8dfd9dcde0161c306dcd5412c0412cfba119ffa3d5ea5e702c05a47ff73e5aa2044b00ee0980fe6c5ec195d0562f7107a2cbd564519e5d02c77116a0682ad97db2c69037dd1a8ad30fc0d718cdd995af669e46c51fd7a</SIGNED_MSG>
</INFO>
<CASHREP>
<AMOUNT>1000001</AMOUNT>
</CASHREP>
</AIPG>

3.6.5 汇入金分账

收到汇入金通知后,使用通知中的BATCHID值(交易流水号)发起分账交易,一笔汇入金只能发起一次分账交易,且仅支持一个月内的汇入金交易。

3.6.5.1 请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100191

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

用户密码

   

M

 

REQ_SN

交易批次号

C(40)

 

M

不重复流水

SIGNED_MSG

签名信息

C

 

M

 

FUNDIN_LEDGER

MERCHANT_ID

商户代码

C(15)

商户号ID

M

INFO的MERCHANT_ID一致,不一致会报错

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

 

ORGBATCHID

原交易流水

C(60)

 

M

 

LEDGERS/

LEDGERDTL

SN

记录序号

C(1,4)

不能重复

C

 

MERCHANT_ID

分账商户号

C(10,20)

 

C

 

AMOUNT

分账金额

C(12)

整数,单位分,TYPE为0时必填

C

 

TYPE

分账类型

C (1)

0按金额分账 1按比例分账 默认0(如果按照比例分的话是后台固定配置的,不需要上送,分账金额可以为空,如需配置,请联系通联客户经理提需求配置)

C

 

3.6.5.2 响应报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100191

M

 

VERSION

版本

C(2)

03

M

 

DATA_TYPE

数据格式

N(1)

2:xml格式

M

 

REQ_SN

交易批次号

C(40)

 

M

 

RET_CODE

返回代码

C(4)

参考3.4

M

 

ERR_MSG

错误信息

C(1,256)

 

C

 

SIGNED_MSG

签名信息

C

 

M

 

TRANSRET

RET_CODE

返回码

C(4)

参考3.4

C

 

ERR_MSG

错误文本

C(1,256)

 

C

 

SETTLE_DAY

清算日期

C(8)

YYYYMMDD

C

 

数字签名原文为没有SIGNED_MSG签名信息项的xml全文。

3.6.6 汇入金分账查询

3.6.6 .1 请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100192

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

用户密码

   

M

 

REQ_SN

交易批次号

C(40)

 

M

不重复流水

SIGNED_MSG

签名信息

C

 

M

 

QTRANSREQ

QUERY_SN

汇入金流水号

C(60)

汇入金流水号

M

 

3.6.6 .2 响应报文说明

只有当头部返回码为0000时,才有TRANSRET对象。当头部返回码为1002时,表示该笔汇入金分账交易不存在。

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100192

M

 

VERSION

版本

C(2)

03

M

 

DATA_TYPE

数据格式

N(1)

2:xml格式

M

 

REQ_SN

交易批次号

C(40)

 

M

 

RET_CODE

返回代码

C(4)

参考3.4

M

 

ERR_MSG

错误信息

C(1,256)

 

C

 

SIGNED_MSG

签名信息

C

 

M

 

TRANSRET

RET_CODE

返回码

C(4)

参考3.4

C

无此交易时不存在

ERR_MSG

错误文本

C(1,256)

 

C

无此交易时不存在



3.6.7  账户充值(300006)

目前对公充值支持的银行有:亿联银行 、北京中关村 、江苏银行、中信百信银行、新网银行 、南京银行、苏宁银行、招商银行、富邦华一银行、无锡锡商银行(需先报备并开通协议号维护到系统中,具体联系业务同事)

3.6.7.1  报文功能

l  充值实时到账,上送的银行账户必须是向通联报备的账户

3.6.7.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300006

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

CHARGEREQ

 

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

非空

 

BANKACCT

银行帐户

C(30)

银行帐户,必须预先报备给通联

非空

 

AMOUNT

金额

N(12)

单位分

非空

 

CUST_USERID

自定义用户号

C (0,128)

商户自定义的用户号,开发人员可当作备注字段使用

可空

 

SUMMARY

交易附言

C (1,30)

填入网银的交易备注

可空

 

REMARK

备注

C (1,50)

供商户填入参考信息

可空

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.7.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

300006

 

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)

见查询交易明细响应码,本响应码为处理的最终响应码。

可空

当该需要需要商户审核时,0000表示受理成功,不代表交易成功;不需要审核时,为最终结果,也就是充值成功(0000)或者充值失败(非0000)

SETTLE_DAY

清算日期

C(8)

YYYYMMDD

非空

 

ERR_MSG

错误文本

C(1,256)

 

可空

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

3.6.8  内部转账(100400)

3.6.8.1  报文功能

l  商户之间余额账户的转账,但两个商户之间转账必须要先向通联运营申请配置,不然会报无权限转账。

3.6.8.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100400

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

ACCTTRANSFERREQ

PAYEECUSID

转入方商户号

 

转入方商户号

 

AMOUNT

金额

N(12)

单位分

 

MEMO

备注

C(30)

备注

 

 

 

 

 

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

3.6.8.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100400

 

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)

 

 

ERR_MSG

错误文本

C(1,256)

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

3.6.8.4  例子

 

请求报文:
<?xml version="1.0"
  encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100400</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1526550384564</REQ_SN>
<SIGNED_MSG>7e8802420ed59578fffde2e734636be46809c9a80a583c7dc55e76e92c50ca9adae5f2aa7c57cd632441b475f446ed97c7b008a2b236cfe87ad6c9358d8263350d86d73de2de43f0b338a1a003d15fda15154cfd872d3e2b938254a8ac7bc8e35f9d7a4aea15706665b82ca94da0056f9e6a01541f83948592768cf31b1ddd7a</SIGNED_MSG>
</INFO>
<ACCTTRANSFERREQ>
<PAYEECUSID>200604000001509</PAYEECUSID>
<AMOUNT>1000</AMOUNT>
<MEMO>内部转账</MEMO>
</ACCTTRANSFERREQ>
</AIPG>
返回报文:
<?xml version="1.0"
  encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100400</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1526550384564</REQ_SN>
<SIGNED_MSG>7e8802420ed59578fffde2e734636be46809c9a80a583c7dc55e76e92c50ca9adae5f2aa7c57cd632441b475f446ed97c7b008a2b236cfe87ad6c9358d8263350d86d73de2de43f0b338a1a003d15fda15154cfd872d3e2b938254a8ac7bc8e35f9d7a4aea15706665b82ca94da0056f9e6a01541f83948592768cf31b1ddd7a</SIGNED_MSG>
</INFO>
<ACCTTRANSFERREQ>
<PAYEECUSID>200604000001509</PAYEECUSID>
<AMOUNT>1000</AMOUNT>
<MEMO>内部转账</MEMO>
</ACCTTRANSFERREQ>
</AIPG>

3.6.9  批量内部转账(100401)

3.6.9.1  报文功能

l  商户之间余额账户的转账,但两个商户之间转账必须要先向通联运营申请配置,不然会报无权限转账。

3.6.9.2  请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100401

 

VERSION

版本

C(2)

04

 

DATA_TYPE

数据格式

N(1)

2:xml格式

 

LEVEL

处理级别

N(1)

0-9 0优先级最低

 

MERCHANT_ID

商户代码

C(15)

 商户ID

 

USER_NAME

用户名

C(1,20)

 

 

USER_PASS

用户密码

 

 

 不校验,(无需填写或可置空)

REQ_SN

交易流水号

C(40)

商户号+唯一标识流水

不重复流水

SIGNED_MSG

签名信息

C

 

 

BACCTTRANSFE RREQ

/BSUM

TOTAL_ITEM

总记录数

N (1,4)

 

非空

 

TOTAL_SUM

总金额

N (1,12)

整数,单位分

非空

 

BACCTTRANSFERREQ

/DTLS

/DTL

SN

记录序号

C(1,4)

同一个请求内必须唯一。建议从0001开始递增,交易结果查询时,该字段会原样返回

非空

 

PAYEECUSID

转入方商户号

 

转入方商户号

非空

 

AMOUNT

金额

N(12)

单位分

非空

 

MEMO

备注

C(30)

备注

可空

 

 

 

 

 

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.6.9.3  响应报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

100401

 

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

 

 

BODY/RET_DETAILS/ RET_DETAIL

注意:如果整批请求被通联拒绝,则返回报文中无此字节信息

SN

记录序号

C(4)

原请求报文中的SN字段值,原封不动的返回

 

RET_CODE

返回码

C(4)

本响应码一般为提交成功的中间状态

 

ERR_MSG

错误文本

C(1,256)

 

 

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

 


huangwg 2025年2月19日 17:58 694 0 条评论 收藏文档