中国工商银行B2C网银接口说明.doc

中国工商银行网上银行 B2C在线支付 接口说明书 2010年5月 变更履历 序号 版本 变更描述 修订人/日期 审核/日期 批准/日期 0.1 编写初稿 曾凯3/3/10 李林 李林 1.0 发布 曾凯3/22/1- 李林 李林 目录 TOC \o 1-3 \h \z \u 一、B2C流程说明： 4 二、B2C接口数据说明： 5 2.1 B2C商户提交表单接口定义： 5 2.2 商户提交表单签名merSignMsg格式： 8 2.3 B2C通知商户交易结果接口定义： 9 2.4 通知消息银行签名数据signMsg格式： 10 2.5 商户可能收到的银行通知： 11 2.6商户返回取货地址： 12 三、安全API说明： 12 四、开发步骤 13 五、样例： 15 商户提交订单form 15 银行通知http报文： 16 商户返回取货地址报文： 17  一、B2C流程说明： 1、客户在商户网站浏览商品信息，签订订单； 2、商户按照工行B2C订单数据规范形成提交数据，并使用工行提供API和商户证书对订单数据签名，形成form表单返回客户浏览器，表单action地址指向工行接收商户B2C订单信息的servlet； 3、客户确认使用工行支付后，提交此表单到工行； 4、工行网银系统接收此笔B2C订单，对订单信息和商户信息进行检查，通过检查则显示工行B2C支付页面； 5、客户在此页面可以查询客户在银行的预留信息；也可以输入支付卡号、支付密码、验证码进行B2C支付； 6、工行检查客户信息，通过检查后显示确认页面；客户确认提交后工行进行支付指令处理； 7、工行进行支付指令处理后，如果商户需要工行实时通知，则工行将处理结果使用http协议post方式将通知消息数据提交到商户网站（这个接收银行通知消息的商户端地址是随商户订单数据提交银行的merURL字段），商户返回取货地址或关闭这个银行与其建立的连接后，银行才显示交易结果页面给客户。（注意1、发送通知和显示结果页面是串行的，所以商户端接收银行通知处理时间太长可能导致客户等待超时，造成银行不能将交易结果页面显示给客户。2、此连接是银行服务器自动和商户进行的连接，商户返回也是直接返回给银行，商户端不能对银行的这个请求进行重定向。） 8、工行进行支付指令处理后，如果商户不需要工行实时通知，则工行直接显示交易结果给客户。 二、B2C接口数据说明： 接口数据格式定义通过接口名称和接口版本号来标识，以便将来的扩展；以下数据格式为“”版的“ICBC_PERBANK_B2C”接口定义。 2.1 B2C商户提交表单接口定义： 变量名称 变量命名 长度定义 说明 接口名称 interfaceName MAX(30) 必输，签名， 取值：“ICBC_PERBANK_B2C” 接口版本号 interfaceVersion MAX(15) 必输，签名， 取值：“” 订单号 orderid MAX(30) 必输，签名， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。 订单金额 amount MAX(10) 必输，签名， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。 支付币种 curType = 3 必输，签名， 用来区分一笔支付的币种，目前工行只支持使用人民币（001）支付。 取值： “001” 商户代码 merID MAX(20) 必输，签名， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。 商城账号 merAcct MAX(19) 必输，签名， 商城收费入账账号 （只能交易时指定）。 检验联名标志 verifyJoinFlag =1 必输，签名。 取值“1”：客户支付时，网银判断该客户是否与商户联名，是则按上送金额扣帐，否则展现未联名错误； 取值“0”：不检验客户是否与商户联名，按上送金额扣帐。 通知类型 notifyType = 2 必输，签名， 在交易转账处理完成后把交易结果通知商户的处理模式。 取值“HS”：在交易完成后实时将通知信息以HTTP协议POST方式，主动发送给商户，发送地址为商户端随订单数据提交的接收工行支付结果的URL即表单中的merURL字段； 取值“AG”：在交易完成后不通知商户。商户需使用浏览器登录工行的B2C商户服务网站，或者使用工行提供的客户端程序API主动获取通知信息。 接收支付结果信息通知程序地址 merURL MAX (200) 选输，签名， 使用HS通知类型的商户用来接收工行订单支付结果的URL；银行使用HTTP协议POST方式向此地址发送通知信息；目前只支持8