通联支付接口文档
- 格式:doc
- 大小:2.22 MB
- 文档页数:26
账户支付系统接口文档属性文档名称:账户支付系统接口当前版本号: 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.接口通讯 (3)1.1通讯方式 (3)1.1.1方式1 (3)1.2信息体说明 (3)1.2.1编码要求 (3)1.3安全 (3)2.交易报文 (3)2.1批量代收请求 (3)2.1.1请求报文说明 (3)2.1.2响应报文说明 (4)2.1.3例子 (5)2.2批量代付请求 (9)2.2.1请求报文说明 (9)2.2.2响应报文说明 (10)2.2.3例子 (10)2.3交易结果查询请求 (14)2.3.1请求报文说明 (15)2.3.2返回报文说明 (15)2.4交易结果通知 (16)2.4.1请求报文说明 (16)2.4.2返回报文说明 (16)2.5成功交易结果通知 (16)2.5.1请求报文说明 (16)2.5.2响应报文说明 (17)2.6退票通知 (17)2.6.1请求报文说明 (17)2.6.2响应报文说明 (17)2.7对账文件下载 (17)2.7.1请求报文说明 (17)2.7.2响应报文说明 (18)2.8简单对账文件下载 (18)2.8.1请求报文说明 (18)2.8.2响应报文说明 (18)2.9对账文件格式 (18)3.附录 (19)3.1代付业务代码 (19)3.2代收业务代码 (20)3.3银行代码 (21)3.4反馈代码表 (23)3.5中国邮政区号表 (26)3.6测试资料 (26)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/TRAN S_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/TRAN S_DETAILS /TRANS_DE TAIL 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_PR OP 账号属性 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_DET AILS/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>60138270140042110021</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>60138270140042110022</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>60138270140042110021</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>60138270140042110022</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><REQ_SN>2009041611084101</REQ_SN><RET_CODE>0000</RET_CODE><ERR_MSG/><SIGNED_MSG>签名信息</SIGNED_MSG> </INFO><BODY><RET_DETAILS><RET_DETAIL><SN>0001</SN><RET_CODE>0000</RET_CODE><ERR_MSG/></RET_DETAIL><RET_DETAIL><SN>0002</SN><RET_CODE>0000</RET_CODE><ERR_MSG/></RET_DETAIL></RET_DETAILS></BODY></AIPG><?xml version="1.0" encoding="GBK"?><AIPG><INFO><TRX_CODE>100001</TRX_CODE><VERSION>02</VERSION><DATA_TYPE>2</DATA_TYPE><REQ_SN>2009041611084101</REQ_SN><RET_CODE>0000</RET_CODE><ERR_MSG/></INFO><BODY><RET_DETAILS><RET_DETAIL><SN>0001</SN><RET_CODE>0000</RET_CODE><ERR_MSG/></RET_DETAIL><RET_DETAIL><SN>0002</SN><RET_CODE>0000</RET_CODE><ERR_MSG/></RET_DETAIL></RET_DETAILS></BODY></AIPG>2.2 批量代付请求2.2.1请求报文说明接口字段ID 字段名称类型取值可空备注INFO TRX_CODE 交易代码C(1, 20) 100002 否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 /TRA NS_S UM 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 /TRA NS_D ETAI LS/T RANS _DET AIL SN 记录序号C(1,4) 同一个请求内必须唯一。