企业银行商务支付系统.DOC

1、企业银行商务支付系统WEB 版开发指南version 3.0招商银行China Merchants Bank版权所有 不得复制招商银行 企业银行商务支付系统开发指南1修订记录日期 修订版本 修订人 修订内容2012-4-27 1.0 杨成海2014-5-29 2.0 徐蓓增加 3.3.4 支付内部户订单和 3.3.5 预保留订单；增加 4.1.2 支付结果通知（支付收方内部户和预保留） ；修改 3.3.1 支付订单、电票出票订单、电票背书订单增加字段“支付结果通知地址” ；修改 4.3 通知地址设置。2015-5-25 3.0 徐蓓增加 6.自颁发文件证书;3.3 订单信息增加字段“文件证书签

2、名时间戳” ；修改 2.2 和 3.1 增加自颁发证书流程相关说明。目 录1、前言 .311 概述 .312 背景 .313 阅读对象 .314 术语定义 .32、解决方案 .421 概述 .422 结构示意图 .423 客户端要求 .63、订单支付 .831 重要说明 .832 charset（信息编码） .933 order（订单信息） .93.3.1 支付订单 .93.3.2 电票出票支付订单 .103.3.3 电票背书支付订单 .113.3.4 支付收方内部户订单（适用并笔入账） .123.3.5 预保留订单 .1334 sigdat（签名信息） .14招商银行 企业银行商务支付系统开

3、发指南235 result（返回信息） .1436 范例 .154、支付结果通知 .1741 订单支付结果通知 .174.1.1 支付结果通知 .174.1.2 支付结果通知(支付收方内部户和预保留) .1842 商户应答 .2043 通知地址设置 .2044 通知结果查询 .215、银企直联 .2251 订单状态信息查询 .2252 验证签名 .2253 生成签名 .226、自颁发文件证书 .2361 自颁发证书生成 .2362 验证签名 .2463 生成签名 .2664 JAVA 开发包下载和说明 .277、支付测试流程示例 .2971 生成签名 .297.1.1 编辑订单签名报文 .29

4、7.1.2 启动并登录银企直联前置机 .297.1.3 通过直联程序生成订单信息签名 .3172 根据订单信息及签名信息完成支付操作 .3375 验证银行签名 .367.5.1 通过直联程序验证经办结果签名 .367.5.2 通过开发包验证经办结果签名 .378、附录 .3881 数据类型约定 .38招商银行 企业银行商务支付系统开发指南31、 前言11概述本开发指南对招商银行企业银行商务支付系统（以下简称本系统）进行详细地描述，通过该指南可以对本系统有个全面地了解，并可用于指导网站如何与该系统进行交互，实现商务支付12背景目前网站有自己的信息流和物流管理，唯独缺少与之相配套的支付手段（既电子

5、商务的资金流的一部分） 。企业银行的商务支付业务就是基于银行作为支付手段的提供者，参与该业务流程的一种方案，以便实现初步的电子商务支付功能。13阅读对象预期读者为实现和本系统进行交互的开发人员，以及其他需要了解本系统的人员。14术语定义订单：由网站产生的，包含企业购买商品或享受服务的要素的信息，包括支付信息和业务信息。商务支付：网站产生的订单通过企业银行完成订单支付等功能的业务。招商银行 企业银行商务支付系统开发指南42、解决方案21概述本系统整合在招商银行企业银行公众版中，与商务支付旧版本向下兼容。网站将订单信息以 post 的方式提交到银行指定网页，买家在该网页上进行支付。买家操作时无需安

6、装客户端软件（使用 windows 系统自带的 IE 浏览器） ，系统维护升级时也会自动进行无需人工干预。22结构示意图企业银行大众版服务器企业 商户网站订单提交订单信息和签名结果支付信息 订单支付 支付结果及签名招行直联前置机签名/验签数据库订单信息验签入库/查询订单结果服务器签名公钥下载/订单查询图 1. 商户使用网银证书的流程图企业 商户网站企业银行大众版服务器1 . 订单提交自颁发文件证书私钥企业网银公钥2 . 签名3 . 订单信息和签名4 . 订单支付5 . 支付经办结果和银行签名5 支付经办结果6 . 验证签名0 . 自颁发证书0 . 下载公钥3 . 支付信息确认招商银行 企业银行

7、商务支付系统开发指南5图 2. 商户使用自颁发证书流程图 自颁发证书/下载公钥： 如果商户使用文件证书，则需要商户的企业网银管理员登录企业网银给自己颁发证书。颁发后下载商户的文件证书和企业网银的公钥或证书。 订单提交：企业在网站上购物，提交订单进行支付。 签名：网站生成该企业的订单，并通过直联前置机对订单信息进行签名。签名可以使用商户的网银硬件证书（u-key）通过银企直联系统完成，也可以通过企业自签发的文件证书完成。 订单信息和签名：网站将订单信息以及签名结果 post 到招行指定的网页。 支付信息确认：企业确认订单信息是否正确，正确后登录企业银行公众版进行订单支付。 订单支付：企业对该订单

