招商银行网上企业银行嵌入式直连方案.docx

1、招商银行网上企业银行嵌入式直连方案企业银行商务支付系统WEB版开发指南version 3.0招商银行China Merchants Bank版权所有 不得复制修订记录日期修订版本修订人修订内容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增加自颁发证书流程相

2、关说明。1、前言11概述本开发指南对招商银行企业银行商务支付系统（以下简称本系统）进行详细地描述，通过该指南可以对本系统有个全面地了解，并可用于指导网站如何与该系统进行交互，实现商务支付12背景目前网站有自己的信息流和物流管理，唯独缺少与之相配套的支付手段（既电子商务的资金流的一部分）。企业银行的商务支付业务就是基于银行作为支付手段的提供者，参与该业务流程的一种方案，以便实现初步的电子商务支付功能。13阅读对象预期读者为实现和本系统进行交互的开发人员，以及其他需要了解本系统的人员。14术语定义订单：由网站产生的，包含企业购买商品或享受服务的要素的信息，包括支付信息和业务信息。商务支付：网站产生

3、的订单通过企业银行完成订单支付等功能的业务。2、解决方案21概述本系统整合在招商银行企业银行公众版中，与商务支付旧版本向下兼容。网站将订单信息以post的方式提交到银行指定网页，买家在该网页上进行支付。买家操作时无需安装客户端软件（使用windows系统自带的IE浏览器），系统维护升级时也会自动进行无需人工干预。22结构示意图 图1. 商户使用网银证书的流程图 图2. 商户使用自颁发证书流程图 自颁发证书/下载公钥： 如果商户使用文件证书，则需要商户的企业网银管理员登录企业网银给自己颁发证书。颁发后下载商户的文件证书和企业网银的公钥或证书。 订单提交：企业在网站上购物，提交订单进行支付。 签名

4、：网站生成该企业的订单，并通过直联前置机对订单信息进行签名。签名可以使用商户的网银硬件证书（u-key）通过银企直联系统完成，也可以通过企业自签发的文件证书完成。 订单信息和签名：网站将订单信息以及签名结果post到招行指定的网页。 支付信息确认：企业确认订单信息是否正确，正确后登录企业银行公众版进行订单支付。 订单支付：企业对该订单进行支付（蓝色区域表示不可修改） 支付经办结果及签名：订单支付后，银行通知商户该订单的支付经办结果及支付经办结果签名信息。数据以HTTP协议post的形式将表单提交到商户指定的网址，数据编码与商户提交订单信息时的编码一致。（例如商户以GB2312编码提交订单信息到

5、银行，这里则以同样的编码GB2312返回） 验证签名：商户对支付经办结果及支付经办结果签名进行验签，保证银行系统传过来的数据没有被篡改（可选步骤）。验证签名可以通过银企直联前置机完成，也可以通过开发包（jar）完成。如果通过前置机完成，则不需要输入公钥，前置机会自动下载公钥，如果通过开发包则需要通过企业网银下载招行企业网银证书（含公钥）。23客户端要求系统要求 硬件：建议Pentium133以上CPU，1GB RAM，至少256色（建议16位以上真彩）显示，10G以上的空闲硬盘空间。对数字证书卡用户，需要一个串口或USB口，用于安装数字证书卡驱动器； 操作系统：建议中文/英文WINDOWS X

6、P/2003/7/2008，对英文WINDOWS，需要外挂中文平台； 浏览器：必须安装Microsoft Internet Explorer 6.0或6.0版本以上的浏览器。本系统不支持Netscape的浏览器； 系统环境：应确保系统中没有病毒、木马等有害程序。企业要求 开通招行企业银行（版本V4.0以上）； 开通商务支付等业务，经办用户需要拥有招行签发的数字证书卡。3、订单支付31重要说明 网站将订单及订单签名数据以post的形式将表单提交到招行指定网址。post的信息包括：域order（订单信息，必输）、域sigdat（订单签名，可空）、域charset（信息编码，可空，空表示订单信息为g

7、b2312编码）。域数据如果没有特别说明，都采用以下的数据格式：1、每条记录以0结束； 2、每条记录由多个字段组成，字段间用 ;(空格加分号)分开，各个字段格式为：字段名=数值； 3、字段之间没有顺序关系； 4、如果某个字段对应的数值为空，则该字段可以省略； 5、字段如果对应日期，格式为：yyyymmdd；对应时间，格式为：hhmmss；对应日期+时间，格式为：yyyymmddhhmmss； 6、字段如果对应金额，以元为单位，格式为：nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分最多2位。订单提交的地址：【测试环境】无签名： http:/58.61.30.110/CmbBank

