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

中国工商银行网上银行系统——B2B支付（新接口）中国工商银行软件开发中心CopyrightReserved2005年8月商户手册网上银行商户手册©CopyrightICBCSDC2005.8-1-1.文档属性文档属性内容文档名称：网上银行系统B2B商户(新接口)手册文档版本号：1.3文档状态：正式稿文档编写完成日期2005-092.文档变更历史清单文档版本号变更日期修改人变更内容简述1.12005-12-20解志超之前通知消息编码方式是将整个http请求的bodycontent进行了URL编码，不符合http协议的格式，不利于商户端的开发。根据商户的建议修改为：对请求中的每个字段的值单独进行URL编码，这样商户端可以更方便的取到各个字段的值。1.22006-06-06解志超修正了文档的一些错误1.32006-10-25解志超请求接口中增加收款人名称字段网上银行商户手册©CopyrightICBCSDC2005.8-2-前言该文档包括客户通过商户网站的中国工商银行网上银行的“B2B网上支付”URL超链进行B2B新接口网上支付时，商户必须向银行提供的部分订单信息及其格式；中国工商银行向商户返回客户付款情况信息的内容、格式、验证签名程序的接口及调试用的例子。网上银行商户手册©CopyrightICBCSDC2005.8-3-目录前言...............................................................................................................................................2目录.................................................................................................................................................31．商户端的接口....................................................................................................................................41.1参数名及其内容列表......................................................................................................................................41.2商户请求中签名数据产生方法....................................................................................................61.3一个链接例子................................................................................................................................72．银行反馈信息的接口........................................................................................................................82.1通知消息接口数据格式：............................................................................................................92.2通知消息的FORM格式：...........................................................................................................102.3通知消息处理过程......................................................................................................................113.商户端系统环境要求....................................................................................................................143.1软件环境......................................................................................................................................144.常见问题........................................................................................................................................14问题1返回一个空白页面，页面中只有五位错误代码..............................................................14问题2返回超时页面......................................................................................................................14网上银行商户手册©CopyrightICBCSDC2005.8-4-1．商户端的接口客户通过商户的网站与卖方进行b2b网上定购交易，确认订单后通过商户网站提供的“中国工商银行网上支付”超链，进入中国工商银行的网上支付画面进行支付。为此商户网站必须将该订单中的部分信息以Form提交方式中的Post方法，将数据提交到中国工商银行指定的的网上支付URL(https://*.*.*.*/servlet/ICBCINBSEBusinessServlet，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)中。1.1参数名及其内容列表变量名称变量命名长度定义说明接口名称APINameMAX(30)必输，签名，上送“B2B”，区别大小写！接口版本号APIVersion=15必输，签名,上送”001.001.001.001”商户代码Shop_code=14必输，签名，唯一确定一个商户的代码，商户在工行开户时，由工行告知商户支付结果信息通知程序地址MerchantURLMAX(200)必输，签名，使用HS接口模式的商户用来接收工行订单支付结果信息的程序名字和位置。订单号ContractNoMAX(30)必输，签名，客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。订单金额ContractAmtMAX(18)必输，签名，客户支付订单的总金额，一笔订单一个，保留到分，无小数点，如金额为1.00元，上传数据为“100”支付币种Account_cur=3必输，签名，用来区分一笔支付的币种。目前工行只支持人民币（001）支付。定义如下：001人民币检验联名标志JoinFlag必输，签名，固定上送2订单签名数据Mer_Icbc20_signstr无限制必输，生成签名数据的方法见后面的说明商城证书数据Cert无限制必输，商户端读取本地商户证书文件后，再使用工行提供的API进行Base64编码后产生的商户证书数据字串。结果发送类型SendType=10----成功失败信息都发送1----只发送成功信息必输，签名，如果取0，工行向商户发送一笔订单的每一次交易结果，无论支付成功或者失败，如果取1，工行只向商户发送交易成功的通知信息。当在付款人一方b2b支付指令经过指令批复后提交的，结果发送类型默认为成功失败都发送，这时不取商户上送的发送类型。交易日期时间TranTime=14必输，签名，YYYYMMDDHHmmss。与工行系统当前时间差为：前1小时，后12小时网上银行商户手册©CopyrightICBCSDC2005.8-5-商城账号Shop_acc_numMAX(19)必输，签名收款单位账号PayeeAcctMAX(19)必输，签名商品编号GoodsCodeMAX(30)选输商品名称GoodsNameMAX(60)选输订单数量AmountMAX(10)选输已含运费金额TransFeeMAX(18)选输商城提示ShopRemarkMAX(120)选输，最多120字符商城备注字段ShopRemMAX(100)选输，最多100字符收款人名称PayeeNameMAX(60)选输，最多60字符，30个汉字注意：1.从商户Post过来的数据，参数的名称必须与上表中完全相同，名称中的字母大小写均要相同，不能进行随意更改(在form中的提交按钮inputtype=”submit”……中submit不能有Name属性)；此外，如果其他input项的Name中使用了双引号，如：inputtype=textname=MerchantURLvalue=，则一定注意在引号内不要包含空格，不要写成“MerchantURL”或者“MerchantURL”，如果拼写错误或者多了空格，将造成数据无法识别，无法正常进行支付。2.接口名称和版本号一定要和上表中相同。3.为了保证中文信息的正确性，商户请求的数据字符集要求是GBK。4.商户提交数据中的空格将被认为是有效字符被接收，请商户开发时注意对多余空格的控制。5.商户证书对于商城账号必须有定购操作权限，收款账号可以和商城账号不相同，上送的商城账号与收款人账号相同时，则后续可提供退货、返还操作。如果付款人有任意账号转账权限，那么收款账号可为任意的工行19位账号，否则收款账号必须为付款人所在集团在网银注册的可收款的19位账号，此接口不支持低于19位的老账号。6.关于新增的收款人名称字段：如果商户在这个字段上送了收款人名称那么客户在支付页面就不用输入了，会取上送的收款人名称；如果商户没有上送那么会在商户所在企业网银集团所有提交id的收款人名册（可以在企业网银的付款业务-网上汇款-收款人名册栏目中维护收款人名册）中查找是否有交易中的收款账号，如果有就会取收款人名册的收款人名称，这时也不用客户输入收款人名称；如果以上两种情况都不满足网上银行商户手册©CopyrightICBCSDC2005.8-6-那么在支付页面就需要客户输入收款人名称。请商户根据自身情况选择收款人名称的获得方式。对于已经开发完成的商户不上送这个字段也可以继续使用接口，不会影响已有功能。1.2商户请求中签名数据产生方法签名信息字段Mer_Icbc20_signstr的产生通过调用工行提供的签名API，用商户自己的私钥对交易数据和商户信息数据进行数字签名，产生签名结果。步骤如下：1．组织要签名的数据串（串的顺序不可改变）数据串为：APIName=B2B&APIVersion=001.001.001.001&Shop_code=商户代码&MerchantURL=支付结果信息通知程序地址&ContractNo=订单号&ContractAmt=订单金额&Account_cur=001&JoinFlag=2&SendTyp