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

——B2B支付
商户手册
中国工商银行软件开发中心
Copyright Reserved
2005年8月
前言
该文档包括客户通过商户网站的中国工商银行网上银行的“B2B网上支付”URL超链进行B2B新接口网上支付时,商户必须向银行提供的部分订单信息及其格式;中国工商银行向商户返回客户付款情况信息的内容、格式、及其验证程序的接口;及调试用的例子。
目录
前言 1
3
3
TransFee 4
4
5

客户通过商户的网站与卖方进行网上定购交易,确认订单后通过商户网站提供的“中国工商银行网上支付”超链,进入中国工商银行的网上支付画面进行支付。为此商户网站必须将该订单中的部分信息以Form提交方式中的Post方法,将数据提交到中国工商银行指定的的网上支付URL (https://*.*.*.*/servlet/ICBCINBSEBusinessServlet,严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)中。

变量名称
变量命名
长度定义
说明
接口名称
APIName
MAX (30)
必输,签名,上送“B2B”,区别大小写!
接口版本号
APIVersion
=15
必输,签名,上送””
商户代码
Shop_code
=14
必输,签名,唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户
支付结果信息通知程序地址
MerchantURL
MAX (200)
签名,使用HS接口模式的商户用来接收工行订单支付结果信息的程序名字和位置。
订单号
ContractNo
MAX(30)
必输,签名,客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。
订单金额
ContractAmt
MAX(18)
必输,签名,客户支付订单的总金额,一笔订单一个,保留到分,无小数点,,上传数据为“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小时
商城账号
_num
MAX (19)
必输,签名
收款单位账号
t
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="CPay/">,则一定注意在引号内不要包含空格,不要写成“Merchant URL ”或者“ Mer chantURL”,如果拼写错误或者多了空格,将造成数据无法识别,无法正常进行支付
。
,商户请求的数据字符集要求是GBK。
,请商户开发时注意对多余空格的控制。