C#中国建设银行接口使用详细说明.docx

《C#中国建设银行接口使用详细说明.docx》由会员分享，可在线阅读，更多相关《C#中国建设银行接口使用详细说明.docx（22页珍藏版）》请在三一办公上搜索。

1、中国建设银行接口使用详细说明 Posted on 2010-07-22 18:59 苏飞 阅读(2782) 评论(17) 编辑 收藏 接口介绍 建行的接口相对于支付宝，Q业务充值和移动，联通，电信，缴费接口要复杂一些，接口分为两块，一块是商户到银行，另外一块是银行到商户商户到银行 交易流程如下：网上支付业务流程步骤说明： 1)客户登录商户网站，选择商户网站商品。2)客户将选好的商品放入购物车，并下订单。商户提供商户代码、订单号、合计金额等信息；3)客户选择代理付款的银行建行，确认后，商户代码、订单信息、合计金额通过浏览器URL传到建行网上银行站点；网上银行自动显示支付页面，客户首先选择是否使用

2、建行证书，然后输入龙卡号和密码，选择“确定”。支付信息经加密后传送到网银中心；4)网银中心接收客户支付信息，转发到银行后台业务处理系统；5)银行后台业务系统处理后，返回处理结果给网银；6)网银通知客户支付（扣帐）是否成功。如果扣帐成功，提示客户注意接收商户返回的送货信息；对于不需要立即响应的商户，跳过步骤7、8；7)对于需要立即响应的商户，如果支付成功，网银将成功结果反馈给商户。若支付失败，不返回给商户信息8)对于需要立即响应的商户，收到银行扣帐成功的通知后，发给客户送货信息。如客户收到银行支付（扣帐）成功通知（步骤6），但未收到商户送货信息，则需向商户查询。日终时，商户与开设结算帐户的建设银

3、行（网银成员行）进行流水核对，对已支付但未得到商户确认的交易进行退款处理。商户到银行 其实这一步是把自己卡里的钱转到商户的帐上，就是转账，代码实现其实很简单，我们先来分析一上要传的参考吧个人客户在商户网站选择商品后，商户网站生成以下信息，传送到建行网站：域名名称类型备注MERCHANTID商户代码CHAR(9)由建行统一分配POSID商户柜台代码CHAR(9)由建行统一分配，缺省为000000000BRANCHID分行代码CHAR(9)由建行统一指定ORDERID定单号CHAR(30)由商户提供，最长30位,按实际长度给出PAYMENT付款金额NUMBER(16,2)由商户提供，按实际金额给出

4、CURCODE币种CHAR(2)缺省为01人民币REMARK1备注1CHAR(30)网银不处理，直接传到城综网REMARK2备注2CHAR(30)网银不处理，直接传到城综网TXCODE交易码CHAR(6)由建行统一分配为520100MACMAC校验域CHAR(32)采用标准MD5算法，由商户实现注：商户要保证定单号的唯一性。为了加快站点间接口开发，站点间接口的参数传送采用普通的URL方式，商户将以上信息包含在FORM中，在SUBMIT后将生成URL，如下所示：&TXCODE=520100&REMARK1=&REMARK2=&MAC=qwertyuioplkjhgfdsazxcvbnm90123

5、4参与MAC运算的字符及其顺序如下：MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&TXCODE=520100&REMARK1=&REMARK2=注：字符串中变量名必须是大写字母。 这是建行文档说的说明，很明显这是使用Http的方式来实现的下面我们动手来实现 一下吧，我是把所有的参数生成了一个实体类这样方便，而且规范化，来看看这个Model吧代码 usingSystem;usingSystem.Collections.Generic;usi

6、ngSystem.Linq;usingSystem.Text;namespaceClientSystem.AliPay/建行传入参数/publicclassCBBTextModelprivatestring_MERCHANTID=;/商户代码由建行统一分配/publicstringMERCHANTIDgetreturn_MERCHANTID;set_MERCHANTID=value;privatestring_POSID=;/商户柜台代码由建行统一分配，缺省为000000000/publicstringPOSIDgetreturn_POSID;set_POSID=value;privatest

7、ring_BRANCHID=;/分行代码由建行统一指定/publicstringBRANCHIDgetreturn_BRANCHID;set_BRANCHID=value;privatestring_ORDERID=;/定单号由商户提供，最长30位,按实际长度给出/publicstringORDERIDgetreturn_ORDERID;set_ORDERID=value;privatedecimal_PAYMENT=0m;/付款金额由商户提供，按实际金额给出/publicdecimalPAYMENTgetreturn_PAYMENT;set_PAYMENT=value;privatestri

