——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 (*.*.*.*/servlet/ICBCINBSEBusinessServlet，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)。
1.1参数名及其内容列表
1.1.1 B2B订单交易状态查询的API接口
1.1.1.1请求数据格式：
变量名称
变量命名
长度定义
说明
接口名称
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>
1.1.1.2 返回数据格式
注意：返回数据是经过了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>商户签名证书id<CertID/>
</out>
    </ICBCAPI>
如果查询失败则返回只有五位错误码，含义可以见文档后面。
1.1.2 B2C订单交易状态查询的API接口
1.1.1.1请求数据格式：
变量名称
变量命名
长度定义
说明
接口名称
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>
1.1.1.2 返回数据格式
注意：返回数据是经过了url编码的。
查询b2c订单信息返回有两种格式，如果查询成功则返回是一个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/>
<ShopAccount>商城账号<ShopAccount/>
<PayeeName>商城户名<PayeeName/>
<JoinFlag>校验联名标志<JoinFlag/>
<MerJoinFlag>商城联名标志<MerJoinFlag/>
<CustJoinFlag>客户联名标志<CustJoinFlag/>
<CustJoinNum>联名会员号<CustJoinNum/>
<CertID>商户签名证书id<CertID/>
</out>
    </ICBCAPI>
如果查询失败则返回只有五位错误码，含义可以见文档后面。
1.1.3 C2C订单交易状态查询的API接口
1.1.1.1请求数据格式：
变量名称
变量命名
长度定义
说明
接口名称
APIName
MAX (30)
必输，签名，上送“EAPI”，区别大小写！
接口版本号
APIVersion
=15
必输，签名,上送”001.001.003.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>
1.1.1.2 返回数据格式
注意：返回数据是经过了url编码的。
查询c2c订单信息返回有两种格式，如果查询成功则返回是一个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/>百度api接口
<PayeeName>收款人户名<PayeeName/>
<JoinFlag>校验联名标志<JoinFlag/>
<MerJoinFlag>商城联名标志<MerJoinFlag/>
<CustJoinFlag>客户联名标志<CustJoinFlag/>
<CustJoinNum>联名会员号<CustJoinNum/>
<SellCardNo>卖家收款卡号<SellCardNo/>
<SellAcctName>卖家收款人户名<SellAcctName/>
<CertID>商户签名证书id<CertID/>
</out>
    </ICBCAPI>

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。