企业银行商务支付WEB版开发指南10Word文件下载.docx
《企业银行商务支付WEB版开发指南10Word文件下载.docx》由会员分享，可在线阅读，更多相关《企业银行商务支付WEB版开发指南10Word文件下载.docx（30页珍藏版）》请在冰豆网上搜索。
6．2．启动并登录银企直联前置机16
6．3．通过直联程序生成订单信息签名17
6．4．根据订单信息及签名信息完成支付操作19
6．5．通过直联程序验证经办结果签名是否合法22
1、前言
1．1．概述
本开发指南对招商银行企业银行商务支付系统（以下简称本系统）进行详细地描述，通过该指南可以对本系统有个全面地了解，并可用于指导网站如何与该系统进行交互，实现商务支付
1．2．背景
目前网站有自己的信息流和物流管理，唯独缺少与之相配套的支付手段（既电子商务的资金流的一部分）。
企业银行的商务支付业务就是基于银行作为支付手段的提供者，参与该业务流程的一种方案，以便实现初步的电子商务支付功能。
1．3．阅读对象
预期读者为实现和本系统进行交互的开发人员，以及其他需要了解本系统的人员。
1．4．术语定义
订单：
由网站产生的，包含企业购买商品或享受服务的要素的信息，包括支付信息和业务信息。
商务支付：
网站产生的订单通过企业银行完成订单支付等功能的业务。
2、解决方案
2．1．概述
本系统整合在招商银行企业银行公众版中，与商务支付旧版本向下兼容。
网站将订单信息以post的方式提交到银行指定网页，买家在该网页上进行支付。
买家操作时无需安装客户端软件（使用windows系统自带的IE浏览器），系统维护升级时也会自动进行无需人工干预。
2．2．结构示意图
●订单提交：
企业在网站上购物，提交订单进行支付。
●签名：
网站生成该企业的订单，并通过直联前置机对订单信息进行签名（可选步骤）。
●订单信息和签名结果：
网站将订单信息以及签名结果post到招行指定的网页。
●支付信息：
企业确认订单信息是否正确，正确后登录企业银行公众版进行订单支付。
●订单支付：
企业对该订单进行支付（蓝色区域表示不可修改）
●支付结果及签名：
订单支付后，银行通知商户该订单的支付经办结果及支付经办结果签名信息。
数据以HTTP协议post的形式将表单提交到商户指定的网址，数据编码与商户提交订单信息时的编码一致。
（例如商户以GB2312编码提交订单信息到银行，这里则以同样的编码GB2312返回）
●验签：
商户对支付经办结果及支付经办结果签名进行验签，保证银行系统传过来的数据没有被篡改。
2．3．客户端要求
系统要求
●硬件：
建议Pentium133以上CPU，32MBRAM，至少256色（建议16位以上真彩）显示，100M以上的空闲硬盘空间。
对数字证书卡用户，需要一个串口或USB口，用于安装数字证书卡驱动器；
●操作系统：
建议中文/英文WINDOWS98/NT/2000/XP/2003，对英文WINDOWS，需要外挂中文平台；
●浏览器：
必须安装MicrosoftInternetExplorer6.0或6.0版本以上的浏览器。
本系统不支持Netscape的浏览器；
●系统环境：
应确保系统中没有病毒、木马等有害程序。
企业要求
●开通招行企业银行（版本V4.0以上）；
●开通商务支付等业务，经办用户需要拥有招行签发的数字证书卡。
3、订单支付
3．1．重要说明
网站将订单及订单签名数据以post的形式将表单提交到招行指定网址。
post的信息包括：
域order（订单信息，必输）、域sigdat（订单签名，可空）、域charset（信息编码，可空，空表示订单信息为gb2312编码）。
域数据如果没有特别说明，都采用以下的数据格式：
1、每条记录以'
\0'
结束；
2、如果是多条记录，则每条记录用"
\r\n"
分开（"
是指回车符和换行符）；
3、每条记录由多个字段组成，字段间用"
;
"
（空格加分号）分开，各个字段格式为：
字段名=数值；
4、字段之间没有顺序关系；
5、如果某个字段对应的数值为空，则该字段可以省略；
6、字段如果对应日期，格式为：
yyyymmdd；
对应时间，格式为：
hhmmss；
对应日期+时间，格式为：
yyyymmddhhmmss；
7、字段如果对应金额，以元为单位，格式为：
nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分最多2位。
订单提交的地址：
【测试环境】
无签名：
没有商户签名的订单提交只在测试环境有效。
http:
//58.61.30.110/CmbBank_GenShell/UI/GenShellPC/Login/B2B/OrderConfirm.aspx
有签名：
http:
//58.61.30.110/CmbBank_GenShell/UI/GenShellPC/Login/B2B/OrderConfirmSigned.aspx
【生产环境】
生产环境不支持没有商户签名的订单提交。
提示：
由于测试环境无法发key，所以无法在公网测试环境测试有签名的清单提交。
因此请在测试环境先测试无签名的订单提交，上线前在生产环境验证签名版本。
3．2．charset（信息编码）
由商户指定order域（订单信息）编码，WEB版商务支付新增域，可填gb2312或utf-8，空默认为gb2312。
result（返回信息）编码与order域（订单信息）编码相同。
3．3．order（订单信息）
Order为单记录；
现在支持3种订单（与旧版商务支付3.1版保持一致）：
支付订单、电票出票支付订单、电票背书支付订单。
格式如下：
支付订单
名称
代码
类型
可空
描述
商户编号
MCHNBR
C（10）
否
网站的企业银行商户编号
订单号
REFORD
C（40）
订单号+订单支付号必须唯一
查询对账单时，可查到订单号+订单支付号信息，但只显示20个字符，因此建议商户生成的订单号+订单支付号长度不要超过20个字符
订单支付号
SUBORD
是
订单币种
CCYNBR
C
（2）
如10表示人民币
订单金额
TRSAMT
M
收方账号
CRTACC
C（35）
该账号的币种必须与订单币种字段相符
收方账户名
CRTNAM
Z（62）
收方开户行
CRTBNK
收方账号开户行名称，如：
招商银行北京分行
收方省份
CRTPVC
Z（16）
收方账号开户行所在的省份，格式为：
XX省（或市或自治区）。
如：
广东省、北京市或新疆维吾尔自治区等。
收方城市
CRTCTY
Z（20）
收款方账号开户行所在的城市名，指市或省辖行政单位。
深圳市。
对直辖市，该字段可空。
收方县/区
CRTDTR
收方账号开户行所在的县或区，如：
宝安区。
订单失效日期
CNLDAT
D
企业必须在该日期前完成经办和审批，否则该订单失效
如果该字段为空，则订单失效日期=订单产生日期+商户开户时指定的失效天数
经办失效日期
INVDAT
如果这两个字段都非空，则企业必须在经办失效日期和经办失效时间前完成经办，否则该订单失效
经办失效时间
INVTIM
T
中间节点标志
KEYACC
C
（1）
是否多收方中间节点账户（空表示N）
Y：
N：
注意：
已无用，请填空或N
再确认标志
ORDCFM
订单是否需要商户再确认（空表示N）
电子邮件
NTFCH1
C（36）
用于交易成功后的邮件通知
移动电话
NTFCH2
C（16）
回调地址
RETURL
C（100）
用于通知商户企业的经办结果，具体见3.5返回信息
校验码
CHKNUM
C（30）
用途
NUSAGE
企业支付时，可修改该字段内容
业务摘要
BUSNAR
Z（200）
电票出票支付订单
合同号
CTRNBR
合同描述
CTRDSP
收方联行号
CRTBRD
收方人行联行号
支付方式
PAYTYP
0：
转账支付（默认值）
1：
电票出票
2：
电票背书
支付方式是否可编辑
PTPEDT
Y:
买方可编辑
N:
买方不可编辑（默认值）
如果设置为可编辑则要把3种订单的非空要素都给全
承兑人信息是否可编辑
ACPEDT
买方企业指定承兑人
买方企业不能修改承兑人（商户指定承兑人）（默认值）
承兑人名称
ACPNAM
如果承兑人信息不可编辑，则承兑人信息必填。
承兑人账号
ACPACC
承兑人行号
ACPBRD
C（12）
电票背书支付订单
被背书人账号
被背书人名称
被背书人联行号
人行联行号
3．4．sigdat（签名信息）
说明：
商户根据自身安全要求选择是否要签名，可空。
获取方式：
通过银企直联方式，调用《招商银行银企直连接口说明书》6.3“生成签名”接口，生成签名信息。
3．5．result（返回信息）
用于通知商户该订单的支付经办结果。
订单支付后，数据以post的形式将表单提交到商户指定的网址，该网址由订单信息中的回调地址（RETURL）指定。
post的信息放在域result（返回信息）中，包括以下几个字段
应该和商户的订单信息一致
付方账号
PAYACC
付方分行号
PAYBBK
如75表示深圳
付方分行名称
C_PAYBBK
深圳
付方公司名称
C_RELNBR
C（60）
订单请求状态
ORDSTA
C（3）
目前只有OPR，不会有其他状态
INP：
待缴费
OPR：
企业银行缴费经办
WCF：
等待商户确认
CFM：
确认完毕
MRV：
多收方处理中
FIN：
订单处理完成
订单处理结果
ORDSTS
订单请求状态=完成（ORDSTA=FIN）时才有效
S：
企业订单支付成功，多收方支付成功
B：
企业订单支付成功，多收方支付不成功
M：
商户撤销订单
E：
企业撤销订单
H：
订单过期作废
F：
失败
3．6．范例
示例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（可空）：
jgVt93qBycvrNu/f3kIlGG7z02Z5c0gpxIQsJB56QU9RSdyyIDsxMzAwNzg4MDU4NjcyIDtOMDAwMTA3MjIxIDu/qrei16jTwzA3IDtOMDAwMjUyOCA7MIIEeTCCA2GgAwIBAgIQIqmMGgaId4uNvTELHKFfUjANBgkqhkiG9w0BAQUFADCBhTELMAkGA1UEBhMCQ04xHTAbBgNVBAoTFENoaW5hIE1lcmNoYW50cyBCYW5rMRQwEgYDVQQLEwtDQSBTZXJ2aWNlczESMBAGA1UECBMJR3VhbmdEb25nMRowGAYDVQQDExFGaXJtIEJhbmsgQ01TIGRldjERMA8GA1UEBxMIU2hlbnpoZW4wHhcNMTAwNTEzMTYwMDAwWhcNMTEwNTE0MTU1OTU5WjB5MQswCQYDVQQGEwJDTjEMMAoGA1UEChMDQ01CMQswCQYDVQQLEwJGQjEjMCEGA1UECx4abfFXM14CmHZ+p0/hYG9igGcvZwmWUFFsU/gxEzARBgNVBAseCk8BThp/UZT2W6QxFTATBgNVBAMeDF8AU9FOE3UoADAANzCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAvKSNPg1KVlpoNPtj6D0JMr6DJr+T2VnC0r2PtnWexWmmX+NThE1Y0kX+g4cv/5kZUpFwjALpgSZ/kbPFLCOVgoFhoAfhaaQCUAX/Ct5xeXZ6+3imqbTh0189vWSIixczHFPVaVFa/dO1Gn7zZmsQbbedjBh6XbY5fnG8z3MoEZ0CAwEAAaOCAXIwggFuMB8GA1UdIwQYMBaAFHofy7GypYNMk5dq0v2KLjf2XyL8MB0GA1UdDgQWBBR0WMQ8yhBsQNR/UcUpDBQ3Y/MpdTALBgNVHQ8EBAMCB4AwRgYDVR0gBD8wPTA7BgkrBgEEAapuAQIwLjAsBggrBgEFBQcCARYgaHR0cDovL3d3dy5jbWJjaGluYS5jb20vY3BzL3YxLjAwWgYDVR0RBFMwUaBPBgkrBgEEAapuBAKgQgRAUXpBM05UVUFNRGMxTlRBd01EQXdNREF3TVRBd0FGaGtSbFZQTXpkeFNERTJRV1ZTZFZoNWVFTk5lVUU5UFFBQjAMBgNVHRMEBTADAQEAMG0GA1UdHwRmMGQwYqBgoF6kXDBaMQswCQYDVQQGEwJDTjEMMAoGA1UEChMDQ01CMQ0wCwYDVQQLEwQyMDAxMQwwCgYDVQQLEwMxMDQxDDAKBgNVBAsTA2NybDESMBAGA1UEAxMJY3JsMTAwMTc1MA0GCSqGSIb3DQEBBQUAA4IBAQDHcFkMB/db4MQQV+963H0vkOJs+0RjMvp/lDhCz2VxtmNdUUC8+WyDXQcrl6PB8nHoXKcLHcQGHoFVf62QAUP/wM1v6zZrvHYmdONGG/RwDxMoshbJZV6vzGm/YO0lyqFzjO8FBUCCXpYbYzYBPmXw1+rors5dL2IBusooAVCGOQTa3sSwX5pqCg3xCgi4wZqdbLTzljFLFjdE5VcnLDe3ox30+cSvDTIJdVbe1NDujGSrXkaK4J7ejON8CRkc7JBekARf6eC7pmLv1eQkpOVuZE+ttoNJIa5BktCNnWyEJb3+5tnRNn8R4yHsbzEMTslVdG+7ZlB+J8FgQS5Z0aGlIDsyMDExMDMxNzAxIDswNSA7MSA7MTIzIDtyZXN1bHQuanNw
示例2（返回信息）：
域result：
CHKNUM=123;
C_PAYBBK=乌鲁木齐;
ORDSTA=OPR;
ORDSTS=;
PAYACC=1280033810001;
PAYBBK=91;
REFORD=1000123100;
SUBORD=;
域sigdat：
fO6djk6dg/sbLM4P82eQNYyO8EAHA9KfiKy+9T5SNjt6sdRUw4Ou+1rSa/nAHRe1eWeydj/6fw427PSkRKrJlA/WTtebTkEQZeaRdYxD/XptjHEaeODaRX7W8JdN9My937m65FQTQLlZtBmCB+JIFlN7cYb91QLAViPecBYnkB8=
4、结果通知
订单完成后，银行将会主动通知商户支付结果。
目前系统支持http和https两种方式post。
post的信息包括:
域content（正文信息）和域signature（签名信息）。
域content（正文信息）是通知的内容，域signature（签名信息）是对域content（正文信息）进行RSA算法生成的签名。
商户根据招行提供的公钥进行验证，确保数据是由招行产生的。
4．1．订单支付结果通知
返回订单的支付结果，域content（正文信息）的内容如下：
<
?
xmlversion="
1.0"
encoding="
ISO8859-1"
>
DATA>
REQUEST>
NCB2BFIN>
REQNBR>
流程实例号<
/REQNBR>
MCHNBR>
商户编号<
/MCHNBR>
REFORD>
订单号<
/REFORD>
SUBORD>
订单支付号<
/SUBORD>
CCYNBR>
订单币种<
/CCYNBR>
TRSAMT>
订单金额<
/TRSAMT>
ENDAMT>
结账金额<
/ENDAMT>
BBKNBR>
付方分行号<
/BBKNBR>
PAYACC>
付方账号<
/PAYACC>
ACCNAM>
付方户名<
/ACCNAM>
YURREF>
业务参考号<
/YURREF>
ENDDAT>
付款日期<
/ENDDAT>
RTNFLG>
业务请求结果<
/RTNFLG>
RTNDSP>
结果描述<
/RTNDSP>
/NCB2BFIN>
/REQUEST>
/DATA>
具体字段含义如下：
流程实例号
REQNBR
以分为单位，格式为：
nnnnnnnnnnnnnnn，共15位，左边补0
结账金额
ENDAMT
BBKNBR
付方户名
ACCNAM
业务参考号
YURREF
付款日期
ENDDAT
业务请求结果
RTNFLG
K:
退票
升级会员 