账户支付系统接口
文档属性
文档名称： | 账户支付系统接口 | ||
当前版本号： | 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 | 纸嫁衣4版本 | 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> |
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论