工行网上银行系统b2b商户(新接口)手册

《工行网上银行系统b2b商户(新接口)手册》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、中国工商银行网上银行系统——B2B支付（新接口）商户手册中国工商银行软件开发中心CopyrightReserved2005年8月网上银行商户手册1.文档属性文档属性内容文档名称：网上银行系统B2B商户(新接口)手册文档版本号：1.3文档状态：正式稿文档编写完成日期2005-092.文档变更历史清单文档版本号变更日期修改人变更内容简述1.12005-12-20解志超之前通知消息编码方式是将整个http请求的bodycontent进行了URL编码，不符合http协议的格式，不利于商户端的开发。根据商户的建议修改为：对请求中的每个字段的值单独进行URL编

2、码，这样商户端可以更方便的取到各个字段的值。1.22006-06-06解志超修正了文档的一些错误1.32006-10-25解志超请求接口中增加收款人名称字段©CopyrightICBCSDC2005.8-14-网上银行商户手册前言该文档包括客户通过商户网站的中国工商银行网上银行的“B2B网上支付”URL超链进行B2B新接口网上支付时，商户必须向银行提供的部分订单信息及其格式；中国工商银行向商户返回客户付款情况信息的内容、格式、验证签名程序的接口及调试用的例子。©CopyrightICBCSDC2005.8-14-网上银行商户手册目录前言2目录31．

3、商户端的接口41.1参数名及其内容列表41.2商户请求中签名数据产生方法51.3一个链接例子72．银行反馈信息的接口82.1通知消息接口数据格式：82.2通知消息的form格式：102.3通知消息处理过程113.商户端系统环境要求133.1软件环境134.常见问题13问题1返回一个空白页面，页面中只有五位错误代码13问题2返回超时页面14©CopyrightICBCSDC2005.8-14-网上银行商户手册1．商户端的接口客户通过商户的网站与卖方进行b2b网上定购交易，确认订单后通过商户网站提供的“中国工商银行网上支付”超链，进入中国工商银行的网上

4、支付画面进行支付。为此商户网站必须将该订单中的部分信息以Form提交方式中的Post方法，将数据提交到中国工商银行指定的的网上支付URL(https://*.*.*.*/servlet/ICBCINBSEBusinessServlet，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)中。1.1参数名及其内容列表变量名称变量命名长度定义说明接口名称APINameMAX(30)必输，签名，上送“B2B”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.001.001”商户代码Shop_code=14必

5、输，签名，唯一确定一个商户的代码，商户在工行开户时，由工行告知商户支付结果信息通知程序地址MerchantURLMAX(200)必输，签名，使用HS接口模式的商户用来接收工行订单支付结果信息的程序名字和位置。订单号ContractNoMAX(30)必输，签名，客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。订单金额ContractAmtMAX(18)必输，签名，客户支付订单的总金额，一笔订单一个，保留到分，无小数点，如金额为1.00元，上传数据为“100”支付币种Ac

6、count_cur=3必输，签名，用来区分一笔支付的币种。目前工行只支持人民币（001）支付。定义如下：001人民币检验联名标志JoinFlag必输，签名，固定上送2订单签名数据Mer_Icbc20_signstr无限制必输，生成签名数据的方法见后面的说明商城证书数据Cert无限制必输，商户端读取本地商户证书文件后，再使用工行提供的API进行Base64编码后产生的商户证书数据字串。结果发送类型SendType=10----成功失败信息都发送1----只发送成功信息必输，签名，如果取0，工行向商户发送一笔订单的每一次交易结果，无论支付成功或者失败，

7、如果取1，工行只向商户发送交易成功的通知信息。当在付款人一方b2b支付指令经过指令批复后提交的，结果发送类型默认为成功失败都发送，这时不取商户上送的发送类型。交易日期时间TranTime=14必输，签名，YYYYMMDDHHmmss。与工行系统当前时间差为：前1小时，后12小时©CopyrightICBCSDC2005.8-14-网上银行商户手册商城账号Shop_acc_numMAX(19)必输，签名收款单位账号PayeeAcctMAX(19)必输，签名商品编号GoodsCodeMAX(30)选输商品名称GoodsNameMAX(60)选输订单数量

8、AmountMAX(10)选输已含运费金额TransFeeMAX(18)选输商城提示ShopRemarkMAX(120)选