b2c在线支付接口说明.doc

中国工商银行网上银行 B2C 在线支付接口说明一、 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 ”接口定义。 B2C 商户提交表单接口定义: 变量名称变量命名长度定义说明接口名称 interfaceName MAX(30) 必输,签名, 取值:“ ICBC_PERBANK_B2C ”接口版本号 interfaceVersion MAX(15) 必输,签名, 取值:“ ”订单号 order id MAX(30) 必输,签名, 客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。订单金额 amount MAX(10) 必输,签名, 客户支付订单的总金额,一笔订单一个,以分为单位。不可以为零,必需符合金额标准。支付币种 curType =3 必输,签名, 用来区分一笔支付的币种,目前工行只支持使用人民币( 001 )支付。取值: “ 001 ”商户代码 merID MAX(20) 必输,签名, 唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。商城账号 t MAX(19) 必输,签名, 商城收费入账账号(只能交易时指定)。检验联名标志 verifyJoinFlag =1 必输,签名。取值“1”:客户支付时,网银判断该客户是否与商户联名,是则按上送金额扣帐,否则展现未联名错误; 取值“0”:不检验客户是否与商户联名,按上送金额扣帐。通知类型 notifyType =2 必输,签名, 在交易转账处理完成后把交易结果通知商户的处理模式。取值“ HS”: