收付通API

通联核心产品文档中心

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  接口功能

从虚拟户提现到指定的银行账号，请求报文的CASHREQ模块：包含通联账户、银行账户、金额等提现相关信息，为必填模块，其中自定义用户号和备注为选填项，且通联账户必须是允许提现的账户。

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 汇入金分账(100191)

3.6.5.1 接口功能

商户在收到汇入金通知后，可使用通知中的 BATCHID 值（即交易流水号）通过该接口发起分账交易。该接口对分账操作有严格限制，一笔汇入金仅能发起一次分账交易。分账交易存在时间限制，仅支持对一个月内的汇入金交易进行分账。

3.6.5.2 请求报文

接口

字段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 汇入金分账查询（100192）

3.6.6.1 接口功能

用于查询特定汇入金分账交易的相关信息，查询时需提供对应的汇入金流水号。
可通过接口返回的信息判断该笔汇入金分账交易是否存在，以及获取交易的返回码、错误文本等详情。

3.6.6 .2 请求报文

接口

字段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 .3 响应报文

只有当头部返回码为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年10月10日 16:59 1640 0 条评论 收藏文档