版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
—b2b信用支付接口商户手册商户手册中国工商银行软件开发中心CopyrightReserved2007年5月文档属性文档属性内容文档名称:网上银行系统商户b2b信用支付接口手册文档版本号:文档状态:正式稿文档编写完成日期2007-5-23文档变更历史清单文档版本号变更日期修改人变更内容简述
前言该文档说明了商户使用工行提供的API接口进行b2b信用支付一些相关交易时的通信方式,需要上送的数据和工行返回信息的格式。
目录TOC\o"1-5"前言 2目录 31.商户端的接口 4参数名及其内容列表 4B2B信用支付-提前确认付款接口 15请求数据格式 15返回数据格式 16B2B信用支付-商城提交仲裁请求接口 19请求数据格式 19返回数据格式 21B2B信用支付-商城提交仲裁撤销接口 24请求数据格式 24返回数据格式 25B2B信用支付-仲裁通知接口 28请求数据格式 28返回数据格式 30B2B信用支付-查询接口 33请求数据格式 33返回数据格式 34商户延长支付到期日 37请求数据格式 37返回数据格式 39B2B信用支付-商城提交退款请求接口 42请求数据格式 42返回数据格式 43B2B信用支付-商城提交退款撤销接口 46请求数据格式 46返回数据格式 48B2B信用支付-退款通知接口 51请求数据格式 51返回数据格式 53一个链接例子 56签名局部的说明 56银行反应信息的接口 57通知消息接口数据格式 58通知消息处理过程 601.5考前须知 621.6错误代码含义 63指令状态含义 63商户端开发的例子 64
1.商户端的接口商户端接口分为两种,一种是非api接口,这类接口的入口是/servlet/ICBCINBSCreditPayCustReqServlet;一种是api接口,这类接口的入口是/servlet/ICBCINBSCreditPayReqServlet。非api接口比拟少,已经在交易中标明,未标明的都是api接口,请根据标注选择对应的入口地址。对于非api接口,商户将请求数据提交到指定地址即可。对于api接口,商户需要实现双向的ssl与工行效劳器建立连接,发送请求数据并接收银行的返回数据。建立ssl连接时使用商户的api证书〔文件名类似****.e.****的软证书〕。指定url的格式:s://*.*.*.*/入口servlet,〔注意使用工行企业网银的地址,请联系所在地分行确认投产环境和测试环境的IP地址〕。B2B信用支付-交易请求接口(非api)请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串请求数据中的xml包格式:Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=26必输,取值:“ICBC_CORPORBANK_CREDIT_PREPARE_PAY
〞接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输,固定上送2卖家账号sellerAcctMAX(19)必输,卖家户名sellerNameMAX(60)必输,注意是60字节商户手续费入账账号merAcctNumMAX(19)必输,手续费入账账户户名merAcctNameMAX(60)必输,订单金额AmountMAX(10)必输,客户支付订单的总金额,一笔订单一个,以分为单位。不可以为零,必需符合金额标准。币种currTypeMAX(3)默认人民币“001〞有效期长度orderPeriodMAX(4)由于商户和银行存在时间差,要求商户提交有效期长度,银行根据自己时间计算到期日单位小时最小值:24小时最大值:360小时,即15天已含运费金额carriageAmtMAX(18)选输以分为单位商品名称goodsNameMAX(60)选输单位字节商品编号goodsNoMAX(30)选输单位字节商品数量goodsNumMAX(10)选输单位字节买家号码buyerPhoneNum=11选输支持移动、联通接收交易成功通知卖家号码sellerPhoneNum=11选输支持移动、联通接收交易成功通知接收支付结果信息通知程序地址merURLMAX(200)必输,〔注意需要写上“://〞〕订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。Xml格式说明:格式一定,允许空值;<icbc_corporbank_credit_pay> <interfaceName>接口名称</interfaceName> <interfaceVersion>接口版本号</interfaceVersion> <order> <orderID>订单号</orderID> <amount>订单金额</amount> <currType>币种<currType> <merTranTime>订单日期时间</merTranTime> <orderPeriod>有效期长度</orderPeriod> </order> <seller> <sellerAcct>卖家账号</sellerAcct> <sellerName>卖家户名</sellerName> </seller> <merchant> <merID>商户代码</merID> <merAcctNum>商户手续费入账账号</merAcctNum> <merAcctName>手续费入账账户户名</merAcctName><verifyJoinFlag>检验联名标志</verifyJoinFlag> </merchant> <message> <carriageAmt>已含运费金额</carriageAmt> <goodsName>商品名称</goodsName> <goodsNo>商品编号</goodsNo> <goodsNum>商品数量</goodsNum> </message> <notify> <buyerPhoneNum>买家号码</buyerPhoneNum> <sellerPhoneNum>卖家号码</sellerPhoneNum> <merURL>接收支付结果信息通知程序地址</merURL> </notify> <security> <merSignMsg>订单签名数据</merSignMsg> <merCert>商户证书公钥</merCert> </security></icbc_corporbank_credit_pay>订单签名数据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格式的字符串请求数据中的xml包格式:Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=26必输,取值:“ICBC_CORPORBANK_CREDIT_APPOINTID_PAY〞接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输,固定上送2卖家账号sellerAcctMAX(19)必输,卖家户名sellerNameMAX(60)必输,注意是60字节商户手续费入账账号merAcctNumMAX(19)必输,手续费入账账户户名merAcctNameMAX(60)必输,订单金额AmountMAX(10)必输,客户支付订单的总金额,一笔订单一个,以分为单位。不可以为零,必需符合金额标准。币种currTypeMAX(3)默认人民币“001〞有效期长度orderPeriodMAX(4)由于商户和银行存在时间差,要求商户提交有效期长度,银行根据自己时间计算到期日单位小时最小值:24小时最大值:360小时,即15天指定付款idpayIdMAX(24)指定的企业网银付款id,只有这个id能对这笔订单进行支付已含运费金额carriageAmtMAX(18)选输以分为单位商品名称goodsNameMAX(60)选输单位字节商品编号goodsNoMAX(30)选输单位字节商品数量goodsNumMAX(10)选输单位字节商户提示merHintMAX(120)选输单位字节买家号码buyerPhoneNum=11选输支持移动、联通接收交易成功通知卖家号码sellerPhoneNum=11选输支持移动、联通接收交易成功通知接收支付结果信息通知程序地址merURLMAX(200)必输,〔注意需要写上“://〞〕返回商户地址backMerURL必输,交易结束返回商户URL,完成闭环返回商户数据backMerData必输,交易结束返回商户URL时,post的保存数据〔可用做维护原有商户端session〕订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。Xml格式说明:格式一定,允许空值;<icbc_corporbank_credit_pay> <interfaceName>接口名称</interfaceName> <interfaceVersion>接口版本号</interfaceVersion> <order> <orderID>订单号</orderID> <amount>订单金额</amount> <currType>币种<currType> <merTranTime>订单日期时间</merTranTime> <orderPeriod>有效期长度</orderPeriod> <payId>指定付款id</payId> </order> <seller> <sellerAcct>卖家账号</sellerAcct> <sellerName>卖家户名</sellerName> </seller> <merchant> <merID>商户代码</merID> <merAcctNum>商户手续费入账账号</merAcctNum> <merAcctName>手续费入账账户户名</merAcctName><verifyJoinFlag>检验联名标志</verifyJoinFlag> </merchant> <message> <carriageAmt>已含运费金额</carriageAmt> <goodsName>商品名称</goodsName> <goodsNo>商品编号</goodsNo> <goodsNum>商品数量</goodsNum> </message> <notify> <buyerPhoneNum>买家号码</buyerPhoneNum> <sellerPhoneNum>卖家号码</sellerPhoneNum> <merURL>接收支付结果信息通知程序地址</merURL> </notify> <security> <merSignMsg>订单签名数据</merSignMsg> <merCert>商户证书公钥</merCert> </security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&amount=&currType=&merTranTime=&orderPeriod=&payId=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&verifyJoinFlag=&merURL=返回数据格式注意:返回数据是经过了url编码的。返回数据中的xml包格式:<?xmlversion="1.0"encoding="GBK"standalone="no"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><amount>订单金额</amount><currType>币种</currType><feeAmt>商户收费金额</feeAmt><merOrderTime>订单日期时间</merOrderTime><orderExpire>有效期</orderExpire><orderState>订单状态</orderState><BankNotifyTime>银行通知时间</BankNotifyTime></order><refund><refundFlag>是否退款标志</refundFlag><refundAmtSum>累计退款金额</refundAmtSum><appRefundAmt>申请退款/仲裁金额</appRefundAmt></refund><seller><sellerAcct>卖家账号</sellerAcct><sellerName>卖家户名</sellerName></seller><merchant><merID>商户代码</merID><merAcctNum>商户手续费入账账号</merAcctNum><merAcctName>手续费入账账户户名</merAcctName></merchant><tran><requestType>请求类型</requestType><requestResult>请求结果</requestResult><ErrMsg>错误描述</ErrMsg></tran><notify><buyerPhoneNum>买家号码</buyerPhoneNum><sellerPhoneNum>卖家号码</sellerPhoneNum><merURL>接收通知消息的地址</merURL></notify><security><bankSignMsg>银行签名数据</bankSignMsg></security></icbc_corporbank_credit_pay>银行签名数据bankSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-超期订单付款接口请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串请求数据中的xml包格式:Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=34必输,取值:ICBC_CORPORBANK_CREDIT_OVERDUE_PAY接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。商户收费金额feeAmtMAX(10)必输,可为零,以分为单位,必需符合金额标准。订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。<icbc_corporbank_credit_pay> <interfaceName>接口名称</interfaceName> <interfaceVersion>接口版本号</interfaceVersion> <order> <orderID>订单号</orderID> <feeAmt>商户收费金额</feeAmt> <merOrderTime>订单日期时间</merOrderTime> <merTranTime>交易日期时间</merTranTime> </order> <merchant> <merID>商户代码</merID> </merchant> <security> <merSignMsg>订单签名数据</merSignMsg> <merCert>商户证书公钥</merCert> </security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&feeAmt=&merOrderTime=&merTranTime=&merID=返回数据格式注意:返回数据是经过了url编码的。返回数据中的xml包格式:<?xmlversion="1.0"encoding="GBK"standalone="no"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><amount>订单金额</amount><currType>币种</currType><feeAmt>商户收费金额</feeAmt><merOrderTime>订单日期时间</merOrderTime><orderExpire>有效期</orderExpire><orderState>订单状态</orderState><BankNotifyTime>银行通知时间</BankNotifyTime></order><refund><refundFlag>是否退款标志</refundFlag><refundAmtSum>累计退款金额</refundAmtSum><appRefundAmt>申请退款/仲裁金额</appRefundAmt></refund><seller><sellerAcct>卖家账号</sellerAcct><sellerName>卖家户名</sellerName></seller><merchant><merID>商户代码</merID><merAcctNum>商户手续费入账账号</merAcctNum><merAcctName>手续费入账账户户名</merAcctName></merchant><tran><requestType>请求类型</requestType><requestResult>请求结果</requestResult><ErrMsg>错误描述</ErrMsg></tran><notify><buyerPhoneNum>买家号码</buyerPhoneNum><sellerPhoneNum>卖家号码</sellerPhoneNum><merURL>接收通知消息的地址</merURL></notify><security><bankSignMsg>银行签名数据</bankSignMsg></security></icbc_corporbank_credit_pay>银行签名数据bankSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-提前确认付款接口〔非api〕请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=32必输值:〞ICBC_CORPORBANK_CREDIT_AHEAD_PAY〞接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。商户收费金额feeAmtMAX(10)必输,可为零,以分为单位,必需符合金额标准。订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。请求数据中的xml包格式〔注意:xml包中所有字段都是必输项〕:<?xmlversion="1.0"encoding="GBK"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><merOrderTime>订单日期时间</merOrderTime><merTranTime>交易日期时间</merTranTime><feeAmt>商户收费金额</feeAmt></order><merchant><merID>商户代码</merID></merchant><security><merSignMsg>订单签名数据</merSignMsg><merCert>商户证书公钥</merCert></security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&feeAmt=&merID=非api接口没有返回。B2B信用支付-商城提交仲裁请求接口请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=29必输,取值:ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输,取值:“1.0.订单号OrderedMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。处理动作refundAction必输,0申请退款1撤消退款2同意退款3拒绝退款4仲裁申请5撤消仲裁6同意退款仲裁7拒绝退款仲裁处理金额refundAmtMAX(10)必输,单位:分处理描述refundActionMsgMAX(200)选输注意最大200字节订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。请求数据中的xml包格式〔注意:xml包中除refundActionMsg外的其它字段都是必输项〕:<?xmlversion="1.0"encoding="GBK"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><merOrderTime>订单日期时间</merOrderTime><merTranTime>交易日期时间</merTranTime></order><merchant><merID>商户代码</merID></merchant><refund><refundAction>处理动作</refundAction><refundAmt>处理金额</refundAmt><refundActionMsg>处理描述</refundActionMsg></refund><security><merSignMsg>订单签名数据</merSignMsg><merCert>商户证书公钥</merCert></security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=&refundAction=&refundAmt=&refundActionMsg=返回数据格式变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=29必输,取值:ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(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仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家号码buyerPhoneNum11支持移动、联通接收交易成功通知卖家号码sellerPhoneNum11支持移动、联通接收交易成功通知银行通知时间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)注意:返回数据是经过了url编码的。返回数据中的xml包格式:<?xmlversion="1.0"encoding="GBK"standalone="no"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><amount>订单金额</amount><currType>币种</currType><feeAmt>商户收费金额</feeAmt><merOrderTime>订单日期时间</merOrderTime><orderExpire>有效期</orderExpire><orderState>订单状态</orderState><BankNotifyTime>银行通知时间</BankNotifyTime></order><refund><refundFlag>是否退款标志</refundFlag><refundAmtSum>累计退款金额</refundAmtSum><appRefundAmt>申请退款/仲裁金额</appRefundAmt></refund><seller><sellerAcct>卖家账号</sellerAcct><sellerName>卖家户名</sellerName></seller><merchant><merID>商户代码</merID><merAcctNum>商户手续费入账账号</merAcctNum><merAcctName>手续费入账账户户名</merAcctName></merchant><tran><requestType>请求类型</requestType><requestResult>请求结果</requestResult><ErrMsg>错误描述</ErrMsg></tran><notify><buyerPhoneNum>买家号码</buyerPhoneNum><sellerPhoneNum>卖家号码</sellerPhoneNum><merURL>接收通知消息的地址</merURL></notify><security><bankSignMsg>银行签名数据</bankSignMsg></security></icbc_corporbank_credit_pay>银行签名数据bankSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-商城提交仲裁撤销接口请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=29必输,取值:ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输,取值:“1.0.订单号OrderedMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。处理动作refundAction必输,0申请退款1撤消退款2同意退款3拒绝退款4仲裁申请5撤消仲裁6同意退款仲裁7拒绝退款仲裁处理金额refundAmtMAX(10)必输,单位:分处理描述refundActionMsgMAX(200)注意最大200字节订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。请求数据中的xml包格式〔注意:xml包中除refundActionMsg外的其它字段都是必输项〕:<?xmlversion="1.0"encoding="GBK"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><merOrderTime>订单日期时间</merOrderTime><merTranTime>交易日期时间</merTranTime></order><merchant><merID>商户代码</merID></merchant><refund><refundAction>处理动作</refundAction><refundAmt>处理金额</refundAmt><refundActionMsg>处理描述</refundActionMsg></refund><security><merSignMsg>订单签名数据</merSignMsg><merCert>商户证书公钥</merCert></security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=&refundAction=&refundAmt=&refundActionMsg=返回数据格式变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=29必输,取值:ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(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仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家号码buyerPhoneNum11支持移动、联通接收交易成功通知卖家号码sellerPhoneNum11支持移动、联通接收交易成功通知银行通知时间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)注意:返回数据是经过了url编码的。返回数据中的xml包格式:<?xmlversion="1.0"encoding="GBK"standalone="no"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><amount>订单金额</amount><currType>币种</currType><feeAmt>商户收费金额</feeAmt><merOrderTime>订单日期时间</merOrderTime><orderExpire>有效期</orderExpire><orderState>订单状态</orderState><BankNotifyTime>银行通知时间</BankNotifyTime></order><refund><refundFlag>是否退款标志</refundFlag><refundAmtSum>累计退款金额</refundAmtSum><appRefundAmt>申请退款/仲裁金额</appRefundAmt></refund><seller><sellerAcct>卖家账号</sellerAcct><sellerName>卖家户名</sellerName></seller><merchant><merID>商户代码</merID><merAcctNum>商户手续费入账账号</merAcctNum><merAcctName>手续费入账账户户名</merAcctName></merchant><tran><requestType>请求类型</requestType><requestResult>请求结果</requestResult><ErrMsg>错误描述</ErrMsg></tran><notify><buyerPhoneNum>买家号码</buyerPhoneNum><sellerPhoneNum>卖家号码</sellerPhoneNum><merURL>接收通知消息的地址</merURL></notify><security><bankSignMsg>银行签名数据</bankSignMsg></security></icbc_corporbank_credit_pay>银行签名数据bankSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-仲裁通知接口请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=29必输,取值:ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输,取值:“1.0.订单号OrderedMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。处理动作refundAction必输,0申请退款1撤消退款2同意退款3拒绝退款4仲裁申请5撤消仲裁6同意退款仲裁7拒绝退款仲裁处理金额refundAmtMAX(10)必输,单位:分处理描述refundActionMsgMAX(200)注意最大200字节订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。请求数据中的xml包格式〔注意:xml包中除refundActionMsg外的其它字段都是必输项〕:<?xmlversion="1.0"encoding="GBK"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><merOrderTime>订单日期时间</merOrderTime><merTranTime>交易日期时间</merTranTime></order><merchant><merID>商户代码</merID></merchant><refund><refundAction>处理动作</refundAction><refundAmt>处理金额</refundAmt><refundActionMsg>处理描述</refundActionMsg></refund><security><merSignMsg>订单签名数据</merSignMsg><merCert>商户证书公钥</merCert></security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=&refundAction=&refundAmt=&refundActionMsg=返回数据格式变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=29必输,取值:ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(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仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家号码buyerPhoneNum11支持移动、联通接收交易成功通知卖家号码sellerPhoneNum11支持移动、联通接收交易成功通知银行通知时间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)注意:返回数据是经过了url编码的。返回数据中的xml包格式:<?xmlversion="1.0"encoding="GBK"standalone="no"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><amount>订单金额</amount><currType>币种</currType><feeAmt>商户收费金额</feeAmt><merOrderTime>订单日期时间</merOrderTime><orderExpire>有效期</orderExpire><orderState>订单状态</orderState><BankNotifyTime>银行通知时间</BankNotifyTime></order><refund><refundFlag>是否退款标志</refundFlag><refundAmtSum>累计退款金额</refundAmtSum><appRefundAmt>申请退款/仲裁金额</appRefundAmt></refund><seller><sellerAcct>卖家账号</sellerAcct><sellerName>卖家户名</sellerName></seller><merchant><merID>商户代码</merID><merAcctNum>商户手续费入账账号</merAcctNum><merAcctName>手续费入账账户户名</merAcctName></merchant><tran><requestType>请求类型</requestType><requestResult>请求结果</requestResult><ErrMsg>错误描述</ErrMsg></tran><notify><buyerPhoneNum>买家号码</buyerPhoneNum><sellerPhoneNum>卖家号码</sellerPhoneNum><merURL>接收通知消息的地址</merURL></notify><security><bankSignMsg>银行签名数据</bankSignMsg></security></icbc_corporbank_credit_pay>银行签名数据bankSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPhoneNum=&sellerPhoneNum=&merURL=B2B信用支付-查询接口请求数据格式使用form方式提交,提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明:变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=34必输取值:“ICBC_CORPORBANK_CREDIT_ORDER_QUERY〞接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss提交订单时商户端时间交易日期时间merTranTime=14必输,格式为:YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内,否那么判定交易时间非法。订单签名数据merSignMsg无限制必输,商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行然后进行BASE64编码后得到的字符串。〔格式单独说明〕商户证书公钥merCert无限制必输,商户用二进制方式读取证书公钥文件后,进行BASE64编码后产生的字符串。请求数据中的xml包格式〔注意:xml包中所有字段都是必输项〕:<?xmlversion="1.0"encoding="GBK"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><merOrderTime>订单日期时间</merOrderTime><merTranTime>交易日期时间</merTranTime></order><merchant><merID>商户代码</merID></merchant><security><merSignMsg>订单签名数据</merSignMsg><merCert>商户证书公钥</merCert></security></icbc_corporbank_credit_pay>订单签名数据merSignMsg的格式:interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&merID=返回数据格式变量名称变量命名长度定义〔以字节为单位〕说明接口名称interfaceName=34必输取值:“ICBC_CORPORBANK_CREDIT_ORDER_QUERY〞接口版本号interfaceVersion=7必输,取值:“1.0.订单号orderIDMAX(30)必输,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。订单日期时间merOrderTime=14必输,格式为:YYYYMMDDHHmmss提交订单时商户端时间卖家账号sellerAcctMAX(19)卖家户名sellerNameMAX(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仲裁处理中是否退款标志refundFlagMAX(1)0-未退款1-退款累计退款金额refundAmtSumMAX(10)申请退款/仲裁金额appRefundAmtMAX(10)买家号码buyerPhoneNum11支持移动、联通接收交易成功通知卖家号码sellerPhoneNum11支持移动、联通接收交易成功通知银行通知时间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)注意:返回数据是经过了url编码的。返回数据中的xml包格式:<?xmlversion="1.0"encoding="GBK"standalone="no"?><icbc_corporbank_credit_pay><interfaceName>接口名称</interfaceName><interfaceVersion>接口版本号</interfaceVersion><order><orderID>订单号</orderID><amount>订单金额</amount><currType>币种</currType><feeAmt>商户收费金额</feeAmt><merOrderTime>订单日期时间</merOrderTime><orderExpire>有效期</orderExpire><orderState>订单状态</orderState><BankNotifyTime>银行通知时间</BankNotifyTime></order><refund><refundFlag>是否退款标志</refundFlag><refundAmtSum>累计退款金额</refundAmtSum><appRefundAmt>申请退款/仲裁金额</appRefundAmt></refund><seller><sellerAcct>卖家账号</sellerAcct><sellerName>卖家户名</sellerName></seller><merchant><merID>商户代码</merID><merAcctNum>商户手续费入账账号</merAcctNum><merAcctName>手续费入账账户户名</merAcctName></merchant><tran><requestType>请求类型</requestType><requestResult>请求结果</requestResult><ErrMsg>错误描述</ErrMsg></tran><notify><buyerPhoneNum>买家号码</buyerPhoneNum><sellerPhoneNum>卖家号码</sellerPhoneNum><merURL>接收通知消息的地址</merURL></notify><security><bankSignMsg>银行签名数据</bankSignMsg></security></icbc_corporbank_credit_pay>银行签名数据bankSignMsg的格式:interfaceName=&interfaceVersion=&orderID=
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2026中建港航局集团有限公司春季校园招聘备考题库附参考答案详解【综合题】
- 2026中国电信校园招聘“优才计划”专项招聘备考题库及完整答案详解(网校专用)
- 2026云南玉溪市计划生育协会城镇公益性岗位招聘1人备考题库及参考答案详解(培优a卷)
- 2026宁夏银川永宁县卫生健康系统专业技术人员自主招聘59人备考题库及参考答案详解【b卷】
- 2026四川大学华西医院许艺苧研究员课题组博士后招聘备考题库(易错题)附答案详解
- 2026春季河北邯郸市曲周县博硕人才选聘87人备考题库一套附答案详解
- 中建安装2026届春季校园招聘备考题库(考点精练)附答案详解
- 2026北京市政路桥股份有限公司招聘26人备考题库(必刷)附答案详解
- 2026江西南昌市西湖区图书馆招聘1人备考题库附答案详解ab卷
- 2026河北保定市消防救援支队次政府专职消防员招录154人备考题库及参考答案详解【研优卷】
- 2026福建浦开集团有限公司、福建浦盛产业发展集团有限公司、福建浦丰乡村发展集团有限公司社会公开招聘补充笔试模拟试题及答案解析
- 桥牌协会内部管理制度
- 2026重庆市南岸区消防救援支队消防文员招录2人笔试备考试题及答案解析
- 2026年山东省立第三医院初级岗位公开招聘人员(27人)笔试备考试题及答案解析
- 2026年滁州天长市大通镇预任制村干及村级后备干部储备库选拔28名笔试备考试题及答案解析
- 2026秋招:广州环投集团笔试题及答案
- 加油站突发环境事件风险评估报告模板
- 挤塑工艺培训课件
- 生成式AI赋能下的高中地理教师教育观念更新与教学实践研究教学研究课题报告
- 2025执业药师继续教育试题库及参考答案(完整版)
- 2026年医药领域腐败问题集中整治自查自纠报告与医院卫生院整治群众身边
评论
0/150
提交评论