中国建设银行接口使用详细说明

声明：本博文转载于：http://sufei.cnblogs.com/   

 

 

接口介绍

---

 

      建行的接口相对于支付宝，Q业务充值和移动，联通，电信，缴费接口要复杂一些，接口分为两块，一块是商户到银行，另外一块是银行到商户

商户到银行

      交易流程如下：

 网上支付业务流程步骤说明：

 

 

 

 

 

1)  客户登录商户网站，选择商户网站商品。

2)  客户将选好的商品放入购物车，并下订单。商户提供商户代码、订单号、合计金额等信息；

3)  客户选择代理付款的银行－建行，确认后，商户代码、订单信息、合计金额通过浏览器URL传到建行网上银行站点；

网上银行自动显示支付页面，客户首先选择是否使用建行证书，然后输入龙卡号和密码，选择“确定”。支付信息经加密后传送到网银中心；

4)  网银中心接收客户支付信息，转发到银行后台业务处理系统；

5)  银行后台业务系统处理后，返回处理结果给网银；

6)  网银通知客户支付（扣帐）是否成功。如果扣帐成功，提示客户注意接收商户返回的送货信息；对于不需要立即响应的商户，

跳过步骤7、8；

7)  对于需要立即响应的商户， 如果支付成功，网银将成功结果反馈给商户。 若支付失败，不返回给商户信息

8)  对于需要立即响应的商户，收到银行扣帐成功的通知后，发给客户送货信息。如客户收到银行支付（扣帐）成功通知（步骤6），

但未收到商户送货信息，则需向商户查询。

日终时，商户与开设结算帐户的建设银行（网银成员行）进行流水核对，对已支付但未得到商户确认的交易进行退款处理。

 

 

商户到银行

---

 

    其实这一步是把自己卡里的钱转到商户的帐上，就是转账，

代码实现其实很简单，我们先来分析一上要传的参考吧

 

个人客户在商户网站选择商品后，商户网站生成以下信息，传送到建行网站：

 

域名	名称	类型	备注
MERCHANTID	商户代码	CHAR(9)	由建行统一分配
POSID	商户柜台代码	CHAR(9)	由建行统一分配，缺省为 000000000
BRANCHID	分行代码	CHAR(9)	由建行统一指定
ORDERID	定单号	CHAR(30)	由商户提供，最长 30 位 , 按实际长度给出
PAYMENT	付款金额	NUMBER(16,2)	由商户提供，按实际金额给出
CURCODE	币种	CHAR(2)	缺省为 01 －人民币
REMARK1	备注 1	CHAR(30)	网银不处理，直接传到城综网
REMARK2	备注 2	CHAR(30)	网银不处理，直接传到城综网
TXCODE	交易码	CHAR(6)	由建行统一分配为 520100
MAC	MAC 校验域	CHAR(32)	采用标准 MD5 算法，由商户实现

注：商户要保证定单号的唯一性。

为了加快站点间接口开发，站点间接口的参数传送采用普通的 URL 方式，商户将以上信息包含在 FORM 中，在 SUBMIT 后将生成 URL ，如下所示：

https://ibsbjstar.ccb.com.cn/app/ccbMain?MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01

&TXCODE=520100&REMARK1=&REMARK2=&MAC=qwertyuioplkjhgfdsazxcvbnm901234

 

参与 MAC 运算的字符及其顺序如下：

MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&

TXCODE=520100&REMARK1=&REMARK2=

注：字符串中变量名必须是大写字母。

           这是建行文档说的说明，很明显这是使用Http的方式来实现的

下面我们动手来实现 一下吧，

我是把所有的参数生成了一个实体类这样方便，而且规范化，