8、_GenShell/UI/GenShellPC/Login/B2B/OrderConfirm.aspx网银证书签名：测试环境暂时无法签名，因为没有提供硬件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【生产环境】无签名：建议生产环境不要使用没有商户签名的订单提交，该功能仅作向下兼容支持。网银证

9、书签名：自颁发文件证书签名：https:/ 提示：由于测试环境无法发硬件网银key，所以无法在公网测试环境测试网银证书签名的清单提交。因此如果要使用网银证书签名，请在测试环境先测试无签名的订单提交，上线前在生产环境验证签名版本。32charset（信息编码） 由商户指定order域(订单信息)编码，WEB版商务支付新增域，可填gb2312或utf-8，空默认为gb2312。result(返回信息)编码与order域(订单信息)编码相同。33order（订单信息）Order为单记录；现在支持3种订单（与旧版商务支付3.1版保持一致）：支付订单、电票出票支付订单、电票背书支付订单。3.3.1 支付

10、订单支付订单名称代码类型可空描述商户编号MCHNBRC(10)否网站的企业银行商户编号订单号REFORDC(40)否订单号+订单支付号必须唯一查询对账单时，可查到订单号+订单支付号信息，但只显示20个字符，因此建议商户生成的订单号+订单支付号长度不要超过20个字符订单支付号SUBORDC(10)是订单币种CCYNBRC(2)否如10表示人民币订单金额TRSAMTM否收方账号CRTACCC(35)否该账号的币种必须与订单币种字段相符收方账户名CRTNAMZ(62)否收方开户行CRTBNKZ(62)否收方账号开户行名称，如：招商银行北京分行收方省份CRTPVCZ(16)否收方账号开户行所在的省份，

11、格式为：XX省（或市或自治区）。如：广东省、北京市或新疆维吾尔自治区等。收方城市CRTCTYZ(20)否收款方账号开户行所在的城市名，指市或省辖行政单位。如：深圳市。对直辖市，该字段可空。收方县/区CRTDTRZ(20)是收方账号开户行所在的县或区，如：宝安区。订单失效日期CNLDATD是企业必须在该日期前完成经办和审批，否则该订单失效如果该字段为空，则订单失效日期=订单产生日期+商户开户时指定的失效天数经办失效日期INVDATD是如果这两个字段都非空，则企业必须在经办失效日期和经办失效时间前完成经办，否则该订单失效经办失效时间INVTIMT是中间节点标志KEYACCC(1)是是否多收方中间节

12、点账户（空表示N）Y：是N：否注意：已无用，请填空或N再确认标志ORDCFMC(1)是订单是否需要商户再确认（空表示N）Y：是N：否电子邮件NTFCH1C(36)是用于交易成功后的邮件通知移动电话NTFCH2C(16)是用于交易成功后的邮件通知回调地址RETURLC(100)是用于通知商户企业的经办结果，具体见3.5返回信息校验码CHKNUMC(30)是支付结果通知地址FINURLC(100)是4.3通知地址设置设置支付结果通知地址。如果按通知发送不同地址则该字段必填。如果按商户发送统一地址则不用填写。用途NUSAGEZ(62)是企业支付时，可修改该字段内容业务摘要BUSNARZ(200)是企

13、业支付时，可修改该字段内容文件证书签名时间戳SIGTIMC(18)是文件证书签名有效，可空。如果有值则会检测签名时间与服务器的时间差，不能超过1小时。格式：yyyyMMddHHmmssffff。3.3.2电票出票支付订单电票出票支付订单名称代码类型可空描述商户编号MCHNBRC(10)否网站的企业银行商户编号订单号REFORDC(40)否订单号+订单支付号必须唯一查询对账单时，可查到订单号+订单支付号信息，但只显示20个字符，因此建议商户生成的订单号+订单支付号长度不要超过20个字符订单支付号SUBORDC(10)是合同号CTRNBRC(40)是合同描述CTRDSPZ(62)是订单币种CCYN

14、BRC(2)否如10表示人民币订单金额TRSAMTM否收方账号CRTACCC(35)否该账号的币种必须与订单币种字段相符收方账户名CRTNAMZ(62)否收方联行号CRTBRDC(30)否收方人行联行号订单失效日期CNLDATD是企业必须在该日期前完成经办和审批，否则该订单失效如果该字段为空，则订单失效日期=订单产生日期+商户开户时指定的失效天数经办失效日期INVDATD是如果这两个字段都非空，则企业必须在经办失效日期和经办失效时间前完成经办，否则该订单失效经办失效时间INVTIMT是回调地址RETURLC(100)是用于通知商户企业的经办结果，具体见3.5返回信息校验码CHKNUMC(30)

15、是支付结果通知地址FINURLC(100)是4.3通知地址设置设置支付结果通知地址。如果按通知发送不同地址则该字段必填。如果按商户发送统一地址则不用填写。支付方式PAYTYPC(1)是0：转账支付（默认值）1：电票出票2：电票背书支付方式是否可编辑PTPEDTC(1)是Y: 买方可编辑N: 买方不可编辑（默认值）注意：如果设置为可编辑则要把3种订单的非空要素都给全承兑人信息是否可编辑ACPEDTC(1)是Y: 买方企业指定承兑人N: 买方企业不能修改承兑人（商户指定承兑人）（默认值）承兑人名称ACPNAMZ(62)是如果承兑人信息不可编辑，则承兑人信息必填。承兑人账号ACPACCC(35)是承

16、兑人行号ACPBRDC(12)是文件证书签名时间戳SIGTIMC(18)是文件证书签名有效，可空。如果有值则会检测签名时间与服务器的时间差，不能超过1小时。格式：yyyyMMddHHmmssffff。3.3.3电票背书支付订单电票背书支付订单名称代码类型可空描述商户编号MCHNBRC(10)否网站的企业银行商户编号订单号REFORDC(40)否订单号+订单支付号必须唯一查询对账单时，可查到订单号+订单支付号信息，但只显示20个字符，因此建议商户生成的订单号+订单支付号长度不要超过20个字符订单支付号SUBORDC(10)是合同号CTRNBRC(40)是合同描述CTRDSPZ(62)是订单币种C

17、CYNBRC(2)否如10表示人民币订单金额TRSAMTM否被背书人账号CRTACCC(35)否该账号的币种必须与订单币种字段相符被背书人名称CRTNAMZ(200)否被背书人联行号CRTBRDC(30)否人行联行号订单失效日期CNLDATD是企业必须在该日期前完成经办和审批，否则该订单失效如果该字段为空，则订单失效日期=订单产生日期+商户开户时指定的失效天数经办失效日期INVDATD是如果这两个字段都非空，则企业必须在经办失效日期和经办失效时间前完成经办，否则该订单失效经办失效时间INVTIMT是回调地址RETURLC(100)是用于通知商户企业的经办结果，具体见3.5返回信息校验码CHKN

18、UMC(30)是支付结果通知地址FINURLC(100)是4.3通知地址设置设置支付结果通知地址。如果按通知发送不同地址则该字段必填。如果按商户发送统一地址则不用填写。支付方式PAYTYPC(1)是0：转账支付（默认值）1：电票出票2：电票背书支付方式是否可编辑PTPEDTC(1)是Y: 买方可编辑N: 买方不可编辑（默认值）注意：如果设置为可编辑则要把3种订单的非空要素都给全文件证书签名时间戳SIGTIMC(18)是文件证书签名有效，可空。如果有值则会检测签名时间与服务器的时间差，不能超过1小时。格式：yyyyMMddHHmmssffff。3.3.4支付收方内部户订单（适用并笔入账）注意：如

19、要使用该类型订单，请先咨询招行交易银行部。支付收方内部户订单（适用并笔入账）名称代码类型可空描述商户编号MCHNBRC(10)否网站的企业银行商户编号订单号REFORDC(40)否订单号+订单支付号必须唯一查询对账单时，可查到订单号+订单支付号信息，但只显示20个字符，因此建议商户生成的订单号+订单支付号长度不要超过20个字符订单支付号SUBORDC(10)是订单币种CCYNBRC(2)否如10表示人民币订单金额TRSAMTM否订单失效日期CNLDATD是企业必须在订单失效日期和时间前完成经办和审批，否则该订单失效如果订单失效日期为空，则订单失效日期=订单产生日期+商户开户时指定的失效天数订单

20、失效时间CNLTIMT是经办失效日期INVDATD是如果这两个字段都非空，则企业必须在经办失效日期和经办失效时间前完成经办，否则该订单失效经办失效时间INVTIMT是再确认标志ORDCFMC(1)是订单是否需要商户再确认（空表示N）Y：是N：否电子邮件NTFCH1C(36)是用于交易成功后的邮件通知移动电话NTFCH2C(16)是用于交易成功后的邮件通知回调地址RETURLC(100)是用于通知商户企业的经办结果，具体见3.5返回信息校验码CHKNUMC(30)是支付结果通知地址FINURLC(100)是4.3通知地址设置设置支付结果通知地址。如果按通知发送不同地址则该字段必填。如果按商户发送

21、统一地址则不用填写。支付方式PAYTYPC(1)否3：支付内部户用途NUSAGEZ(62)是企业支付时，可修改该字段内容业务摘要BUSNARZ(200)是企业支付时，可修改该字段内容文件证书签名时间戳SIGTIMC(18)是文件证书签名有效，可空。如果有值则会检测签名时间与服务器的时间差，不能超过1小时。格式：yyyyMMddHHmmssffff。3.3.5预保留订单注意：如要使用该类型订单，请先咨询招行交易银行部。预保留订单名称代码类型可空描述商户编号MCHNBRC(10)否网站的企业银行商户编号订单号REFORDC(40)否订单号+订单支付号必须唯一查询对账单时，可查到订单号+订单支付号信