8、进行支付（蓝色区域表示不可修改）招商银行 企业银行商务支付系统开发指南6 支付经办结果及签名：订单支付后，银行通知商户该订单的支付经办结果及支付经办结果签名信息。数据以 HTTP 协议 post 的形式将表单提交到商户指定的网址，数据编码与商户提交订单信息时的编码一致。 （例如商户以 GB2312 编码提交订单信息到银行，这里则以同样的编码 GB2312 返回） 验证签名：商户对支付经办结果及支付经办结果签名进行验签，保证银行系统传过来的数据没有被篡改（可选步骤） 。验证签名可以通过银企直联前置机完成，也可以通过开发包（jar）完成。如果通过前置机完成，则不需要输入公钥，前置机会自动下载公钥，

9、如果通过开发包则需要通过企业网银下载招行企业网银证书（含公钥） 。23客户端要求系统要求 硬件：建议 Pentium133 以上 CPU，1GB RAM，至少 256 色（建议 16 位以上真彩）显示，10G 以上的空闲硬盘空间。对数字证书卡用户，需要一个串口或USB 口，用于安装数字证书卡驱动器； 操作系统：建议中文/英文 WINDOWS XP/2003/7/2008，对英文 WINDOWS，需要外挂中文平台； 浏览器：必须安装 Microsoft Internet Explorer 6.0 或 6.0 版本以上的招商银行 企业银行商务支付系统开发指南7浏览器。本系统不支持 Netscape

10、 的浏览器； 系统环境：应确保系统中没有病毒、木马等有害程序。企业要求 开通招行企业银行（版本 V4.0 以上） ； 开通商务支付等业务，经办用户需要拥有招行签发的数字证书卡。招商银行 企业银行商务支付系统开发指南83、 订单支付31重要说明 网站将订单及订单签名数据以 post 的形式将表单提交到招行指定网址。 post 的信息包括：域 order（订单信息，必输） 、域 sigdat（订单签名，可空） 、域 charset（信息编码，可空，空表示订单信息为 gb2312 编码） 。域数据如果没有特别说明，都采用以下的数据格式：1、每条记录以0 结束； 2、每条记录由多个字段组成，字段间用“

11、 ;“(空格加分号)分开，各个字段格式为：字段名=数值； 3、字段之间没有顺序关系； 4、如果某个字段对应的数值为空，则该字段可以省略； 5、字段如果对应日期，格式为：yyyymmdd；对应时间，格式为： hhmmss；对应日期+时间，格式为：yyyymmddhhmmss； 6、字段如果对应金额，以元为单位，格式为：nnnnnnnnnnnnn.nn，整数部分最多13 位，小数部分最多 2 位。订单提交的地址：【测试环境】无签名：http:/58.61.30.110/CmbBank_GenShell/UI/GenShellPC/Login/B2B/OrderConfirm.aspx网银证书签名：

12、测试环境暂时无法签名，因为没有提供硬件 key。http:/58.61.30.110/CmbBank_GenShell/UI/GenShellPC/Login/B2B/OrderConfirmSigned.aspx自颁发文件证书签名：http:/58.61.30.110/CmbBank_GenShell/UI/GenShellPC/Login/B2B/OrderConfirmSS.aspx【生产环境】无签名：建议生产环境不要使用没有商户签名的订单提交，该功能仅作向下兼容支持。https:/ 企业银行商务支付系统开发指南9提示：由于测试环境无法发硬件网银 key，所以无法在公网测试环境测试网银

13、证书签名的清单提交。因此如果要使用网银证书签名，请在测试环境先测试无签名的订单提交，上线前在生产环境验证签名版本。32charset（信息编码）由商户指定 order 域(订单信息)编码，WEB 版商务支付新增域，可填 gb2312 或 utf-8，空默认为 gb2312。result(返回信息)编码与 order 域(订单信息)编码相同。33order （订单信息）Order 为单记录；现在支持 3 种订单（与旧版商务支付 3.1 版保持一致）：支付订单、电票出票支付订单、电票背书支付订单。3.3.1 支付订单支付订单名称 代码 类型 可空 描述商户编号 MCHNBR C(10) 否 网站的

14、企业银行商户编号订单号 REFORD C(40) 否订单支付号 SUBORD C(10) 是订单号+订单支付号必须唯一查询对账单时，可查到订单号+订单支付号信息，但只显示 20 个字符，因此建议商户生成的订单号+订单支付号长度不要超过 20个字符订单币种 CCYNBR C(2) 否 如 10 表示人民币订单金额 TRSAMT M 否收方账号 CRTACC C(35) 否 该账号的币种必须与订单币种字段相符收方账户名 CRTNAM Z(62) 否收方开户行 CRTBNK Z(62) 否 收方账号开户行名称，如：招商银行北京分行收方省份 CRTPVC Z(16) 否 收方账号开户行所在的省份，格式为：XX省（或市或自治区） 。如：广东省、北京市或新疆维吾尔自治区等。收方城市 CRTCTY Z(20) 否 收款方账号开户行所在的城市名，指市或省辖行政单位。如：深圳市。对直辖市，该字段可空。收方县/区 CRTDTR Z(20) 是 收方账号开户行所在的县或区，如：宝安区。订单失效日期 CNLDAT D 是 企业必须在该日期前完成经办和审批，否则