8、ng_CURCODE=;/币种缺省为01人民币/publicstringCURCODEgetreturn_CURCODE;set_CURCODE=value;privatestringREMARK1=;/备注1网银不处理，直接传到城综网/publicstringREMARK11getreturnREMARK1;setREMARK1=value;privatestringREMARK2=;/备注2网银不处理，直接传到城综网/publicstringREMARK21getreturnREMARK2;setREMARK2=value;privatestring_TXCODE=;/交易码由建行统一分配

9、为520100/publicstringTXCODEgetreturn_TXCODE;set_TXCODE=value;privatestring_MAC=;/MAC校验域采用标准MD5算法，由商户实现/publicstringMACgetreturn_MAC;set_MAC=value;privatestring_url=;/URL/publicstringUrlgetreturn_url;set_url=value;我们来准备两个方法吧，一个是Http连接来使用的一个是Md5加密，因为在文档里写到要使用Md5加密哦代码 #region/预定义方法或是变量/请求指定URL资源，并获取响应结果

10、/需要请求的URL资源/响应结果；/出现任意异常，均返回字串RuntimeError/privatestringRequestContent(stringurl)stringcontent=string.Empty;tryHttpWebRequestrequest=(HttpWebRequest)WebRequest.Create(url);request.KeepAlive=false;HttpWebResponseresponse=(HttpWebResponse)request.GetResponse();StreamReaderreader=newStreamReader(respon

11、se.GetResponseStream(),Encoding.Default);content=reader.ReadToEnd();reader.Close();catch(Exception)content=RuntimeError;returncontent;/传入明文，返回用MD%加密后的字符串/要加密的字符串/用MD5加密后的字符串publicstaticstringToMD5(stringstr)returnSystem.Web.Security.FormsAuthentication.HashPasswordForStoringInConfigFile(str,md5);#en

12、dregion 看一下充值按钮下面实现吧代码 if(textBox1.Text.Trim()=|textBox1.Text.Trim()=null)MessageBoxFormobjm=newMessageBoxForm(您输入的金额不能为空！,提示信息);objm.ShowDialog();return;stringorid=OfficeInfo.ofId.ToString().Trim()+_+DateTime.Now.Ticks.ToString();Alipayobjalipay=newAlipay();objalipay.APID=orid;objalipay.addTime=Dat

