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

中国工商银行网上银行系统——API查询接口（V6.0）中国工商银行软件开发中心CopyrightReserved2005年8月商户手册网上银行商户手册v3.0©CopyrightICBCSDC2001.5-1-前言该文档说明了商户使用工行提供的API接口进行查询时的通信方式和需要上送的数据和工行返回信息的格式。网上银行商户手册v3.0©CopyrightICBCSDC2001.5-2-目录前言...............................................................................................................................................11．商户端的接口....................................................................................................................................31．1参数名及其内容列表.................................................................................................................31．2一个链接例子.............................................................................................................................72．银行反馈信息的接口.........................................................................................错误!未定义书签。网上银行商户手册v3.0©CopyrightICBCSDC2001.5-3-1．商户端的接口商户实现双向的ssl与工行服务器建立连接。建立ssl连接时使用商户的api证书（文件名类似****.e.****的软证书）。之后商户必须将查询上送数据用工行规定的格式以Form提交方式中的Post方法，将数据提交到中国工商银行指定的API查询URL(https://*.*.*.*/servlet/ICBCINBSEBusinessServlet，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)。1.1参数名及其内容列表1.1.1B2B订单交易状态查询的API接口1.1.1.1请求数据格式：变量名称变量命名长度定义说明接口名称APINameMAX(30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.001.001”请求数据,xml包（格式见下）MerReqData请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIinorderNum订单号/orderNumtranDate交易日期/tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount/in/ICBCAPI1.1.1.2返回数据格式注意：返回数据是经过了url编码的。查询b2b订单信息返回有两种格式，如果查询成功则返回是一个xml包，格式：?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIpub网上银行商户手册v3.0©CopyrightICBCSDC2001.5-4-APIName接口名称/APINameAPIVersion接口版本号/APIVersion/pubinorderNum订单号/orderNumtranDate交易日期/tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount/inouttranSerialNum指令序号tranSerialNum/tranStat订单处理状态tranStat/bankRem指令错误信息bankRem/amount订单总金额amount/currType支付币种currType/tranTime返回通知日期时间tranTime/PayeeAcct收款人账号PayeeAcct/PayeeName收款人户名PayeeName/JoinFlag校验联名标志JoinFlag/MerJoinFlag商城联名标志MerJoinFlag/CustJoinFlag客户联名标志CustJoinFlag/CustJoinNum联名会员号CustJoinNum/CertID商户签名证书idCertID//out/ICBCAPI如果查询失败则返回只有五位错误码，含义可以见文档后面。1.1.2B2C订单交易状态查询的API接口1.1.1.1请求数据格式：变量名称变量命名长度定义说明接口名称APINameMAX(30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.002.001”请求数据,xml包（格式见下）MerReqData请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIinorderNum订单号/orderNumtranDate交易日期/tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount网上银行商户手册v3.0©CopyrightICBCSDC2001.5-5-/in/ICBCAPI1.1.1.2返回数据格式注意：返回数据是经过了url编码的。查询b2c订单信息返回有两种格式，如果查询成功则返回是一个xml包，格式：?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIpubAPIName接口名称/APINameAPIVersion接口版本号/APIVersion/pubinorderNum订单号/orderNumtranDate交易日期/tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount/inouttranSerialNum指令序号tranSerialNum/tranStat订单处理状态tranStat/bankRem指令错误信息bankRem/amount订单总金额amount/currType支付币种currType/tranTime返回通知日期时间tranTime/ShopAccount商城账号ShopAccount/PayeeName商城户名PayeeName/JoinFlag校验联名标志JoinFlag/MerJoinFlag商城联名标志MerJoinFlag/CustJoinFlag客户联名标志CustJoinFlag/CustJoinNum联名会员号CustJoinNum/CertID商户签名证书idCertID//out/ICBCAPI如果查询失败则返回只有五位错误码，含义可以见文档后面。1.1.3C2C订单交易状态查询的API接口1.1.1.1请求数据格式：变量名称变量命名长度定义说明接口名称APINameMAX(30)必输，签名，上送“EAPI”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.003.001”请求数据,xml包（格式见下）MerReqData网上银行商户手册v3.0©CopyrightICBCSDC2001.5-6-请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIinorderNum订单号/orderNumtranDate交易日期/tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount/in/ICBCAPI1.1.1.2返回数据格式注意：返回数据是经过了url编码的。查询c2c订单信息返回有两种格式，如果查询成功则返回是一个xml包，格式：?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIpubAPIName接口名称/APINameAPIVersion接口版本号/APIVersion/pubinorderNum订单号/orderNumtranDate交易日期/tranDateShopCode商家号码/ShopCodeShopAccount商城账号/ShopAccount/inouttranSerialNum指令序号tranSerialNum/tranStat订单处理状态tranStat/bankRem指令错误信息bankRem/amount订单总金额amount/currType支付币种currType/tranTime返回通知日期时间tranTime/PayeeAcct收款人账号PayeeAcct/PayeeName收款人户名PayeeName/JoinFlag校验联名标志JoinFlag/MerJoinFlag商城联名标志MerJoinFlag/CustJoinFlag客户联名标志CustJoinFlag/CustJoinNum联名会员号CustJoinNum/SellCardNo卖家收款卡号SellCardNo/SellAcctName卖家收款人户名SellAcctName/CertID商户签名证书idCertID//out/ICBCAPI网上银行商户手册v3.0©CopyrightICBCSDC2001.5-7-如果查询失败则返回只有五位错误码，含义可以见文档后面。1.2一个链接例子以下给出商户提交查询请求的例子（注意避免使用中文的全角符号）Formid=form1action=https://*.*.*.*/servlet/ICBCINBSEBusinessServletmethod=post（form不能有name属性，另外注意协议是https）inputtype=hiddenname=APINamevalue=EAPIinputtype=hiddenname=APIVersionvalue=001.001.001.001inputtype=hiddenname=MerReqDatavalue=?xmlversion=1.0encoding=GBKstandalone=no?ICBCAPIinorderNum19821981/orderNumtranDate20050816/tranDateShopCode0200EC00000