网上银行系统商户b2b信用支付接口手册

1、 b2b信用支付接口商户手册中国工商银行软件开发中心Copyright Reserved2007年5月文档属性文档属性内容文档名称：网上银行系统商户b2b信用支付接口手册文档版本号：1.0文档状态：正式稿文档编写完成日期2007-5-23文档变更历史清单文档版本号变更日期修改人变更内容简述前 言 该文档说明了商户使用工行提供的API接口进行b2b信用支付一些相关交易时的通信方式，需要上送的数据和工行返回信息的格式。目 录 TOC o 1-5 前 言 PAGEREF _Toc167702607 h 2目 录 PAGEREF _Toc167702608 h 31商户端的接口 PAGEREF _To

2、c167702609 h 41.1参数名及其内容列表 PAGEREF _Toc167702610 h 4B2B信用支付-提前确认付款接口 PAGEREF _Toc167702611 h 15请求数据格式 PAGEREF _Toc167702612 h 15返回数据格式 PAGEREF _Toc167702613 h 16B2B信用支付-商城提交仲裁请求接口 PAGEREF _Toc167702614 h 19请求数据格式 PAGEREF _Toc167702615 h 19返回数据格式 PAGEREF _Toc167702616 h 21B2B信用支付-商城提交仲裁撤销接口 PAGEREF _

3、Toc167702617 h 24请求数据格式 PAGEREF _Toc167702618 h 24返回数据格式 PAGEREF _Toc167702619 h 25B2B信用支付-仲裁通知接口 PAGEREF _Toc167702620 h 28请求数据格式 PAGEREF _Toc167702621 h 28返回数据格式 PAGEREF _Toc167702622 h 30B2B信用支付-查询接口 PAGEREF _Toc167702623 h 33请求数据格式 PAGEREF _Toc167702624 h 33返回数据格式 PAGEREF _Toc167702625 h 34商户延长支

4、付到期日 PAGEREF _Toc167702626 h 37请求数据格式 PAGEREF _Toc167702627 h 37返回数据格式 PAGEREF _Toc167702628 h 39B2B信用支付-商城提交退款请求接口 PAGEREF _Toc167702629 h 42请求数据格式 PAGEREF _Toc167702630 h 42返回数据格式 PAGEREF _Toc167702631 h 43B2B信用支付-商城提交退款撤销接口 PAGEREF _Toc167702632 h 46请求数据格式 PAGEREF _Toc167702633 h 46返回数据格式 PAGEREF

5、 _Toc167702634 h 48B2B信用支付-退款通知接口 PAGEREF _Toc167702635 h 51请求数据格式 PAGEREF _Toc167702636 h 51返回数据格式 PAGEREF _Toc167702637 h 531.2一个链接例子 PAGEREF _Toc167702638 h 561.3签名部分的说明 PAGEREF _Toc167702639 h 561.4银行反馈信息的接口 PAGEREF _Toc167702640 h 57通知消息接口数据格式 PAGEREF _Toc167702641 h 58通知消息处理过程 PAGEREF _Toc1677

6、02642 h 601.5 注意事项 PAGEREF _Toc167702643 h 621.6 错误代码含义 PAGEREF _Toc167702644 h 631.7指令状态含义 PAGEREF _Toc167702645 h 631.8商户端开发的例子 PAGEREF _Toc167702646 h 641商户端的接口商户端接口分为两种，一种是非api接口，这类接口的入口是/servlet/ICBCINBSCreditPayCustReqServlet；一种是api接口，这类接口的入口是/servlet/ICBCINBSCreditPayReqServlet。非api接口比较少，已经在交

7、易中标明，未标明的都是api接口，请根据标注选择对应的入口地址。对于非api接口，商户将请求数据提交到指定地址即可。对于api接口，商户需要实现双向的ssl与工行服务器建立连接，发送请求数据并接收银行的返回数据。建立ssl连接时使用商户的api证书（文件名类似*.e.*的软证书）。指定url的格式：https:/*.*.*.*/入口servlet，（注意使用工行企业网银的地址，请联系所在地分行确认投产环境和测试环境的IP地址）。1.1参数名及其内容列表B2B信用支付-交易请求接口(非api)请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示ba