来看看这个Model吧

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace ClientSystem.AliPay
{
    /// <summary>
    /// 工行传入参数
    /// </summary>
    public class CBBTextModel
    {

        private string _MERCHANTID = "";
        /// <summary>
        /// 商户代码 由建行统一分配
        /// </summary>
        public string MERCHANTID
        {
            get { return _MERCHANTID; }
            set { _MERCHANTID = value; }
        }


        private string _POSID = "";
        /// <summary>
        /// 商户柜台代码  由建行统一分配，缺省为000000000
        /// </summary>
        public string POSID
        {
            get { return _POSID; }
            set { _POSID = value; }
        }


        private string _BRANCHID = "";
        /// <summary>
        /// 分行代码  由建行统一指定
        /// </summary>
        public string BRANCHID
        {
            get { return _BRANCHID; }
            set { _BRANCHID = value; }
        }


        private string _ORDERID = "";
        /// <summary>
        /// 定单号 由商户提供，最长30位,按实际长度给出
        /// </summary>
        public string ORDERID
        {
            get { return _ORDERID; }
            set { _ORDERID = value; }
        }


        private decimal _PAYMENT = 0m;
        /// <summary>
        /// 付款金额  由商户提供，按实际金额给出
        /// </summary>
        public decimal PAYMENT
        {
            get { return _PAYMENT; }
            set { _PAYMENT = value; }
        }


        private string _CURCODE = "";
        /// <summary>
        /// 币种 缺省为01－人民币
        /// </summary>
        public string CURCODE
        {
            get { return _CURCODE; }
            set { _CURCODE = value; }
        }


        private string REMARK1 = "";
        /// <summary>
        /// 备注1  网银不处理，直接传到城综网
        /// </summary>
        public string REMARK11
        {
            get { return REMARK1; }
            set { REMARK1 = value; }
        }


        private string REMARK2 = "";
        /// <summary>
        /// 备注2  网银不处理，直接传到城综网
        /// </summary>
        public string REMARK21
        {
            get { return REMARK2; }
            set { REMARK2 = value; }
        }


        private string _TXCODE = "";
        /// <summary>
        /// 交易码  由建行统一分配为520100
        /// </summary>
        public string TXCODE
        {
            get { return _TXCODE; }
            set { _TXCODE = value; }
        }


        private string _MAC = "";
        /// <summary>
        /// MAC校验域  采用标准MD5算法，由商户实现
        /// </summary>
        public string MAC
        {
            get { return _MAC; }
            set { _MAC = value; }
        }

        private string _url = "";
        /// <summary>
        /// URL
        /// </summary>
        public string Url
        {
            get { return _url; }
            set { _url = value; }
        }

    }
}

 

我们来准备两个方法吧，一个是Http连接来使用的一个是Md5加密，因为在文档里写到要使用Md5加密哦

#region //预定义方法或是变量

        /// <summary>
        /// 请求指定 URL 资源，并获取响应结果
        /// </summary>
        /// <param name="url">需要请求的 URL 资源</param>
        /// <returns>
        /// 响应结果；
        /// 出现任意异常，均返回字串"Runtime Error"
        /// </returns>
        private string RequestContent(string url)
        {
            string content = string.Empty;
            try
            {
                HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
                request.KeepAlive = false;
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);
                content = reader.ReadToEnd();
                reader.Close();
            }
            catch (Exception)
            {
                content = "Runtime Error";
            }
            return content;
        }

        /// <summary>
        /// 传入明文，返回用MD%加密后的字符串
        /// </summary>
        /// <param name="str">要加密的字符串</param>
        /// <returns>用MD5加密后的字符串</returns>
        public static string ToMD5(string str)
        {
            return System.Web.Security.FormsAuthentication.HashPasswordForStoringInConfigFile(str, "md5");
        }

        #endregion

 

看一下充值按钮下面实现吧

 

if (textBox1.Text.Trim() == "" || textBox1.Text.Trim() == null)
            {
                MessageBoxForm objm = new MessageBoxForm("您输入的金额不能为空！！！", "提示信息");
                objm.ShowDialog();
                return;
            } 
            string orid = OfficeInfo.ofId.ToString().Trim() + "_" + DateTime.Now.Ticks.ToString();
            Alipay objalipay = new Alipay();
            objalipay.APID = orid;
            objalipay.addTime = DateTime.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 = "";

            decimal money = Convert.ToDecimal(user.GetListBy(OfficeInfo.ofPara1, 13).ToString().Trim());
            if (money > Convert.ToDecimal(textBox1.Text.Trim()))
            {
                MessageBoxForm objm = new MessageBoxForm("你输入的最小金额不能低于" + money + "元！！！", "提示信息");
                objm.ShowDialog();
                return;
            }

            if (user.AddAlipay(OfficeInfo.ofPara1, objalipay))
            {
                CBBTextModel objcbbText = new CBBTextModel();

                //商户代码 由建行统一分配
                objcbbText.MERCHANTID = "00000000000000";

                //商户柜台代码  由建行统一分配，缺省为000000000

                objcbbText.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  网银不处理，直接传到城综网
                objcbbText.REMARK21 = "";

                //交易码  由建行统一分配为520100
                objcbbText.TXCODE = "520100";

                //MAC校验域  采用标准MD5算法，由商户实现
                objcbbText.MAC = "qwertyuioplkjhgfdsazxcvbnm901234";

                //URL
                objcbbText.Url = "https://ibsbjstar.ccb.com.cn/app/ccbMain";

                //要加密的串
                string canshu = "MERCHANTID=" + objcbbText.MERCHANTID.Trim() +
                    "&POSID=" + objcbbText.POSID.Trim() + "&BRANCHID=" + objcbbText.BRANCHID.Trim()
                    + "&ORDERID=" + objcbbText.ORDERID.Trim() + "&PAYMENT=" + objcbbText.PAYMENT.ToString().Trim()
                    + "&CURCODE=" + objcbbText.CURCODE + "&TXCODE=" + objcbbText.TXCODE.Trim()
                    + "&REMARK1=&REMARK2=";

                objcbbText.MAC = ToMD5(canshu.Trim()).ToLower().Trim();
                string strURl = objcbbText.Url + "?" + canshu + "&MAC=" + objcbbText.MAC.Trim();
                webBrowser1.Url = new Uri(strURl.Trim());
            }
        }

 