22、息，但只显示20个字符，因此建议商户生成的订单号+订单支付号长度不要超过20个字符订单支付号SUBORDC(10)是订单币种CCYNBRC(2)否如10表示人民币订单金额TRSAMTM否订单失效日期CNLDATD是企业必须在该日期前完成经办和审批，否则该订单失效如果该字段为空，则订单失效日期=订单产生日期+商户开户时指定的失效天数订单失效时间CNLTIMT是经办失效日期INVDATD是如果这两个字段都非空，则企业必须在经办失效日期和经办失效时间前完成经办，否则该订单失效经办失效时间INVTIMT是再确认标志ORDCFMC(1)是订单是否需要商户再确认（空表示N）Y：是预保留固定填Y。电子邮件N

23、TFCH1C(36)是用于交易成功后的邮件通知移动电话NTFCH2C(16)是用于交易成功后的邮件通知回调地址RETURLC(100)是用于通知商户企业的经办结果，具体见3.5返回信息校验码CHKNUMC(30)是支付结果通知地址FINURLC(100)是4.3通知地址设置设置支付结果通知地址。如果按通知发送不同地址则该字段必填。如果按商户发送统一地址则不用填写。支付方式PAYTYPC(1)否4：预保留用途NUSAGEZ(62)是企业支付时，可修改该字段内容业务摘要BUSNARZ(200)是企业支付时，可修改该字段内容文件证书签名时间戳SIGTIMC(18)是文件证书签名有效，可空。如果有值则

24、会检测签名时间与服务器的时间差，不能超过1小时。格式：yyyyMMddHHmmssffff。34sigdat（签名信息）说明：商户根据自身安全要求选择是否要签名，可空。获取方式：1.网银证书签名：通过银企直联方式，调用招商银行银企直连接口说明书6.3“生成签名”接口，生成签名信息。2.自颁发证书签名：请看本文但第6部分自颁发证书，调用签名函数生成签名。35result（返回信息）用于通知商户该订单的支付经办结果。订单支付后，数据以post的形式将表单提交到商户指定的网址，该网址由订单信息中的回调地址（RETURL）指定。post的信息放在域result（返回信息）中，包括以下几个字段名称代码类

25、型可空描述订单号REFORDC(40)应该和商户的订单信息一致订单支付号SUBORDC(10)校验码CHKNUMC(30)订单币种CCYNBRC(2)如10表示人民币订单金额TRSAMTM付方账号PAYACCC(35)付方分行号PAYBBKC(2)如75表示深圳付方分行名称C_PAYBBKC(12)如：深圳付方公司名称C_RELNBRC(60)订单请求状态ORDSTAC(3)否目前只有OPR，不会有其他状态INP：待缴费OPR：企业银行缴费经办WCF：等待商户确认CFM：确认完毕MRV：多收方处理中FIN：订单处理完成订单处理结果ORDSTSC(1)订单请求状态=完成(ORDSTA=FIN)时

26、才有效S：企业订单支付成功，多收方支付成功B：企业订单支付成功，多收方支付不成功M：商户撤销订单E：企业撤销订单H：订单过期作废F：失败36范例示例1：域order：MCHNBR=M000000001 ;REFORD=100000 ;CCYNBR=10 ;TRSAMT=100 ;CRTACC=1280087710003 ;CRTNAM=长江国际 ;CRTBNK=招商银行 ;CRTPVC=广东省 ;CRTCTY=深圳市 ;KEYACC=N ;ORDCFM=Y ;RETURL=http:/99.1.95.20/result.jsp ;CHKNUM=123域sigdat（可空）：jgVt93qByc

27、vrNu/f3kIlGG7z02Z5c0gpxIQsJB56QU9RSdyyIDsxMzAwNzg4MDU4NjcyIDtOMDAwMTA3MjIxIDu/qrei16jTwzA3IDtOMDAwMjUyOCA7MIIEeTCCA2GgAwIBAgIQIqmMGgaId4uNvTELHKFfUjANBgkqhkiG9w0BAQUFADCBhTELMAkGA1UEBhMCQ04xHTAbBgNVBAoTFENoaW5hIE1lcmNoYW50cyBCYW5rMRQwEgYDVQQLEwtDQSBTZXJ2aWNlczESMBAGA1UECBMJR3VhbmdEb25nMRowGAYDVQQDExFGaXJtIEJhbmsgQ01T