网上银行系统商户API查询接口手册

1、 中国工商银行网上银行系统中国工商银行网上银行系统 APIAPI 查询接口查询接口（V6.0）中国工商银行软件开发中心中国工商银行软件开发中心Copyright Reserved2005 年年 8 月月商户手册 网上银行商户手册 v3.0Copyright ICBC SDC 2001.5 - 0 -前前 言言 该文档说明了商户使用工行提供的 API 接口进行查询时的通信方式和需要上送的数据和工行返回信息的格式。 网上银行商户手册 v3.0Copyright ICBC SDC 2001.5 - 1 -目目 录录前 言.11商户端的接口商户端的接口 .311 参数名及其内容列表.312 一个链接例

2、子.32银行反馈信息的接口银行反馈信息的接口 .4 网上银行商户手册 v3.0Copyright ICBC SDC 2001.5 - 2 -1商户端的接口商户端的接口商户实现双向的 ssl 与工行服务器建立连接。建立 ssl 连接时使用商户的api 证书（文件名类似*.e.*的软证书） 。之后商户必须将查询上送数据用工行规定的格式以 Form 提交方式中的 Post方法，将数据提交到中国工商银行指定的 API 查询 URL (https:/*.*.*.*/servlet/ICBCINBSEBusinessServlethttps:/*.*.*.*/servlet/ICBCINBSEBusine

3、ssServlet，严格区分大小写，严格区分大小写, ,请请联系所在地分行确认投产环境和测试环境的联系所在地分行确认投产环境和测试环境的 IPIP 地址地址)。1.1 参数名及其内容列表参数名及其内容列表1.1.1 B2B 订单交易状态查询的订单交易状态查询的 API 接口接口 请求数据格式：请求数据格式：变量名称变量名称变量命名变量命名长度定义长度定义说明说明接口名称APINameMAX (30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.001.001”请求数据,xml包（格式见下）MerReqDataMer

4、ReqData请求数据中的请求数据中的xmlxml包格式（注意：包格式（注意：xmlxml包中所有字段都是必输项）：包中所有字段都是必输项）： 订单号交易日期商家号码商城账号 返回数据格式返回数据格式注意：返回数据是经过了注意：返回数据是经过了 url 编码的。编码的。查询查询b2bb2b订单信息返回有两种格式，如果查询成功则返回是一个订单信息返回有两种格式，如果查询成功则返回是一个xmlxml包，格式：包，格式： 网上银行商户手册 v3.0Copyright ICBC SDC 2001.5 - 3 -接口名称接口版本号 订单号交易日期商家号码商城账号指令序号订单处理状态指令错误

5、信息订单总金额支付币种返回通知日期时间收款人账号收款人户名校验联名标志商城联名标志客户联名标志联名会员号商户签名证书id如果查询失败则返回只有五位错误码，含义可以见文档后面。如果查询失败则返回只有五位错误码，含义可以见文档后面。1.1.2 B2C 订单交易状态查询的订单交易状态查询的 API 接口接口 请求数据格式：请求数据格式：变量名称变量名称变量命名变量命名长度定义长度定义说明说明接口名称APINameMAX (30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.002.001”请求数据,xml包（格式见下）M

6、erReqDataMerReqData请求数据中的请求数据中的xmlxml包格式（注意：包格式（注意：xmlxml包中所有字段都是必输项）：包中所有字段都是必输项）： 订单号交易日期 网上银行商户手册 v3.0Copyright ICBC SDC 2001.5 - 4 -商家号码商城账号 返回数据格式返回数据格式注意：返回数据是经过了注意：返回数据是经过了 url 编码的。编码的。查询查询b2cb2c订单信息返回有两种格式，如果查询成功则返回是一个订单信息返回有两种格式，如果查询成功则返回是一个xmlxml包，格式：包，格式：接口名称接口版本号 订单号交易日期商家号码商城账号指令

7、序号订单处理状态指令错误信息订单总金额支付币种返回通知日期时间商城账号商城户名校验联名标志商城联名标志客户联名标志联名会员号商户签名证书id如果查询失败则返回只有五位错误码，含义可以见文档后面。如果查询失败则返回只有五位错误码，含义可以见文档后面。1.1.3 C2C 订单交易状态查询的订单交易状态查询的 API 接口接口 请求数据格式：请求数据格式：变量名称变量名称变量命名变量命名长度定义长度定义说明说明接口名称APINameMAX (30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.003.001” 网上银行商

8、户手册 v3.0Copyright ICBC SDC 2001.5 - 5 -请求数据,xml包（格式见下）MerReqDataMerReqData请求数据中的请求数据中的xmlxml包格式（注意：包格式（注意：xmlxml包中所有字段都是必输项）：包中所有字段都是必输项）： 订单号交易日期商家号码商城账号 返回数据格式返回数据格式注意：返回数据是经过了注意：返回数据是经过了 url 编码的。编码的。查询查询c2cc2c订单信息返回有两种格式，如果查询成功则返回是一个订单信息返回有两种格式，如果查询成功则返回是一个xmlxml包，格式：包，格式：接口名称接口版本号 订单号交易日期

9、商家号码商城账号指令序号订单处理状态指令错误信息订单总金额支付币种返回通知日期时间收款人账号收款人户名校验联名标志商城联名标志客户联名标志联名会员号卖家收款卡号卖家收款人户名 网上银行商户手册 v3.0Copyright ICBC SDC 2001.5 - 6 -商户签名证书id如果查询失败则返回只有五位错误码，含义可以见文档后面。如果查询失败则返回只有五位错误码，含义可以见文档后面。1.2 一个链接例子一个链接例子以下给出商户提交查询请求的例子（注意避免使用中文的全角符号）（form 不能有 name 属性，另外注意协议是 https）input type=hidden name=MerRe

10、qDataMerReqData value= 19821981200508160200EC000003210200029109000018680 1. 3 注意事项注意事项1. 商城证书 id 对商城账号必须有查询权限。2. 请求数据中不要有多余的空格。3. 关于双向 SSL 的建立我们会提供 java 和.net 的两个例子，开发时可以参照。4. 从商户 Post 过来的数据，参数名的名称必须与接口表中完全相同参数名的名称必须与接口表中完全相同，名名称中的字母大小写均要相同，不能进行随意更改称中的字母大小写均要相同，不能进行随意更改( (在在 formform 中的提交按钮中的提交按钮inp

11、uttype=”submit”中中 submitsubmit 不能有不能有 NameName 属性属性) )；此外，如果其他 inputinput 项的 Name 中使用了双引号，如：，则一定注意在引号内不要包含空格，不要写成“Merchant URL ”或者“ Mer chantURL” 。5. 要求商户使用字符集 GBK。6. 注意请求地址以 https 开头7. 注意对于请求中的 MerReqDataMerReqData 这项的值最好经过 URL 编码后再上送，否则对于一些特殊字符可能会被 URL 解码造成错误（就目前的包格式来看不编码也不会有问题）。 网上银行商户手册 v3.0Copy

12、right ICBC SDC 2001.5 - 7 -1.4 错误代码含义错误代码含义40972API 查询的订单不存在40973API 查询过程中系统异常40976API 查询系统异常40977商户证书信息错40978解包商户请求数据报错40979查询的订单不存在40980API 查询过程中系统异常40981给商户打包返回数据错40982系统错误40983查询的订单不唯一40987请求数据中接口名错误40947商户代码或者商城账号有误40948商城状态非法40949商城类别非法40950商城应用类别非法40951商户证书 id 状态非法40952商户证书 id 未绑定40953商户 id 权限非法40954检查商户状态时数据库异常1. 5 指令状态含义：指令状态含义：b2b3：指令处理完成，转账成功4：指令处理失败，转账未完成。6：指令超过支付人的限额，正在等待主管会计批复。7：指令超过支付人的限额，正在等待主管会计