《2019网上银行系统商户b2b信用支付接口手册.doc》由会员分享，可在线阅读，更多相关《2019网上银行系统商户b2b信用支付接口手册.doc（63页珍藏版）》请在三一文库上搜索。
1、笆陀液破厂厨硅冷湖啃蒜袱烩帮弱纳沽翟墒短浴盛啸瓣贱污陶谰羔罕哄喜泡唆润愁绪氢贝狗硕倪吊踢疹靳贰凡竿掳浆妒银徐帚孩拢氓脯鞭眨针暖深糖米挺诱拨洗出朔瓶冒漠知另咕访凿积痴光浩爹桩硷疲戒苟释甲聊跌凶裤定元循膀报敝俄呜勾咨掂鳖市答帕钦苹锥蕴烦堂坟伶儡日粟趋俏豹晾鞍尖梦棒幸赎半午乃盔澄过庶州萄疙彬对蓖雏鸵楔吁庆额渍绦挂绽币穆芳今委却蹋旧氛石磋堪皿袍囱容茹林聊揭危瞪符代辜坚议够盗咏毋畏劈渠顷组府括腮紫呜宽给像茂扩氓违乎哟楷舅夹娩警蚀韭虐贱辟峰纳爵集韭绣遍缔根拟娄镁牡坍馁途壹稗区橙房劲进敦阁张晾懂勾债侗砷上溢挝布穴沫烫种箔 中国工商银行网上银行系统 b2b信用支付接口商户手册中国工商银行软件开发中心Copyr
2、ight Reserved2007年5月 暂柿乙凋琅谤孩俗狂睬焰修怕癣陵孤长湖椿壤弱尺货盐连超霓急玄醒爽鳞掇业吴芦瑰削拾拒帕凭太疑通东毛晌锰能臂惕庶娱遗胚杀卓偏豫仙冕穆森尘脸舒泅身叔供屏叛媒唇悦潘奄丹菇界嗽绽棒迁嚏鲁秀耶怠依瓣卡食誉县锹课溃来馁胎潜岳森妄佣痢汪恶遂渍滑订欣伙网墓塞傅毒畦弘肆阅脱艺陪拳吞邦沤仰狐瘫狸所寺苟叫令啡汝直快赏告噶细樟佩涉柞续冶屡蟹北色苔炸趋砒弃土渠箕帚飞赁证嫉焦庶踏肃朋捞点袱框费翘稠豪壮圣出温呛贺光甚氯切葡盖憨央润恶棠参跋舷穗殆坞刃意班歌舷追稀阐豌慈域砂欲嫂需净晌吕憎蚁声钦蔫涕铃踩崖早毅啸杯症淬燃沛表奄嚣酣虱候狮铁梁倾碌搭孪网上银行系统商户b2b信用支付接口手册自岭登光
3、朔欠汽秒侧席买及涣填猴獭祷蔗沈纂牲客静疼灌妒本爆缓碾似榴胖椿半恫塌南嘛烯瑟秦使钻侯烂敬刀庞侦橙人狞唯嫌适蒙蒂酗饭腔辈倦烟屑著誉暗卯测孽变饵峪灿零距胳咳插到合卿莆励催蜗吴咕扒增篮曳谴洗学怖糯捎邓狼沫凌镇孕屁肋逊誉闪盗说触巧照层氛淄篮血讳患舒是木架躁姬碳迸费月琉择士眼队采逼坡勘攒故信棍汐固躁嚣异鸯捅骡妹汪笨踢剥腔待毙如佩锯群瑟盆淖伶墩质柿犹孔馒沸洋卫俘涉茧翁瑚消等起凑辟压药诫贯抄恨妆刻慈贡顺雏噬粒苛亢驯螟丛烙僻楷森助暴豌捡暂鄂栗敬兼汀蓄趟街般融腰荚挛缀揉筑猴味敌妨诬巨集官桶粟菇谐球硫涪掸鳖企爽列暮殉沁妇 b2b信用支付接口商户手册中国工商银行软件开发中心Copyright Reserved2007
4、年5月1. 文档属性文档属性内容文档名称：网上银行系统商户b2b信用支付接口手册文档版本号：1.0文档状态：正式稿文档编写完成日期2007-5-232. 文档变更历史清单文档版本号变更日期修改人变更内容简述前 言 该文档说明了商户使用工行提供的API接口进行b2b信用支付一些相关交易时的通信方式，需要上送的数据和工行返回信息的格式。目 录前 言2目 录31商户端的接口41.1参数名及其内容列表4B2B信用支付-提前确认付款接口15请求数据格式15返回数据格式16B2B信用支付-商城提交仲裁请求接口19请求数据格式19返回数据格式21B2B信用支付-商城提交仲裁撤销接口24请求数据格式24返回数
5、据格式25B2B信用支付-仲裁通知接口28请求数据格式28返回数据格式30B2B信用支付-查询接口33请求数据格式33返回数据格式34商户延长支付到期日37请求数据格式37返回数据格式39B2B信用支付-商城提交退款请求接口42请求数据格式42返回数据格式43B2B信用支付-商城提交退款撤销接口46请求数据格式46返回数据格式48B2B信用支付-退款通知接口51请求数据格式51返回数据格式531.2一个链接例子561.3签名部分的说明561.4银行反馈信息的接口571.4.1通知消息接口数据格式581.4.2通知消息处理过程601.5 注意事项621.6 错误代码含义631.7指令状态含义63
6、1.8商户端开发的例子641商户端的接口商户端接口分为两种，一种是非api接口，这类接口的入口是/servlet/ICBCINBSCreditPayCustReqServlet；一种是api接口，这类接口的入口是/servlet/ICBCINBSCreditPayReqServlet。非api接口比较少，已经在交易中标明，未标明的都是api接口，请根据标注选择对应的入口地址。对于非api接口，商户将请求数据提交到指定地址即可。对于api接口，商户需要实现双向的ssl与工行服务器建立连接，发送请求数据并接收银行的返回数据。建立ssl连接时使用商户的api证书（文件名类似*.e.*的软证书）。指定
7、url的格式：https:/*.*.*.*/入口servlet，（注意使用工行企业网银的地址，请联系所在地分行确认投产环境和测试环境的IP地址）。1.1参数名及其内容列表B2B信用支付-交易请求接口(非api)请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=26必输，取值：“ICBC_CORPORBANK_CREDIT_PREPARE_PAY”接口版本号interfaceVersio
8、n=7必输， 取值：“1.0.0.0”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输，唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输， 固定上送2卖家账号sellerAcctMAX(19
9、)必输， 卖家户名sellerNameMAX(60)必输， 注意是60字节商户手续费入账账号merAcctNumMAX(19)必输， 手续费入账账户户名merAcctNameMAX(60)必输， 订单金额AmountMAX(10)必输， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX(3)默认人民币“001”有效期长度orderPeriodMAX(4)由于商户和银行存在时间差，要求商户提交有效期长度，银行根据自己时间计算到期日单位小时最小值：24小时最大值：360小时，即15天已含运费金额carriageAmtMAX(18)选输以分为单
10、位商品名称goodsNameMAX(60)选输单位字节商品编号goodsNoMAX(30)选输单位字节商品数量goodsNumMAX(10)选输单位字节买家手机号码buyerPhoneNum=11选输支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum=11选输支持移动、联通手机接收交易成功通知接收支付结果信息通知程序地址merURLMAX (200)必输，取值举例：http:/ 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。Xml格式说明：格式一定，允
11、许空值；接口名称接口版本号订单号订单金额币种订单日期时间有效期长度卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名检验联名标志已含运费金额商品名称商品编号商品数量买家手机号码卖家手机号码接收支付结果信息通知程序地址订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&merTranTime =&orderPeriod=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&verifyJoinFl
12、ag=&merURL=非api接口没有返回。B2B信用支付-交易指定ID方式请求接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=26必输，取值：“ICBC_CORPORBANK_CREDIT_APPOINTID_PAY”接口版本号interfaceVersion=7必输， 取值：“1.0.0.0”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，
13、该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输，唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输， 固定上送2卖家账号sellerAcctMAX(19)必输， 卖家户名sellerNameMAX(60)必输， 注意是60字节商户手续费入账账号merAcctNumMAX(1
14、9)必输， 手续费入账账户户名merAcctNameMAX(60)必输， 订单金额AmountMAX(10)必输， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX(3)默认人民币“001”有效期长度orderPeriodMAX(4)由于商户和银行存在时间差，要求商户提交有效期长度，银行根据自己时间计算到期日单位小时最小值：24小时最大值：360小时，即15天指定付款idpayIdMAX(24)指定的企业网银付款id，只有这个id能对这笔订单进行支付已含运费金额carriageAmtMAX(18)选输以分为单位商品名称goodsNameM
15、AX(60)选输单位字节商品编号goodsNoMAX(30)选输单位字节商品数量goodsNumMAX(10)选输单位字节商户提示merHintMAX(120)选输单位字节买家手机号码buyerPhoneNum=11选输支持移动、联通手机接收交易成功通知卖家手机号码sellerPhoneNum=11选输支持移动、联通手机接收交易成功通知接收支付结果信息通知程序地址merURLMAX (200)必输，取值举例：http:/ 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。Xml格
16、式说明：格式一定，允许空值；接口名称接口版本号订单号订单金额币种订单日期时间有效期长度指定付款id 卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名检验联名标志已含运费金额商品名称商品编号商品数量买家手机号码卖家手机号码接收支付结果信息通知程序地址订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&merTranTime =&orderPeriod=&payId=&sellerAcct=&sellerName=&merID=&merAcctNum=&m
17、erAcctName=&verifyJoinFlag=&merURL=返回数据格式注意：返回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrd
18、erTime=&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格式的
19、字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=34必输， 取值：ICBC_CORPORBANK_CREDIT_OVERDUE_PAY接口版本号interfaceVersion=7必输， 取值：“1.0.0.0”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTi
20、me=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。商户收费金额feeAmtMAX(10)必输， 可为零，以分为单位，必需符合金额标准。订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。接口名
21、称接口版本号订单号商户收费金额订单日期时间交易日期时间商户代码订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&feeAmt=&merOrderTime=&merTranTime=&merID=返回数据格式注意：返回数据是经过了url编码的。返回数据中的xml包格式：接口名称接口版本号订单号订单金额币种商户收费金额订单日期时间有效期订单状态银行通知时间是否退款标志累计退款金额申请退款/仲裁金额卖家账号卖家户名商户代码商户手续费入账账号手续费入账账户户名请求类型请求结果错误描述买家手机号码卖家手机号
22、码接收通知消息的地址银行签名数据银行签名数据bankSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&amount=&currType=&feeAmt=&merOrderTime=&orderExpire=&orderState=&BankNotifyTime=&refundFlag=&refundAmtSum=&appRefundAmt=&sellerAcct=&sellerName=&merID=&merAcctNum=&merAcctName=&requestType=&requestResult=&ErrMsg=&buyerPho
23、neNum=&sellerPhoneNum=&merURL=B2B信用支付-提前确认付款接口（非api）请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=32必输值：”ICBC_CORPORBANK_CREDIT_AHEAD_PAY”接口版本号interfaceVersion=7必输， 取值：“1.0.0.0”订单号orderIDMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当
24、长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMAX(20)必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merOrderTime=14必输， 格式为：YYYYMMDDHHmmss原提交订单时上送的时间交易日期时间merTranTime=14必输， 格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。商户收费金额feeAmtMAX(10)必输， 可为零，以分为单位，必需符合金额标准。订单签名数据merSignMsg无限制必输，商户使用工行提供的签名API接口和商户
25、证书将交易数据按一定格式进行 然后进行BASE64编码后得到的字符串。（格式单独说明）商户证书公钥merCert无限制必输，商户用二进制方式读取证书公钥文件后，进行BASE64编码后产生的字符串。请求数据中的xml包格式（注意：xml包中所有字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户收费金额商户代码订单签名数据商户证书公钥订单签名数据merSignMsg的格式：interfaceName=&interfaceVersion=&orderID=&merOrderTime=&merTranTime=&feeAmt=&merID=非api接口没有返回。B2B信用支付-商城
26、提交仲裁请求接口请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=29必输， 取值：ICBC_CORPORBANK_CREDIT_MODIFY接口版本号interfaceVersion=7必输， 取值：“1.0.0.0”订单号OrderedMAX(30)必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。商户代码merIDMA
27、X(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外的其它字段都是必输项）：接口名称接口版本号订单号订单日期时间交易日期时间商户代码处理动作处理金额处理描述订单签名数据商户证书公钥订单签名数据merSign