中国工商银行网上银行系统
——API
查询接口
中国工商银行软件开发中心
Copyright Reserved
2005年8月
1.文档属性
2.文档变更历史清单
前言
该文档说明了商户使用工行提供的API接口进行b2b,b2c,c2c,电银b2c指令查询时的通信方式,需要上送的数据和工行返回信息的格式。
目录
前言 (1)
目录 (3)
1.商户端的接口 (4)
1.1参数名及其内容列表 (4)
1.1.1 B2B订单交易状态查询的API接口 (4)
1.1.1.1请求数据格式: (4)
1.1.1.2 返回数据格式 (4)
1.1.2 B2C订单交易状态查询的API接口 (5)
1.1.1.1请求数据格式: (5)
1.1.1.2 返回数据格式 (6)
1.1.3C2C订单交易状态查询的API接口 (6)
1.1.1.1请求数据格式: (6)
1.1.1.2 返回数据格式 (7)
1.1.4 电银B2C订单交易状态查询的API接口 (8)
1.1.1.1请求数据格式: (8)
1.1.1.2 返回数据格式 (8)
1.2一个链接例子 (9)
1.3注意事项 (9)
1.4错误代码含义 (10)
1.5指令状态含义 (10)
1.6商户端开发的例子 (11)
1.商户端的接口
商户实现双向的ssl与工行服务器建立连接。建立ssl连接时使用商户的api 证书(文件名类似****.e.****的软证书)。
之后商户必须用工行规定的格式以Form提交方式中的Post方法,将查询上送数据提交到中国工商银行指定的API查询URL (https://*.*.*.*/servlet/ICBCINBSEBusinessServlet,注意使用工行企业网银的地址,严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP 地址)。
1.1参数名及其内容列表
1.1.1 B2B订单交易状态查询的API接口
1.1.1.1请求数据格式:
请求数据中的xml包格式(注意:xml包中所有字段都是必输项):
1.1.1.2 返回数据格式
注意:返回数据是经过了url编码的。
查询b2b订单信息返回有两种格式,如果查询成功则返回是一个xml包,格式:
如果查询失败则返回只有五位错误码,含义可以见文档后面。1.1.2 B2C订单交易状态查询的API接口
1.1.1.1请求数据格式:
请求数据中的xml包格式(注意:xml包中所有字段都是必输项):
1.1.1.2 返回数据格式
注意:返回数据是经过了url编码的。
查询b2c订单信息返回有两种格式,如果查询成功则返回是一个xml包,格式:
如果查询失败则返回只有五位错误码,含义可以见文档后面。
1.1.3C2C订单交易状态查询的API接口
1.1.1.1请求数据格式:
请求数据中的xml包格式(注意:xml包中所有字段都是必输项):
1.1.1.2 返回数据格式
注意:返回数据是经过了url编码的。
查询c2c订单信息返回有两种格式,如果查询成功则返回是一个xml包,格式:
如果查询失败则返回只有五位错误码,含义可以见文档后面。
1.1.4 电银B2C订单交易状态查询的API接口
1.1.1.1请求数据格式:
请求数据中的xml包格式(注意:xml包中所有字段都是必输项):
1.1.1.2 返回数据格式
注意:返回数据是经过了url编码的。
查询b2c订单信息返回有两种格式,如果查询成功则返回是一个xml包,格式:
如果查询失败则返回只有五位错误码,含义可以见文档后面。
1.2一个链接例子
以下给出商户提交查询请求的例子(注意避免使用中文的全角符号)
1.3 注意事项
1.商城证书id对商城账号必须有查询权限。
2.请求数据中不要有多余的空格。
3.关于双向SSL的建立我们会提供java和.net的两个例子,开发时可以参
照。
4.从商户Post过来的数据,参数名的名称必须与接口表中完全相同,名称
中的字母大小写均要相同,不能进行随意更改(在form中的提交按钮
中submit不能有Name属性);此外,如
果其他input项的Name中使用了双引号,如:,
则一定注意在引号内不要包含空格,不要写成“Merchant URL ”或者“ Mer chantURL”。
5.要求商户使用字符集GBK。
6.注意请求地址以https开头
不编码也不会有问题)。
1.4 错误代码含义
40972A PI查询的订单不存在
40973A PI查询过程中系统异常
40976A PI查询系统异常
40977商户证书信息错
40978解包商户请求数据报错
40980A PI查询过程中系统异常
40981给商户打包返回数据错
40982系统错误
40983查询的订单不唯一
40987请求数据中接口名错误
40947商户代码或者商城账号有误
40948商城状态非法
40949商城类别非法
40950商城应用类别非法
40951商户证书id状态非法
40952商户证书id未绑定
40953商户id权限非法
40954检查商户状态时数据库异常
1.5指令状态含义
b2b
3:指令处理完成,转账成功
4:指令处理失败,转账未完成。
6:指令超过支付人的限额,正在等待主管会计批复。
7:指令超过支付人的限额,正在等待主管会计第二次批复。
8:指令超过支付人的限额,被主管会计否决。
9:银行正在处理(可疑)
b2c
0-支付成功,未清算
1-支付成功,已清算
2-支付失败
3-支付可疑交易
c2c
0-支付成功,未清算
1-支付成功,已清算
2-支付失败
3-支付可疑交易
电银b2c
0-支付成功,未清算
1-支付成功,已清算
2-支付失败
3-支付可疑交易
4-未支付
1.6商户端开发的例子
请参照”api查询接口开发的例子”目录下的内容,提供java和dotNet两种开发例子。