13、eTime.Now;objalipay.total_fee=Convert.ToDecimal(textBox1.Text.ToString().Trim();objalipay.trade_status=客户端提交;objalipay.Text1=DateTime.Now.ToString();objalipay.Text2=建行接口;objalipay.Text3=;objalipay.Text4=;objalipay.Text5=;decimalmoney=Convert.ToDecimal(user.GetListBy(OfficeInfo.ofPara1,13).ToString()

14、.Trim();if(moneyConvert.ToDecimal(textBox1.Text.Trim()MessageBoxFormobjm=newMessageBoxForm(你输入的最小金额不能低于+money+元！,提示信息);objm.ShowDialog();return;if(user.AddAlipay(OfficeInfo.ofPara1,objalipay)CBBTextModelobjcbbText=newCBBTextModel();/商户代码由建行统一分配objcbbText.MERCHANTID=00000000000000;/商户柜台代码由建行统一分配，缺省为0

15、00000000objcbbText.POSID=00000000000000;/分行代码由建行统一指定objcbbText.BRANCHID=00000000000000;/定单号由商户提供，最长30位,按实际长度给出objcbbText.ORDERID=orid.Trim();/付款金额由商户提供，按实际金额给出objcbbText.PAYMENT=Convert.ToDecimal(textBox1.Text.Trim();/币种缺省为01人民币objcbbText.CURCODE=01;/备注1网银不处理，直接传到城综网objcbbText.REMARK11=;/备注2网银不处理，直接

16、传到城综网objcbbText.REMARK21=;/交易码由建行统一分配为520100objcbbText.TXCODE=520100;/MAC校验域采用标准MD5算法，由商户实现objcbbText.MAC=qwertyuioplkjhgfdsazxcvbnm901234;/URLobjcbbText.Url=/要加密的串stringcanshu=MERCHANTID=+objcbbText.MERCHANTID.Trim()+&POSID=+objcbbText.POSID.Trim()+&BRANCHID=+objcbbText.BRANCHID.Trim()+&ORDERID=+ob

17、jcbbText.ORDERID.Trim()+&PAYMENT=+objcbbText.PAYMENT.ToString().Trim()+&CURCODE=+objcbbText.CURCODE+&TXCODE=+objcbbText.TXCODE.Trim()+&REMARK1=&REMARK2=;objcbbText.MAC=ToMD5(canshu.Trim().ToLower().Trim();stringstrURl=objcbbText.Url+?+canshu+&MAC=+objcbbText.MAC.Trim();webBrowser1.Url=newUri(strURl.

18、Trim();在这里大家一定要注意把objcbbText.MAC=ToMD5(canshu.Trim().ToLower().Trim();加密后的字符串改成小写的上面所提到的代码 stringorid=OfficeInfo.ofId.ToString().Trim()+_+DateTime.Now.Ticks.ToString();Alipayobjalipay=newAlipay();objalipay.APID=orid;objalipay.addTime=DateTime.Now;objalipay.total_fee=Convert.ToDecimal(textBox1.Text.T

19、oString().Trim();objalipay.trade_status=客户端提交;objalipay.Text1=DateTime.Now.ToString();objalipay.Text2=建行接口;objalipay.Text3=;objalipay.Text4=;objalipay.Text5=;decimalmoney=Convert.ToDecimal(user.GetListBy(OfficeInfo.ofPara1,13).ToString().Trim();if(moneyConvert.ToDecimal(textBox1.Text.Trim()MessageBo

20、xFormobjm=newMessageBoxForm(你输入的最小金额不能低于+money+元！,提示信息);objm.ShowDialog();return;if(user.AddAlipay(OfficeInfo.ofPara1,objalipay)这一部分代码是记录日志的，大家可以参考一下我们现在只要运行程序就会出现如下界面所显示的内容下面的操作就是输入你的卡号密码就可以了，转账成功后我们这一步的工作就算是做完了银行到商户接下来的这一步 是很关键的一步，是当我们转账成功后，银行发给我们系统的一个处理结束，里面的参数如下建行网站生成以下信息，传送到商户网站：域名名称类型备注POSID商户

21、柜台代码CHAR(9)从商户传送的信息中获得BRANCHID分行代码CHAR(9)从商户传送的信息中获得ORDERID定单号CHAR(30)从商户传送的信息中获得PAYMENT付款金额NUMBER(16,2)从商户传送的信息中获得CURCODE币种CHAR(2)从商户传送的信息中获得REMARK1备注一CHAR(30)从商户传送的信息中获得REMARK2备注二CHAR(30)从商户传送的信息中获得SUCCESS成功标志CHAR(1)成功时返回YSIGN数字签名CHAR(256)站点间接口的参数传送仍然采用普通的URL方式，信息包含在CGI参数，具体如下所示：HTTP:/MERCHANT.WEB

22、.SITE/MERCHANT_CGI?POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK119991101&REMARK2=merchantname&SUCCESS=Y&SIGN=4b3ef029516193b7d969ac1840083635a3e0901b8cd526caa44c1a072f496d7f0d4bca3942c0d9030bede37c7809b835cec787eb39e18b7596a724fba9805b24714dfbb0f4a3fb430b32

23、e075254a114d4c38a0ac52ef46a0ad33dec3fbfc15417402a1399e65e46996c0cf49fc7ffca9222f8cd693c8376b6f928828967bec42注：?前的URL由商户在签约时提供参与签名运算的字符及其顺序如下POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK119991101&REMARK2=merchantname&SUCCESS=Y注：字符串中变量名必须是大写字母。如果商户的程序将MERCHANT

24、ID, POSID,BRANCHID, ORDERID, PAYMENT, CURCODE，TXCODE和MAC作为隐藏域(hidden)，然后使用SUBMIT按纽，注意在 FORM的METHOD中使用“GET”的方式。 在这里我们首先要新建一个A的网站，只要在一个网页下面书写代码就成了。第一步我们要写出来要加密 的串代码 /要加密的串stringcanshu=POSID=000000000&BRANCHID=0000000&ORDERID=+Request.QueryStringORDERID.Trim()+&PAYMENT=+Request.QueryStringPAYMENT.Trim(

25、)+&CURCODE=+Request.QueryStringCURCODE.Trim()+&REMARK1=+Request.QueryStringREMARK1.Trim()+&REMARK2=+Request.QueryStringREMARK2.Trim()+&ACC_TYPE=+Request.QueryStringACC_TYPE.Trim()+&SUCCESS=+Request.QueryStringSUCCESS.Trim();这是在我们接收数据时要用到的，这里建行提供了一个加密验证为银行将客户支付信息实时通知给商户时，使用的数字签名算法是MD5withRSA算法。商户验证签名

26、的公钥在商户在网银系统开户，获取数字证书后，登录到网银系统中，通过下载公钥交易获取。商户获取的公钥用X.509格式表示，并且将其按照每4位（bit）转换为一个16进制数的方式表示，产生16进制的字符串。网上银行使用标准MD5withRSA算法对给商户的响应进行签名，产生1024位（bit）的签名结果，并且将其按照每4位（bit）转换为一个16进制数的方式表示，形成16进制的字符串，长度为256。下面是对签名结果的表示方式的描述：1、对1024位的交易结果按4位为一个单位进行划分，共获得256段2、将每段看成一个16进制数，如0011为0X3，1101为0Xd。3、将这个数映射到ASCII码表，

27、形成相应的字符，如0X2为“2”，0Xd为“d”。4、将这些字符连成一个字符串，长度为256。例如：待签名的字符串为：POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK119991101&REMARK2=merchantname&SUCCESS=Y签名结果为：4b3ef029516193b7d969ac1840083635a3e0901b8cd526caa44c1a072f496d7f0d4bca3942c0d9030bede37c7809b835cec787eb39e1

28、8b7596a724fba9805b24714dfbb0f4a3fb430b32e075254a114d4c38a0ac52ef46a0ad33dec3fbfc15417402a1399e65e46996c0cf49fc7ffca9222f8cd693c8376b6f928828967bec42当商户收到银行传来的CGI串后，从中获取签名（格式如上）和需签名的原文。商户端程序（商户自行开发MD5withRSA签名校验程序）将签名和商户端的公钥转换成二进制格式，与签名的原文一起对签名的正确性进行校验，校验步骤如下：1) 使用公钥进行签名的逆运算2) 使用标准MD5算法运算原文比较1)、2)结果。

29、下面我们要做的工作就是如何验证这个串是否一致了，先说一下MD5withRSA签名程序吧，这是加密算法是由MD5加密和RSA加密算法组合而来的具体的说明请大家在网上找找吧，很容易找到这里就不再多说了我们来看看主要是怎么验证的吧银行发过来的签名是通过RSA加密后的签名，在签名是会生成一个公钥，这个公钥我们可以从这里下载的到用我们的账户登录建行的商户平台，如下地方可以下载的到另外在登录这个系统时要验证客户端的证书，证书的下载可以在建行的主而上直接找到，根据自己的客户号和密码可以下载，具体的大家还得根据建行服务人员的提示操作的好有了这个我们还要一个CCBRSA.dll文件，这个是建行用来验证加密串的具

30、体的使用方法看下面的程序，怎么样添加Dll的引用我就不多说了，大家自己找找代码/传过来的签名；stringsign=Request.QueryStringSIGN;/本地Key值stringmysign=ConfigurationManager.AppSettingsPublicKey.ToString().Trim();CCBRSA.RSASigrsa;/注册一下regsvr32CCBRSA.dll文件rsa=newCCBRSA.RSASigClass();boolbRet;rsa.setPublicKey(mysign);bRet=rsa.verifySigature(sign,cansh

31、u);bRet是一个Boolean值可以直接用它来做IF的判断。在这里我多说几句如果我们直接这样运行的话可能会报错如下Retrieving the COM class factory for component with CLSIDA5C5C388-A972-4CCF-93E2-7F97E82C9EBA failed due to the following error:80040154. 由于用到了CCBRSA.dll这个动态链接库文件，所以要先注册一下这个文件，建议把这个文件复制到system32目录下然后开始运行输入regsvr32CCBRSA.dll 确定就可以了. 另外还要安装一下m

32、sjavx86.exe，java虚拟机。可能是有部分需要调用到java的一些库吧，所以需要安装这个。我把Dll文件和这个文件提供下载如下打包下载 我验证的时候一般要验证如下三个方面就算是可以了代码/调试用，中国建设银行服务器返回时的完整路径。if(bRet&success=Y&Request.UserHostName.Trim()=建行IP)/验证中国建设银行发过来的消息，签名是否正确在这里写我们自己的代码吧。过多的代码不方便贴出来，呵呵，大家如果也在开发这块的东东，而且 有问题的话可以交流一下，呵呵我们把代码写完之后直接发布到一个能被外网访问到的电脑上就行了， 然后在商户的后写上这个页面的地方就行了，看下面的图第一个地址是时时的只有用户单击确定成功按钮时才会调用 ，一般不使用，就是支付宝里的时时调用方式第二个是异步的，就是说不管你单击不单击只要有帐 到，都会调用 在使用的时候要输入一下交易密码哦好了，我们的工作就到这里吧，哎，为了方便大家理解我还是把大部分代码贴一下吧代码usingSystem;usingSystem.Configuration;usingSystem.Data;usingSystem.Linq;usingSystem.Web;usingSystem.Web