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

中国工商银行网上银行系统 ——API查询接口商户手册商户手册中国工商银行软件开发中心Copyright Reserved2005年8月 网上银行商户手册?Copyright ICBC SDC 2005.8 - PAGE 10 -文档属性文档属性内容文档名称：网上银行系统商户API查询接口手册文档版本号：1.1文档状态：正式稿文档编写完成日期2005-09文档变更历史清单文档版本号变更日期修改人变更内容简述1.12006-06-06解志超修正了文档的一些错误前 言 该文档说明了商户使用工行提供的API接口进行b2b,b2c,c2c,电银b2c指令查询时的通信方式，需要上送的数据和工行返回信息的格式。目 录 TOC \o 1-5 前 言 PAGEREF _Toc137374971 \h 1目 录 PAGEREF _Toc137374972 \h 21．商户端的接口 PAGEREF _Toc137374973 \h 31.1参数名及其内容列表 PAGEREF _Toc137374974 \h 31.1.1 B2B订单交易状态查询的API接口 PAGEREF _Toc137374975 \h 请求数据格式： PAGEREF _Toc137374976 \h 返回数据格式 PAGEREF _Toc137374977 \h 31.1.2 B2C订单交易状态查询的API接口 PAGEREF _Toc137374978 \h 请求数据格式： PAGEREF _Toc137374979 \h 返回数据格式 PAGEREF _Toc137374980 \h 51.1.3 C2C订单交易状态查询的API接口 PAGEREF _Toc137374981 \h 请求数据格式： PAGEREF _Toc137374982 \h 返回数据格式 PAGEREF _Toc137374983 \h 61.1.4 电银B2C订单交易状态查询的API接口 PAGEREF _Toc137374984 \h 请求数据格式： PAGEREF _Toc137374985 \h 返回数据格式 PAGEREF _Toc137374986 \h 71.2一个链接例子 PAGEREF _Toc137374987 \h 81.3 注意事项 PAGEREF _Toc137374988 \h 81.4 错误代码含义 PAGEREF _Toc137374989 \h 91.5指令状态含义 PAGEREF _Toc137374990 \h 91.6商户端开发的例子 PAGEREF _Toc137374995 \h 101．商户端的接口商户实现双向的ssl与工行服务器建立连接。建立ssl连接时使用商户的api证书（文件名类似****.e.****的软证书）。之后商户必须用工行规定的格式以Form提交方式中的Post方法，将查询上送数据提交到中国工商银行指定的API查询URL (https://*.*.*.*/servlet/ICBCINBSEBusinessServlet，注意使用工行企业网银的地址，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)。1.1参数名及其内容列表1.1.1 B2B订单交易状态查询的API接口请求数据格式：变量名称变量命名长度定义说明接口名称APINameMAX (30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.001.001”请求数据,xml包（格式见下）MerReqData请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：?xml version=1.0 encoding=GBK standalone=no ? ICBCAPI in orderNum订单号/orderNumtranDate交易日期/ tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount/in/ICBCAPI 返回数据格式注意：返回数据是经过了url编码的。查询b2b订单信息返回有两种格式，如果查询成功则返回是一个xml包，格式：?xml version=1.0 encoding=GBK standalone=no ? ICBCAPI pub APIName接口名称