8、se64编码的xml格式的字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=26必输，取值：“ICBC_CORPORBANK_CREDIT_PREPARE_PAY”接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输，唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间me

9、rTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输， 固定上送2卖家账号sellerAcctMAX(19)必输， 卖家户名sellerNameMAX(60)必输， 注意是60字节商户手续费入账账号merAcctNumMAX(19)必输， 手续费入账账户户名merAcctNameMAX(60)必输， 订单金额AmountMAX(10)必输， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种curr

10、TypeMAX(3)默认人民币“001”有效期长度orderPeriodMAX(4)由于商户和银行存在时间差，要求商户提交有效期长度，银行根据自己时间计算到期日单位小时最小值：24小时最大值：360小时，即15天已含运费金额carriageAmtMAX(18)选输以分为单位商品名称goodsNameMAX(60)选输单位字节商品编号goodsNoMAX(30)选输单位字节商品数量goodsNumMAX(10)选输单位字节买家手机号码buyerPhoneNum=11选输支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum=11选输支持移动、联通手机接收交易成功通知接收支付结

11、果信息通知程序地址merURLMAX (200)必输，（注意需要写上“http:/”）订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。Xml格式说明：格式一定，允许空值；接口名称接口版本号订单号订单金额币种订单日期时间有效期长度卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名检验联名标志已含运费金额商品名称商品编号商品数量买家手机号码卖家手机号码接收支付结

12、果信息通知程序地址订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&merTranTime =&orderPeriod=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&verifyJoinFlag=&merURL=非api接口没有返回。B2B信用支付-交易指定ID方式请求接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml

13、格式的字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=26必输，取值：“ICBC_CORPORBANK_CREDIT_APPOINTID_PAY”接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输，唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merTranTim

14、e=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输， 固定上送2卖家账号sellerAcctMAX(19)必输， 卖家户名sellerNameMAX(60)必输， 注意是60字节商户手续费入账账号merAcctNumMAX(19)必输， 手续费入账账户户名merAcctNameMAX(60)必输， 订单金额AmountMAX(10)必输， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX(

15、3)默认人民币“001”有效期长度orderPeriodMAX(4)由于商户和银行存在时间差，要求商户提交有效期长度，银行根据自己时间计算到期日单位小时最小值：24小时最大值：360小时，即15天指定付款idpayIdMAX(24)指定的企业网银付款id，只有这个id能对这笔订单进行支付已含运费金额carriageAmtMAX(18)选输以分为单位商品名称goodsNameMAX(60)选输单位字节商品编号goodsNoMAX(30)选输单位字节商品数量goodsNumMAX(10)选输单位字节商户提示merHintMAX(120)选输单位字节买家手机号码buyerPhoneNum=11选输支

16、持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum=11选输支持移动、联通手机接收交易成功通知接收支付结果信息通知程序地址merURLMAX (200)必输，（注意需要写上“http:/”）返回商户地址backMerURL必输，交易结束返回商户URL，完成闭环返回商户数据backMerData必输，交易结束返回商户URL时，post的保留数据（可用做维护原有商户端session）订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无

17、限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。Xml格式说明：格式一定，允许空值；接口名称接口版本号订单号订单金额币种订单日期时间有效期长度指定付款id 卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名检验联名标志已含运费金额商品名称商品编号商品数量买家手机号码卖家手机号码接收支付结果信息通知程序地址订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&merTranTime =&orderPeriod=&payId=

18、&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&verifyJoinFlag=&merURL=返回数据格式注意：返回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersi

19、on=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-超期订单付款接口请求数据格式使用form方式提交，提交数

20、据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=34必输， 取值：ICBC_CORPORBANK_CREDIT_OVERDUE_PAY接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户

21、的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。商户收费金额feeAmtMAX(10)必输， 可为零，以分为单位，必需符合金额标准。订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商

22、户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。接口名称接口版本号订单号商户收费金额订单日期时间交易日期时间商户代码订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&feeAmt=&merOrderTime=&merTranTime=&merID=返回数据格式注意：返回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手

23、续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&reques

24、tType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-提前确认付款接口（非api）请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=32必输值：”ICBC_CORPORBANK_CREDIT_AHEAD_PAY”接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输，

