企业银行商务支付系统

企业银行商务支付系统WEB版开发指南version3.0招商银行ChinaMerchantsBank版权所有不得复制招商银行企业银行商务支付系统开发指南1修订记录日期修订版本修订人修订内容2012-4-271.0杨成海2014-5-292.0徐蓓增加3.3.4支付内部户订单和3.3.5预保留订单；增加4.1.2支付结果通知（支付收方内部户和预保留）；修改3.3.1支付订单、电票出票订单、电票背书订单增加字段“支付结果通知地址”；修改4.3通知地址设置。2015-5-253.0徐蓓增加6.自颁发文件证书;3.3订单信息增加字段“文件证书签名时间戳”；修改2.2和3.1增加自颁发证书流程相关说明。目录1、前言....................................................................31．1．概述..............................................................31．2．背景..............................................................31．3．阅读对象..........................................................31．4．术语定义..........................................................32、解决方案................................................................42．1．概述..............................................................42．2．结构示意图........................................................42．3．客户端要求........................................................73、订单支付................................................................83．1．重要说明..........................................................83．2．charset（信息编码）..............................................93．3．order（订单信息）................................................93.3.1支付订单.......................................................93.3.2电票出票支付订单..............................................103.3.3电票背书支付订单..............................................113.3.4支付收方内部户订单（适用并笔入账）............................133.3.5预保留订单....................................................143．4．sigdat（签名信息）..............................................15招商银行企业银行商务支付系统开发指南23．5．result（返回信息）..............................................153．6．范例.............................................................164、支付结果通知...........................................................184．1．订单支付结果通知.................................................184.1.1支付结果通知..................................................184.1.2支付结果通知(支付收方内部户和预保留)..........................194．2．商户应答.........................................................214．3．通知地址设置.....................................................214．4．通知结果查询.....................................................225、银企直联...............................................................235．1．订单状态信息查询.................................................235．2．验证签名.........................................................235．3．生成签名.........................................................236、自颁发文件证书.........................................................246．1．自颁发证书生成...................................................246．2．验证签名.........................................................256．3．生成签名.........................................................276．4．JAVA开发包下载和说明............................................287、支付测试流程示例.......................................................307．1．生成签名.........................................................307.1.1编辑订单签名报文..............................................307.1.2启动并登录银企直联前置机......................................307.1.3通过直联程序生成订单信息签名..................................327．2．根据订单信息及签名信息完成支付操作...............................347．5．验证银行签名.....................................................377.5.1通过直联程序验证经办结果签名..................................377.5.2通过开发包验证经办结果签名....................................388、附录...................................................................398．1．数据类型约定.....................................................39招商银行企业银行商务支付系统开发指南31、前言1．1．概述本开发指南对招商银行企业银行商务支付系统（以下简称本系统）进行详细地描述，通过该指南可以对本系统有个全面地了解，并可用于指导网站如何与该系统进行交互，实现商务支付1．2．背景目前网站有自己的信息流和物流管理，唯独缺少与之相配套的支付手段（既电子商务的资金流的一部分）。企业银行的商务支付业务就是基于银行作为支付手段的提供者，参与该业务流程的一种方案，以便实现初步的电子商务支付功能。1．3．阅读对象预期读者为实现和本系统进行交互的开发人员，以及其他需要了解本系统的人员。1．4．术语定义订单：由网站产生的，包含企业购买商品或享受服务的要素的信息，包括支付信息和业务信息。商务支付：网站产生的订单通过企业银行完成订单支付等功能的业务。招商银行企业银行商务支付系统开发指南42、解决方案2．1．概述本系统整合在招商银行企业银行公众版中，与商务支付旧版本向下兼容。网站将订单信息以post的方式提交到银行指定网页，买家在该网页上进行支付。买家操作时无需安装客户端软件（使用windows系统自带的IE浏览器），系统维护升级时也会自动进行无需人工干预。2．2．结构示意图图1.商户使用网银证书的流程图企业银行大众版服务器企业商户网站订单提交①订单信息和签名结果③支付信息③订单支付④支付结果及签名⑤招行直联前置机签名②/验签⑥数据库订单信息验签入库/查询订单结果服务器签名公钥下载/订单查询招商银行企业银行商务支付系统开发指南5企业商户网站企业银行大众版服务器1.订单提交自颁发文件证书私钥企业网银公钥2.签名3.订单信息和签名4.订单支付5.支付经办结果和银行签名5支付经办结果6.验证签名0.自颁发证书0.下载公钥3.支付信息确认图2.商户使用自颁发证书流程图自颁发证书/下载公钥：如果商户使用文件证书，则需要商户的企业网银管理员登录企业网银给自己颁发证书。颁发后下载商户的文件证书和企业网银的公钥或证书。订单提交：企业在网站上购物，提交订单进行支付。签名：网站生成该企业的订单，并通过直联前置机对订单信息进行签名。签名可以使用商户的网银硬件证书（u-key）通过银企直联系统完成，也可以通过企业自签发的文件证书完成。订单信息和签名：网站将订单信息以及签名结果post到招行指定的网页。支付信息确认：企业确认订单信息是否正确，正确后登录企业银行公众版进行订单支付。招商银行企业银行商务支付系统开发指南6订单支付：企业对该订单进行支付（蓝色区域表示不可修改）支付经办结果及签名：订单支付后，银行通知商户该订单的支付经办结果及支付经办结果签名信息。数据以HTTP协议post的形式将表单提交到商户指定的网址，招商银行企业银行商务支付系统开发指南7数据编码与商户提交订单信息时的编码一致。（例如商户以GB2312编码提交订单信息到银行，这里则以同样的编码GB2312返回）验证签名：商户对支付经办结果及支付经办结果签名进行验签，保证银行系统传过来的数据没有被篡改（可选步骤）。验证签名可以通过银企直联前置机完成，也可以通过开发包（jar）完成。如果通过前置机完成，则不需要输入公钥，前置机会自动下载公钥，如果通过开发包则需要通过企业网银下载招行企业网银证书（含公钥）。2．3．客户端要求系统要求硬件：建议Pentium133以上CPU，1GBRAM，至少256色（建议16位以上真彩）显示，10G以上的空闲硬盘空间。对数字证书卡用户，需要一个串口或USB口，用于安装数字证书卡驱动器；操作系统：建议中文/英文WINDOWSXP/2003/7/2008，对英文WINDOWS，需要外挂中文平台；浏览器：必须安装MicrosoftInternetExplorer6.0或6.0版本以上的浏览器。本