账户支付系统接口
文档属性
文档名称：
账户支付系统接口
当前版本号：
1.37
创建者：
创建日期：
复核者：
复核日期：
审批者：
审批日期：
修改记录：
版本
修改内容
修改人
日期
1.00
创建
王作林
1.10
规范XML的节点
王作林
2009-10-12
1.15
完善签约的协议
王作林
2010-6-11
1.36
增加有磁有密签到
王作林
2010-8-10
1.37
签约查询响应及签约通知增加户名
王作林
2010-11-12
1.接口通讯
1.1通讯方式
1.1.1方式1
使用HTTPS作为通讯方式，报文格式为XML。
1.2信息体说明
1.2.1编码要求
本系统报文接口数据使用的是GBK编码。
<?xml version="1.0" encoding="GBK"?>
1.3安全
通讯使用HTTPS进行通讯，交易内容使用数字证书进行签名。
2.交易报文
2.1批量代收请求
2.1.1请求报文说明
张杨一纯路上行人欲断魂是什么意思
接口
字段ID
字段名称
左小青老公类型
取值
可空
备注
INFO
TRX_CODE
交易代码
C(1, 20)
100001
否
VERSION
版本
C(2)
03
否
DATA_TYPE
数据格式
N(1)
2：xml格式
否
LEVEL
处理级别
N(1)
0-9  0优先级最低，默认为5
否
USER_NAME
用户名
C(1,20)
否
USER_PASS
用户密码
否
REQ_SN
交易批次号
C(40)
否
不重复流水
SIGNED_MSG
签名信息
C
否
BODY/TRANS_SUM
BUSINESS_CODE
业务代码
C(6)
见附录4.2
非空
MERCHANT_ID
商户代码
C(10)
商户ID
非空
SETTDAY
清算日期
C(8)
仅供特殊商户使用
可空
不推荐使用
SUBMIT_TIME
提交时间
C (14)
YYYYMMDDHHMMSS
非空
TOTAL_ITEM
总记录数
N (1,4)
非空
TOTAL_SUM
总金额
N (1,12)
整数，单位分
非空
BODY/TRANS_DETAILS/TRANS_DETAIL
SN
记录序号
C(1,4)
同一个请求内必须唯一。建议从0001开始递增
非空
E_USER_CODE
用户编号
C(1,20)
客户编号
可空
BANK_CODE
银行代码
C(3)
3位的银行代码，见附录4.3
非空
ACCOUNT_TYPE
账号类型
C(2)
00银行卡，01存折，02信用卡。不填默认为银行卡00。
可空
ACCOUNT_NO
账号
N(1,32)
银行卡或存折号码
非空
ACCOUNT_NAME
账号名
C(1,60)
银行卡或存折上的所有人姓名。
非空
PROVINCE
开户行所在省
C (1,20)
不带“省”或“自治区”，如 广东，广西，内蒙古等。
建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。
可空
CITY
开户行所在市
C (1,20)
不带“市”，如 广州，南宁等。
如果是直辖市，则填区，如北京（市）朝阳（区）。
建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。
可空
BANK_NAME
开户行名称
C (1,60)
开户行详细名称，也叫网点，如 中国建设银行广州东山广场分理处。
可空
ACCOUNT_PROP
账号属性
C (1)
0私人，1公司。不填时，默认为私人0。
非空
AMOUNT
金额
N(1,12)
整数，单位分
非空
CURRENCY
货币类型
C (3)
人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。
可空
PROTOCOL
协议号
C (1,60)
可空
PROTOCOL_USERID
协议用户编号
C (1,30)
可空
ID_TYPE
开户证件类型
C (1)
0：身份证,1: 户口簿，2：护照,3.军官证,4.士兵证，5. 港澳居民来往内地通行证,6. 台湾同胞来往内地通行证,7. 临时身份证,8. 外国人居留证,9. , X.其他证件
可空
ID
证件号
C (1,22)
可空
TEL
手机号/小灵通
C (1,13)
小灵通带区号，不带括号，减号
可空
CUST_USERID
马可花千骨自定义用户号
C (0,128)
商户自定义的用户号， 用户号要唯一。
可空
SETTACCT
本交易结算户
C(1,32)
结算到商户的账户，不需分别清算时不需填写。
可空
REMARK
备注
C (1,50)
供商户填入参考信息。若为信用卡，填有效期
可空
数字签名原文为没有SIGNED_MSG    签名信息项的xml全文。
2.1.2响应报文说明
交易名称
支付经办
报文类型
响应报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
TRX_CODE
交易代码
C(1, 20)
100001
否
VERSION
版本
C(2)
03
否
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_DETAILS
SN
记录序号
C(4)
可
RET_CODE
返回码
C(4)
本响应码一般为提交成功的中间状态
可
ERR_MSG
错误文本
C(1,256)
可
数字签名原文为没有SIGNED_MSG    签名信息项的xml全文。
感谢信范文
2.1.3例子
请求
<?xml version="1.0" encoding="GBK"?>
<AIPG>
    <INFO>
        <TRX_CODE>100001</TRX_CODE>
        <VERSION>02</VERSION>
        <DATA_TYPE>2</DATA_TYPE>
        <LEVEL>0</LEVEL>
        <USER_NAME>test</USER_NAME>
        <USER_PASS>test</USER_PASS>
        <REQ_SN>2009041611084101</REQ_SN>
        <SIGNED_MSG>签名信息</SIGNED_MSG>
    </INFO>
    <BODY>
        <TRANS_SUM>
            <BUSINESS_CODE>00600</BUSINESS_CODE>
            <MERCHANT_ID>0010530001</MERCHANT_ID>
            <SUBMIT_TIME>20090416120000</SUBMIT_TIME>
            <TOTAL_ITEM>2</TOTAL_ITEM>
            <TOTAL_SUM>2</TOTAL_SUM>
        </TRANS_SUM>
        <TRANS_DETAILS>
            <TRANS_DETAIL>
                <SN>0001</SN>
                <E_USER_CODE/>
                <BANK_CODE>105</BANK_CODE>
                <ACCOUNT_TYPE>00</ACCOUNT_TYPE>
                <ACCOUNT_NO>601382**********</ACCOUNT_NO>
                <ACCOUNT_NAME>张三</ACCOUNT_NAME>
                <PROVINCE>广东</PROVINCE>
                <CITY>广州</CITY>
                <BANK_NAME>建行</BANK_NAME>
                <ACCOUNT_PROP>0</ACCOUNT_PROP>
                <AMOUNT>1</AMOUNT>
                <CURRENCY>CNY</CURRENCY>
                <PROTOCOL/>
                <PROTOCOL_USERID/>
                <ID_TYPE/>
                <ID/>
                <TEL/>
                <CUST_USERID/>
                <REMARK>保险理赔</REMARK>
            </TRANS_DETAIL>
            <TRANS_DETAIL>
                <SN>0002</SN>
                <E_USER_CODE/>
                <BANK_CODE>105</BANK_CODE>
                <ACCOUNT_TYPE>00</ACCOUNT_TYPE>
                <ACCOUNT_NO>601382**********</ACCOUNT_NO>
                <ACCOUNT_NAME>李四</ACCOUNT_NAME>
                <PROVINCE>广东</PROVINCE>
                <CITY>广州</CITY>
                <BANK_NAME>建行</BANK_NAME>
                <ACCOUNT_PROP>0</ACCOUNT_PROP>
                <AMOUNT>1</AMOUNT>
                <CURRENCY>CNY</CURRENCY>
                <PROTOCOL/>
                <PROTOCOL_USERID/>
                <ID_TYPE/>
                <ID/>
                <TEL/>
                <CUST_USERID/>
                <REMARK>保险理赔</REMARK>
            </TRANS_DETAIL>
        </TRANS_DETAILS>
    </BODY>
围棋有多少个交叉点</AIPG>
请求信息签名原文
<?xml version="1.0" encoding="GBK"?>
<AIPG>
    <INFO>
        <TRX_CODE>100001</TRX_CODE>
        <VERSION>02</VERSION>
        <DATA_TYPE>2</DATA_TYPE>
        <LEVEL>0</LEVEL>
        <USER_NAME>test</USER_NAME>
        <USER_PASS>test</USER_PASS>
        <REQ_SN>2009041611084101</REQ_SN>
    </INFO>
    <BODY>
        <TRANS_SUM>
            <BUSINESS_CODE>00600</BUSINESS_CODE>
            <MERCHANT_ID>0010530001</MERCHANT_ID>
            <SUBMIT_TIME>20090416120000</SUBMIT_TIME>
            <TOTAL_ITEM>2</TOTAL_ITEM>
            <TOTAL_SUM>2</TOTAL_SUM>
        </TRANS_SUM>
        <TRANS_DETAILS>
            <TRANS_DETAIL>
                <SN>0001</SN>
                <E_USER_CODE/>
                <BANK_CODE>105</BANK_CODE>
                <ACCOUNT_TYPE>00</ACCOUNT_TYPE>
                <ACCOUNT_NO>601382**********</ACCOUNT_NO>
                <ACCOUNT_NAME>张三</ACCOUNT_NAME>
                <PROVINCE>广东</PROVINCE>
                <CITY>广州</CITY>
                <BANK_NAME>建行</BANK_NAME>
                <ACCOUNT_PROP>0</ACCOUNT_PROP>
                <AMOUNT>1</AMOUNT>
                <CURRENCY>CNY</CURRENCY>
                <PROTOCOL/>
                <PROTOCOL_USERID/>
                <ID_TYPE/>
                <ID/>
                <TEL/>
                <CUST_USERID/>
                <REMARK>保险理赔</REMARK>
            </TRANS_DETAIL>
            <TRANS_DETAIL>
                <SN>0002</SN>
                <E_USER_CODE/>
                <BANK_CODE>105</BANK_CODE>
                <ACCOUNT_TYPE>00</ACCOUNT_TYPE>
                <ACCOUNT_NO>601382**********</ACCOUNT_NO>
                <ACCOUNT_NAME>李四</ACCOUNT_NAME>
                <PROVINCE>广东</PROVINCE>
                <CITY>广州</CITY>
                <BANK_NAME>建行</BANK_NAME>
                <ACCOUNT_PROP>0</ACCOUNT_PROP>
                <AMOUNT>1</AMOUNT>
                <CURRENCY>CNY</CURRENCY>
                <PROTOCOL/>
                <PROTOCOL_USERID/>
                <ID_TYPE/>
                <ID/>
                <TEL/>
                <CUST_USERID/>
                <REMARK>保险理赔</REMARK>
            </TRANS_DETAIL>
        </TRANS_DETAILS>
    </BODY>
</AIPG>