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

——API查询接口 （V6.0） 中国工商银行软件开发中心 Copyright Reserved 2005年8月 前 言 该文档说明了商户使用工行提供的API接口进行查询时的通信方式和需要上送的数据和工行返回信息的格式。 目 录 前 言 1 1．商户端的接口 3 1．1参数名及其内容列表 3 1．2一个链接例子 3 2．银行反馈信息的接口 4 1．商户端的接口 商户实现双向的ssl与工行服务器建立连接。建立ssl连接时使用商户的api证书（文件名类似****.e.****的软证书）。 之后商户必须将查询上送数据用工行规定的格式以Form提交方式中的Post方法，将数据提交到中国工商银行指定的API查询URL (https://*.*.*.*/servlet/ICBCINBSEBusinessServlet，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)。 1.1参数名及其内容列表 1.1.1 B2B订单交易状态查询的API接口 请求数据格式： 变量名称 变量命名 长度定义 说明 接口名称 APIName MAX (30) 必输，签名，上送“EAPI”，区别大小写！ 接口版本号 APIVersion =15 必输，签名,上送”001.001.001.001” 请求数据,xml包（格式见下） MerReqData 请求数据中的xml包格式（注意：xml包中所有字段都是必输项）： ?xml version=1.0 encoding=GBK standalone=no ? ICBCAPI in orderNum订单号/orderNum tranDate交易日期/ tranDate ShopCode商家号码/ShopCode ShopAccount商城账号/ShopAccount /in /ICBCAPI 返回数据格式 注意：返回数据是经过了url编码的。 查询b2b订单信息返回有两种格式，如果查询成功则返回是一个xml包，格式： ?xml version=1.0 encoding=GBK standalone=no ? ICBCAPI pub APIName接口名称/APIName APIVersion接口版本号/APIVersion /pub in orderNum订单号/orderNum tranDate交易日期/ tranDate ShopCode商家号码/ShopCode ShopAccount商城账号/ShopAccount /in out tranSerialNum指令序号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.2 B2C订单交易状态查询的API接口 请求数据格式： 变量名称 变量命名 长度定义 说明 接口名称 APIName MAX (30) 必输，签名，上送“EAPI”，区别大小写！ 接口版本号 APIVersion =15 必输，签名,上送”001.001.002.001” 请求数据,xml包（格式见下） MerReqData 请求数据中的xml包格式（注意：xml包中所有字段都是必输项）： ?xml version=1.0 encoding=GBK standalone=no ? ICBCAPI in orderNum订单号/orderNum tranDate交易日期/ tranDate ShopCode商家号码/ShopCode ShopAccount商城账号/ShopAccount /in /ICBCAPI 返回数据格式 注意：返回数据是经过了url编码的。 查询b2c订单信息返回有两种格式，如果查询成功则返回是一个xm