中国工商银行网上银行新B2C在线支付接口说明V1.0.0.11(4)

网上银行商户手册

standalone=\ersion>1.0.0.11201003081416290010200EC20001119201003081416290110200026009018372212001威尼熊220201003081416291110200026009018372212001威尼熊

2200ZH_CN2AG1localhost127.0.0.1112345613466780886三里屯

防欺诈接口专用请保留包装http://localhost:9080/EbizSimulate/emulator/Newb2c_Pay_Mer.jsptest

2.2 通知接口

2.2.1 通知接口表单定义

变量名称 返回商户变量 变量命名 merVAR 长度定义 无限制 说明 取值：商户提交接口中merVAR字段当返回银行结果时，作为一个隐藏域变量，商户可以用此变量维护session等等。由客户端浏览器支付完成后提交通知结果时是明文传输，建议商户对此变量使用额外安全防范措施，如签名、base64，银行端将此字段原样返回 银行通知消息，xml格式定义见下文，提交商户时对xml明文串进行了base64编码； xml串中没有回车换行和多余空格；包含xml头属性，且格式固定； 银行使用自己证书对商户通知消息notifyData字段的xml格式明文串进行的签名，然后进行BASE64编码后的字符串。 注意：签名是对notifyData的xml明第 11 页 共 16 页

通知结果数据 notifyData 无限制 银行对通知结果的签名数据 signMsg 无限制 网上银行商户手册

文进行签名，不是其BASE64编码后的串；签名后得到二进制数据，对此数据进行BASE64编码得到signMsg

2.2.2 notifyData数据定义

变量名称 接口名称 接口版本号 交易日期时间 变量命名 interfaceName interfaceVersion orderDate 长度定义 ＝16 MAX(15) =14 说明 取值：“ICBC_PERBANK_B2C” 取值：“1.0.0.11” 格式为：YYYYMMDDHHmmss 要求在银行系统当前时间的前1小时和后12小时范围内，否则判定交易时间非法。 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。 必输，每笔订单一个； 取值：1、3、6、9、12、18、24；1代表全额付款，必须为以上数值，否则订单校验不通过。 商户收费入账账号 （只能交易时指定）。 用来区分一笔支付的币种，目前工行只支持使用人民币（001）支付。 取值： “001” 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。 取值“1”：客户支付时，网银判断该客户是否与商户联名，是则按上送金额扣帐，否则展现未联名错误； 取值“0”：不检验客户是否与商户联名，按上送金额扣帐。 客户在银行端是否与商城联名标志位。1客户联名 0客户未联名 联名客户在商户的会员号。 银行端指令流水号 第 12 页 共 16 页

订单号 orderid MAX(30) 订单金额 amount MAX(10) 分期付款期数 installmentTimes MAX（2） 商户账号 支付币种 merAcct curType MAX(19) = 3 商户代码 检验联名标志 merID verifyJoinFlag MAX(20) =1 客户联名标志 JoinFlag =1 联名会员号 银行指令序号 UserNum MAX(40) MAX(30) TranSerialNo 网上银行商户手册

批次号 返回通知日期时间 订单处理状态 TranBatchNo notifyDate tranStat MAX(15) MAX(14) =1 银行端为多笔一次提交的指令生成一个唯一的批次号 格式为：YYYYMMDDHHmmss 1-“交易成功，已清算”； 2-“交易失败”； 3-“交易可疑” 错误描述 错误描述 comment MAX(100) 注：红色字体部分内容，每笔订单都有一份。

2.2.3 notifyData格式定义

notifyData格式(xml格式固定，选输字段的取值可以为空，标签需保留)

…

第 13 页 共 16 页

网上银行商户手册

注：红色字体部分，即是循环部分，最大5次，根据商户上送的数量返回。

2.2.4 表单样例

表单数据：

…… 此处隐藏：87字，全部文档内容请下载后查看。喜欢就下载吧 ……