在这里大家一定要注意把 objcbbText.MAC =  ToMD5(canshu.Trim()).ToLower().Trim();
加密后的字符串改成小写的

上面所提到的

string orid = OfficeInfo.ofId.ToString().Trim() + "_" + DateTime.Now.Ticks.ToString();
            Alipay objalipay = new Alipay();
            objalipay.APID = orid;
            objalipay.addTime = DateTime.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 = "";

            decimal money = Convert.ToDecimal(user.GetListBy(OfficeInfo.ofPara1, 13).ToString().Trim());
            if (money > Convert.ToDecimal(textBox1.Text.Trim()))
            {
                MessageBoxForm objm = new MessageBoxForm("你输入的最小金额不能低于" + money + "元！！！", "提示信息");
                objm.ShowDialog();
                return;
            }

            if (user.AddAlipay(OfficeInfo.ofPara1, objalipay))
            {

 

这一部分代码是记录日志的，大家可以参考一下

我们现在只要运行程序就会出现如下界面所显示的内容

下面的操作就是输入你的卡号密码就可以了，

转账成功后我们这一步的工作就算是做完了

 

银行到商户

---

 

接下来的这一步 是很关键的一步，是当我们转账成功后，银行发给我们系统的一个处理结束，里面的参数如下

 

建行网站生成以下信息，传送到商户网站：

 

域名	名称	类型	备注
POSID	商户柜台代码	CHAR(9)	从商户传送的信息中获得
BRANCHID	分行代码	CHAR(9)	从商户传送的信息中获得
ORDERID	定单号	CHAR(30)	从商户传送的信息中获得
PAYMENT	付款金额	NUMBER(16,2)	从商户传送的信息中获得
CURCODE	币种	CHAR(2)	从商户传送的信息中获得
REMARK1	备注一	CHAR(30)	从商户传送的信息中获得
REMARK2	备注二	CHAR(30)	从商户传送的信息中获得
SUCCESS	成功标志	CHAR(1)	成功时返回 Y
SIGN	数字签名	CHAR(256)

 

站点间接口的参数传送仍然采用普通的 URL 方式，信息包含在 CGI 参数，具体如下所示：

HTTP://MERCHANT.WEB.SITE/MERCHANT_CGI?POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1 ＝ 19991101&REMARK2=merchantname&SUCCESS=Y&SIGN=4b3ef029516193b7d969ac1840083635a3e0901b8cd526caa44c1a07

2f496d7f0d4bca3942c0d9030bede37c7809b835cec787eb39e18b7596a724fba9805b24714dfbb0f4a3fb430b32e075254a114d4c38a0ac

52ef46a0ad33dec3fbfc15417402a1399e65e46996c0cf49fc7ffca9222f8cd693c8376b6f928828967bec42

 

注： ? 前的 URL 由商户在签约时提供

 

参与签名运算的字符及其顺序如下

POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1 ＝ 19991101&REMARK2=merchantname&SUCCESS=Y

注：字符串中变量名必须是大写字母。

 

如果商户的程序将 MERCHANTID, POSID,BRANCHID, ORDERID, PAYMENT, CURCODE ， TXCODE 和 MAC 作为隐藏域 (hidden) ，

然后使用 SUBMIT 按纽，注意在 FORM 的 METHOD 中使用“ GET ”的方式。

         在这里我们首先要新建一个Asp.net的网站，只要在一个网页下面书写代码就成了。

第一步我们要写出来要加密 的串

/要加密的串
                string canshu = "POSID=000000000&BRANCHID=0000000&ORDERID=" + Request.QueryString["ORDERID"].Trim() + "&PAYMENT=" +
                   Request.QueryString["PAYMENT"].Trim() + "&CURCODE=" + Request.QueryString["CURCODE"].Trim() + "&REMARK1=" + Request.QueryString["REMARK1"].Trim()
                   + "&REMARK2=" + Request.QueryString["REMARK2"].Trim() + "&ACC_TYPE=" + Request.QueryString["ACC_TYPE"].Trim()
                   + "&SUCCESS=" + Request.QueryString["ACC_TYPE"].Trim();

 

这是在我们接收数据时要用到的，

这里建行提供了一个加密验证为

银行将客户支付信息实时通知给商户时，使用的数字签名算法是 MD5withRSA 算法。商户验证签名的公钥在商户在网银系统开户，获取数字证书后，登录到网银系统中，通过下载公钥交易获取。

 

商户获取的公钥用 X.509 格式表示，并且将其按照每 4 位（ bit ）转换为一个 16 进制数的方式表示，产生 16 进制的字符串。

 

 

网上银行使用标准 MD5withRSA 算法对给商户的响应进行签名，产生 1024 位（ bit ）的签名结果，并且将其按照每 4 位（ bit ）

评论

1 楼 WSZ1102_shu 2010-09-21  

没有JAVA的代码吗？