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

网上银行商户手册

2.1.2 tranData数据定义

变量名称 接口名称 接口版本号 交易日期时间 变量命名 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代表全额付款，必须为以上数值，否则订单校验不通过。 必输，每笔订单一个，可以相同； 商户入账账号，只能交易时指定。（商户付给银行手续费的账户，可以在开户的时候指定，也可以用交易指定方式；用交易指定方式则使用此商户账号） 选输，每笔订单一个； 必输，每笔订单一个； 选输，每笔订单一个； 选输，每笔订单一个； 必输， 取值“1”：客户支付时，网银判断该客户是否与商户联名，是则按上送金额扣帐，否则展现未联名错误； 取值“0”：不检验客户是否与商户联名，按上送金额扣帐。 第 6 页 共 16 页

订单号 orderid MAX(30) 订单金额 amount MAX(10) 分期付款期数 installmentTimes MAX（2） 商户账号 merAcct MAX(19) 商品编号 商品名称 商品数量 已含运费金额 检验联名标志 goodsID goodsName goodsNum carriageAmt verifyJoinFlag MAX(30) MAX(60) MAX(10) MAX(10) =1 网上银行商户手册

语言版本 Language MAX(10) 选输，默认为中文版 取值：“EN_US”为英文版； 取值：“ZH_CN”或其他为中文版。 注意：大小写敏感。 必输， 用来区分一笔支付的币种，目前工行只支持使用人民币（001）支付。 取值： “001” 必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。 必输 默认“2”。取值范围为0、1、2，其中0表示仅允许使用借记卡支付，1表示仅允许使用信用卡支付，2表示借记卡和信用卡都能对订单进行支付 必输 在交易转账处理完成后把交易结果通知商户的处理模式。 取值“HS”：在交易完成后实时将通知信息以HTTP协议POST方式，主动发送给商户，发送地址为商户端随订单数据提交的接收工行支付结果的URL即表单中的merURL字段； 取值“AG”：在交易完成后不通知商户。商户需使用浏览器登录工行的B2C商户服务网站，或者使用工行提供的客户端程序API主动获取通知信息。 选输 取值“0”：无论支付成功或者失败，银行都向商户发送交易通知信息； 取值“1”，银行只向商户发送交易成功的通知信息。 只有通知方式为HS时此值有效，如果使用AG方式，可不上送此项，但签名数据中必须包含此项，取值可为空。 选输，上送商户网站域名，如果上送，工行会在客户支付订单时，校验商户上送域名与客户跳转工行支付页面之前网站域名的一致性。 选输，工行在支付页面显示该信息。 必输 第 7 页 共 16 页

支付币种 curType = 3 商户代码 merID MAX(20) 支持订单支付的银行卡种类 creditType = 1 通知类型 notifyType = 2 结果发送类型 resultType =1 商户reference merReference MAX(200) 客户端IP 虚拟商品/实merCustomIp goodsType MAX(20) =1 网上银行商户手册

物商品标志位 买家用户号 买家联系电话 收货地址 订单备注 商城提示 备注字段1 备注字段2 merCustomID merCustomPhone goodsAddress merOrderRemark merHint remark1 remark2 MAX(100) MAX(20) MAX(200) MAX(200) MAX(120) MAX(100) MAX(100) MAX(1024) 取值“0”：虚拟商品； 取值“1”，实物商品。 选输 选输，当商户上送goodsType值为“0”，该项必输 选输，当商户上送goodsType值为“1”，该项必输 选输，工行在支付页面显示该信息。 选输 选输 单位：字节 选输 单位：字节 必输 必须合法的URL，交易结束，将客户引导到商户的此url，即通过客户浏览器post交易结果信息到商户的此URL 选输 商户自定义，当返回银行结果时，作为一个隐藏域变量，商户可以用此变量维护session等等。由客户端浏览器支付完成后提交通知结果时是明文传输，建议商户对此变量使用额外安全防范措施，如签名、base64 返回商户URL merURL 返回商户变量 merVAR MAX(1024) 注：红色字体部分内容，每笔订单都有一份。 …… 此处隐藏：286字，全部文档内容请下载后查看。喜欢就下载吧 ……