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

——B2B支付 中国工商银行软件开发中心 Copyright Reserved 2005年8月 前 言 该文档包括客户通过商户网站的中国工商银行网上银行的“B2B网上支付”URL超链进行B2B新接口网上支付时，商户必须向银行提供的部分订单信息及其格式；中国工商银行向商户返回客户付款情况信息的内容、格式、及其验证程序的接口；及调试用的例子。 目 录 前 言 1 1．商户端的接口 3 1．1参数名及其内容列表 3 TransFee 4 1．2一个链接例子 4 2．银行反馈信息的接口 5 1．商户端的接口 客户通过商户的网站与卖方进行网上定购交易，确认订单后通过商户网站提供的“中国工商银行网上支付”超链，进入中国工商银行的网上支付画面进行支付。为此商户网站必须将该订单中的部分信息以Form提交方式中的Post方法，将数据提交到中国工商银行指定的的网上支付URL (https://*.*.*.*/servlet/ICBCINBSEBusinessServlet，严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)中。 1.1参数名及其内容列表 变量名称 变量命名 长度定义 说明 接口名称 APIName MAX (30) 必输，签名，上送“B2B”，区别大小写！ 接口版本号 APIVersion =15 必输，签名,上送”001.001.001.001” 商户代码 Shop_code =14 必输，签名，唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户 支付结果信息通知程序地址 MerchantURL MAX (200) 签名，使用HS接口模式的商户用来接收工行订单支付结果信息的程序名字和位置。 订单号 ContractNo MAX(30) 必输，签名，客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。 订单金额 ContractAmt MAX(18) 必输，签名，客户支付订单的总金额，一笔订单一个，保留到分，无小数点，如金额为1.00元，上传数据为“100” 支付币种 Account_cur = 3 必输，签名，用来区分一笔支付的币种。目前工行只支持人民币（001）支付。定义如下： 001 人民币 检验联名标志 JoinFlag 必输，签名，固定上送2 订单签名数据 Mer_Icbc20_signstr 无限制 生成签名数据的方法见后面的说明 商城证书数据 Cert 无限制 必输，商户端读取本地商户证书文件后，再使用工行提供的API进行Base64编码后产生的商户证书数据字串。 结果发送类型 SendType =1 0 ----成功失败信息都发送 1 ---- 只发送成功信息 必输，签名，如果取0，工行向商户发送一笔订单的每一次交易结果，无论支付成功或者失败，如果取1，工行只向商户发送交易成功的通知信息。 交易日期时间 TranTime =14 必输，签名，YYYYMMDDHHmmss。与工行系统当前时间差为：前1小时，后12小时 商城账号 Shop_acc_num MAX (19) 必输，签名 收款单位账号PayeeAcct MAX (19) 必输，签名 商品编号 GoodsCode MAX (30) 选输 商品名称 GoodsName MAX (60) 选输 订单数量 Amount MAX (10) 选输 已含运费金额 TransFee MAX (18) 选输 商城提示 ShopRemark MAX (120) 选输，最多120字符 商城备注字段 ShopRem MAX(100) 选输，最多100字符 注：1. 从商户Post过来的数据，参数名的名称必须与上表中完全相同，名称中的字母大小写均要相同，不能进行随意更改(在form中的提交按钮input type=”submit”……中submit不能有Name属性)；此外，如果其他input 项的Name中使用了双引号，如：input type=text name=MerchantURL value=/ICBCPay/，则一定注意在引号内不要包含空格，不要写成“Merchant URL ”或者“ Mer chantURL”，如果拼写错误或者多了空格，将造成数据无法识别，无法正常进行支付 2.接口名称和版本号一定要和上表中相同。 3.为了保证中文信息的正确性，商户请求的数据字符集要求是GBK。 4.商户提交数据中的空格将被认为是有效字符被接收，请商户开发时注意对多余空格的控制。 5.商户证书对于商城账号必须有定购操作权限，收款账号可以和商城账号不相同，上送的商城账号与收款人账号相同时，则后续可