25、 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。商户收费金额feeAmtMAX(10)必输， 可为零，以分为单位，必需符合金额标准。订单签名数据merS

26、ignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户收费金额商户代码订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&feeA

27、mt=&merID=非api接口没有返回。B2B信用支付-商城提交仲裁请求接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“”订单号OrderedMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来

28、唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。处理动作refundAction必输， 0申请退款1撤消退款2同意退款3拒绝退款4仲裁申请5撤消仲裁6同意退款仲裁7拒绝退款仲裁处理金额refundAmtMAX(10)必输， 单位：分处理描述refundAct

29、ionMsgMAX(200)选输注意最大200字节订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。请求数据中的xml包格式（注意：xml包中除refundActionMsg外的其它字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户代码处理动作处理金额处理描述订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=

30、&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=&refundAction=&refundAmt=&refundActionMsg=返回数据格式变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔

31、订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(60)商户手续费入账账号merAcctNumMAX(19)手续费入账账户户名merAcctNameMAX(19)订单金额amountMAX(10)客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX（3）币种接收通知消息的地址merURLMAX（20

32、0）商户收费金额feeAmtMAX(10)有效期orderExpireMAX(14)YYYYDDMMhhmmss订单状态orderStateMAX(2)0资金银行监管中1交易失败2等待银行资金监管3清算成功4清算失败5等待银行清算6交易取消7申请退款8退款处理中9申请仲裁10仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家手机号码buyerPhoneNum11支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum11支持移动、联通手机接收交易

33、成功通知银行通知时间BankNotifyTimeMAX(14)YYYYMMDDhhmmss银行签名数据bankSignMsg无限制（格式单独说明）请求类型requestTypeMAX(2)0买家第一次支付1买家提前支付2超期商户支付3商户延期支付到期日4买家退款申请5买家撤消退款申请6卖家确认退款7买家商户端仲裁申请8买家商户端撤消仲裁申请9买家银行端仲裁申请10买家银行端撤消仲裁申请11商户确认仲裁12商户查询订单13银行端向买家退款14银行端向卖家付款15 银行端支付订单请求结果requestResultMAX(1)0成功1失败2等待处理3待授权错误描述ErrMsgMAX(200)注意：返

34、回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTi

35、me=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-商城提交仲裁撤销接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称inte

36、rfaceName=29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“”订单号OrderedMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YY

37、YYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。处理动作refundAction必输， 0申请退款1撤消退款2同意退款3拒绝退款4仲裁申请5撤消仲裁6同意退款仲裁7拒绝退款仲裁处理金额refundAmtMAX(10)必输， 单位：分处理描述refundActionMsgMAX(200)注意最大200字节订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行B

38、ASE64编码后产生的字符串。请求数据中的xml包格式（注意：xml包中除refundActionMsg外的其它字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户代码处理动作处理金额处理描述订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=&refundAction=&refundAmt=&refundActionMsg=返回数据格式变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=

39、29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(

40、60)商户手续费入账账号merAcctNumMAX(19)手续费入账账户户名merAcctNameMAX(19)订单金额amountMAX(10)客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX（3）币种接收通知消息的地址merURLMAX（200）商户收费金额feeAmtMAX(10)有效期orderExpireMAX(14)YYYYDDMMhhmmss订单状态orderStateMAX(2)0资金银行监管中1交易失败2等待银行资金监管3清算成功4清算失败5等待银行清算6交易取消7申请退款8退款处理中9申请仲裁10仲裁处理中是否退款标志

41、refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家手机号码buyerPhoneNum11支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum11支持移动、联通手机接收交易成功通知银行通知时间BankNotifyTimeMAX(14)YYYYMMDDhhmmss银行签名数据bankSignMsg无限制（格式单独说明）请求类型requestTypeMAX(2)0买家第一次支付1买家提前支付2超期商户支付3商户延期支付到期日4买家退款申请5买家撤消退款申请6卖家确认退款

42、7买家商户端仲裁申请8买家商户端撤消仲裁申请9买家银行端仲裁申请10买家银行端撤消仲裁申请11商户确认仲裁12商户查询订单13银行端向买家退款14银行端向卖家付款15 银行端支付订单请求结果requestResultMAX(1)0成功1失败2等待处理3待授权错误描述ErrMsgMAX(200)注意：返回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知

43、消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum

44、=&sellerPhoneNum=&merURL=B2B信用支付-仲裁通知接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“”订单号OrderedMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来

45、唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。处理动作refundAction必输， 0申请退款1撤消退款2同意退款3拒绝退款4仲裁申请5撤消仲裁6同意退款仲裁7拒绝退款仲裁处理金额refundAmtMAX(10)必输， 单位：分处理描述refundAct

46、ionMsgMAX(200)注意最大200字节订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。请求数据中的xml包格式（注意：xml包中除refundActionMsg外的其它字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户代码处理动作处理金额处理描述订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&i

47、nterfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=&refundAction=&refundAmt=&refundActionMsg=返回数据格式变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单

48、的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(60)商户手续费入账账号merAcctNumMAX(19)手续费入账账户户名merAcctNameMAX(19)订单金额amountMAX(10)客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX（3）币种接收通知消息的地址merURLMAX（200）

49、商户收费金额feeAmtMAX(10)有效期orderExpireMAX(14)YYYYDDMMhhmmss订单状态orderStateMAX(2)0资金银行监管中1交易失败2等待银行资金监管3清算成功4清算失败5等待银行清算6交易取消7申请退款8退款处理中9申请仲裁10仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家手机号码buyerPhoneNum11支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum11支持移动、联通手机接收交易成功

50、通知银行通知时间BankNotifyTimeMAX(14)YYYYMMDDhhmmss银行签名数据bankSignMsg无限制（格式单独说明）请求类型requestTypeMAX(2)0买家第一次支付1买家提前支付2超期商户支付3商户延期支付到期日4买家退款申请5买家撤消退款申请6卖家确认退款7买家商户端仲裁申请8买家商户端撤消仲裁申请9买家银行端仲裁申请10买家银行端撤消仲裁申请11商户确认仲裁12商户查询订单13银行端向买家退款14银行端向卖家付款15 银行端支付订单请求结果requestResultMAX(1)0成功1失败2等待处理3待授权错误描述ErrMsgMAX(200)注意：返回数

51、据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime

52、=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-查询接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceNam

53、e=34必输取值：“ICBC_CORPORBANK_CREDIT_ORDER_QUERY”接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss提交订单时商户端时间交易日期时间merTranTime=14必输， 格式为：YYYY

54、MMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户代码订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfac

55、eVersion=&orderID=&merOrderTime=&merTranTime=&merID=返回数据格式变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=34必输取值：“ICBC_CORPORBANK_CREDIT_ORDER_QUERY”接口版本号interfaceVersion=7必输， 取值：“”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开

56、户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(60)商户手续费入账账号merAcctNumMAX(19)手续费入账账户户名merAcctNameMAX(19)订单金额amountMAX(10)客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX（3）币种接收通知消息的地址merURLMAX（200）商户收费金额feeAmtMAX(10)有效期orderExpireMAX(14)YYYY

57、DDMMhhmmss订单状态orderStateMAX(2)0资金银行监管中1交易失败2等待银行资金监管3清算成功4清算失败5等待银行清算6交易取消7申请退款8退款处理中9申请仲裁10仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家手机号码buyerPhoneNum11支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum11支持移动、联通手机接收交易成功通知银行通知时间BankNotifyTimeMAX(14)YYYYMMDDhhmmss银

58、行签名数据bankSignMsg无限制（格式单独说明）请求类型requestTypeMAX(2)0买家第一次支付1买家提前支付2超期商户支付3商户延期支付到期日4买家退款申请5买家撤消退款申请6卖家确认退款7买家商户端仲裁申请8买家商户端撤消仲裁申请9买家银行端仲裁申请10买家银行端撤消仲裁申请11商户确认仲裁12商户查询订单13银行端向买家退款14银行端向卖家付款15 银行端支付订单请求结果requestResultMAX(1)0成功1失败2等待处理3待授权错误描述ErrMsgMAX(200)注意：返回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商

59、户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&se

60、llerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-商户延长支付到期日接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=34必输， 取值：ICBC_CORPORBANK_CREDIT_DEF