银联支付 Chinapay 在.net下的使用总结

一、 准备文件

文档资料

 

根据  客户提供文档《CHINAPAY商户控制台使用手册 》登陆 http://console.chinapay.com/newgms （需要客户提供 商户号，操作员号及密码）

下载

 

解压文件后得到如下文件

 

还需要2个key（MerPrK.key和PgPubk.key）文件，分别是商户私匙和公匙，需要客户签订合同后银联才提供。

二、安装部署

1.    将ChinaPay.dll、CPNPC.dll及netpay.dll复制bin下

2.    注册Chinapay.dll和CPNPC.dll（指令regsvr32 ）

例如  regsvr32  F:\工作\MySolution\Web\bin\Chinapay.dll

    regsvr32  F:\工作\MySolution\Web\bin\CPNPC.dll    

3.    Com类型信息转换为.NET元数据， 需要vs命令提示 工具下运行

tlbimp F:\工作\MySolution\Web\bin\Chinapay.dll /out: F:\工作\MySolution\Web\bin\ ChinaPay_loaf.dll

站点增加引用ChinaPay_loaf.dll   使用的时候引用using ChinaPay_loaf 即可

 

4.    写一个类Chinapay.cs放在App_Code下 用于 用户签名 和验证，不理解签名和验证的看《附3商户技术开发手册.doc》数字签名，

 

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using ChinaPay_loaf        ;
using System.Web.UI;

    /// <summary>
    ///Chinapay 的摘要说明
    /// </summary>
    public class Chinapay
    {
        string strUrl =HttpContext.Current.Request.PhysicalApplicationPath; //获取网站根目录物理路径
        public Chinapay()
        {
        }      
       
        /// <summary>
        /// 订单签名函数sign
        /// </summary>
        /// <param name="MerId">商户号，长度为15个字节的数字串，由ChinaPay或清算银行分配</param>
        /// <param name="OrdId">订单号，长度为16个字节的数字串，由用户系统/网站生成，失败的订单号允许重复支付</param>
        /// <param name="TransAmt">交易金额，长度为12个字节的数字串，例如：数字串"000000001234"表示12.34元</param>
        /// <param name="CuryId">货币代码, 长度为3个字节的数字串，目前只支持人民币，取值为"156"</param>
        /// <param name="TransDate">交易日期，长度为8个字节的数字串，表示格式为：YYYYMMDD</param>
        /// <param name="TransType">交易类型，长度为4个字节的数字串，取值范围为："0001"和"0002"， 其中"0001"表示消费交易，"0002"表示退货交易</param>
        /// <returns>string CheckValue[256]  即NetPayClient根据上述输入参数生成的商户数字签名，长度为256字节的字符串</returns>
        public string getSign(string MerId, string OrdId, string TransAmt, string CuryId, string TransDate, string TransType)
        {
            NetPayClientClass npc = new NetPayClientClass(); //实例NetPay签名        
            string temp = strUrl + "key\\MerPrK.key";
            npc.setMerKeyFile(strUrl + "\\App_Data\\MerPrK.key");
            string strChkValue = "";                         //chinapay返回的商户数字签名
            strChkValue = npc.sign(MerId, OrdId, TransAmt, CuryId, TransDate, TransType);
            return strChkValue.Trim();
        }
        /// <summary>
        /// 对一段字符进行签名 signData
        /// </summary>
        /// <param name="MerId">商户号，长度为15个字节的数字串，由ChinaPay分配</param>
        /// <param name="SignMsg">用于要签名的字符串</param>
        /// <returns>String CheckValue[256]即NetPayClient根据上述输入参数生成的商户数字签名，长度为256字节的字符串</returns>
        public string signData(string MerId, string SignMsg)
        {
            NetPayClientClass npc = new NetPayClientClass(); //实例NetPay签名           
            npc.setMerKeyFile(strUrl + "App_Data\\MerPrK.key");
            string strChkValueData = "";
            strChkValueData = npc.signData(MerId, SignMsg);
            return strChkValueData.Trim();
        }

        /// <summary>
        /// 验证交易应答函数check
        /// </summary>
        /// <param name="MerId">商户号，长度为15个字节的数字串，由ChinaPay分配</param>
        /// <param name="OrdId">订单号，长度为16个字节的数字串，由商户系统生成，失败的订单号允许重复支付</param>
        /// <param name="TransAmt">交易金额，长度为12个字节的数字串，例如：数字串"000000001234"表示12.34元</param>
        /// <param name="CuryId">货币代码, 长度为3个字节的数字串，目前只支持人民币，取值为"156"</param>
        /// <param name="TransDate">交易日期，长度为8个字节的数字串，表示格式为： YYYYMMDD</param>
        /// <param name="TransType">交易类型，长度为4个字节的数字串，取值范围为："0001"和"0002"， 其中"0001"表示消费交易，"0002"表示退货交易</param>
        /// <param name="OrderStatus">交易状态，长度为4个字节的数字串。详见交易状态码说明</param>
        /// <param name="CheckValue">校验值，即ChinaPay对交易应答的数字签名，长度为256字节的字符串</param>
        /// <returns>true 表示成功，即该交易应答为ChinaPay所发送，商户根据“交易状态”进行后续处理；否则表示失败，即无效应答，商户可忽略该应答</returns>
        public bool getCheck(string MerId, string OrdId, string TransAmt, string CuryId, string TransDate, string TransType, string OrderStatus, string CheckValue)
        {
            NetPayClientClass npc = new NetPayClientClass(); //实例NetPay签名           
            npc.setPubKeyFile(strUrl + "App_Data\\PgPubk.key");
            string strFlag = "";
            bool bolFlag = false;
            strFlag = npc.check(MerId, OrdId, TransAmt, CuryId, TransDate, TransType, OrderStatus, CheckValue); // ChkValue 为ChinaPay返回给商户的域段内容
            if (strFlag == "0") //“0”表示验签成功
                bolFlag = true;
            return bolFlag;
        }
        /// <summary>
        /// 对一段字符串进行签名验证 checkData
        /// </summary>
        /// <param name="PlainData">用于数字签名的字符串</param>
        /// <param name="CheckValue">校验值，要验证的字符串的数字签名，长度为256字节的字符串</param>
        /// <returns>true 表示验证通过成功；否则表示失败</returns>
        public bool checkData(string PlainData, string CheckValue)
        {
            NetPayClientClass npc = new NetPayClientClass(); //实例NetPay签名           
            npc.setPubKeyFile(strUrl + "App_Data\\PgPubk.key");
            string strFlagData = "";
            bool bolFlagData = false;
            strFlagData = npc.checkData(PlainData, CheckValue);
            if (strFlagData == "true")
                bolFlagData = true;
            return bolFlagData;
        }


        //

        //支付函数
        /// <summary>
        /// 支付函数
        /// </summary>
        /// <param name="OrderID">程序 订单编号</param>
        /// <param name="TransAmt">交易钱数</param>
        /// <param name="proName">产品名称 可选</param>
        public void GoToPay(string OrderID, string TransAmt, string proName,string gateid)
        {
            Chinapay cpy = new Chinapay();
            //获取传递给银联chinapay的各个参数-----------------------------------------------
           // string cpyUrl = "http://payment-test.chinapay.com/pay/TransGet"; //测试地址，测试的时候用这个地址，应用到网站时用下面那个地址
            string cpyUrl = "http://payment.chinapay.com/pay/TransGet";
            string cpyMerId = "808080580112345";            //ChinaPay统一分配给商户的商户号，15位长度，必填
            string cpyOrdId = getOrderID(OrderID);           //商户提交给ChinaPay的交易订单号，订单号的第五至第九位必须是商户号的最后五位，即“12345”；16位长度，必填
            string cpyTransAmt = getTransAmt(TransAmt); //订单交易金额，12位长度，左补0，必填,单位为分，000000000001 表示 12.34 元
            string cpyCuryId = "156";            //订单交易币种，3位长度，固定为人民币156，必填
            string cpyTransDate = DateTime.Now.ToString("yyyyMMdd");            //订单交易日期，8位长度，必填，格式yyyyMMdd
            string cpyTransType = "0001";        //交易类型，4位长度，必填，0001表示消费交易，0002表示退货交易
            string cpyVersion = "20040916";      //支付接入版本号，808080开头的商户用此版本，必填,另一版本为"20070129"
            string cpyBgRetUrl = "http://test003.abc.cc/Chinapay_Bgreturn.aspx";   //后台交易接收URL，为后台接受应答地址，用于商户记录交易信息和处理，对于使用者是不可见的，长度不要超过80个字节，必填
            string cpyPageRetUrl = "http://test003.abc.cc/Chinapay_Pgreturn.aspx"; //页面交易接收URL，为页面接受应答地址，用于引导使用者返回支付后的商户网站页面，长度不要超过80个字节，必填
            string cpyGateId = gateid;  //支付网关号，可选，参看银联网关类型，如填写GateId（支付网关号），则消费者将直接进入支付页面，否则进入网关选择页面,可登陆商户管理平台 查看各个银行的网管号
            string cpyPriv1 = proName;  //商户私有域，长度不要超过60个字节,商户通过此字段向Chinapay发送的信息，Chinapay依原样填充返回给商户

            string strChkValue = ""; //256字节长的ASCII码,此次交易所提交的关键数据的数字签名，必填
            strChkValue = cpy.getSign(cpyMerId, cpyOrdId, cpyTransAmt, cpyCuryId, cpyTransDate, cpyTransType);

            if (strChkValue != "")
            {
             HttpContext.Current.Response.Write("<form name='chinapayForm' method='post' action='" + cpyUrl + "'>");         //支付地址
             HttpContext.Current.Response.Write("<input type='hidden' name='MerId' value='" + cpyMerId + "' />");            //商户号
             HttpContext.Current.Response.Write("<input type='hidden' name='OrdId' value='" + cpyOrdId + "' />");            //订单号
             HttpContext.Current.Response.Write("<input type='hidden' name='TransAmt' value='" + cpyTransAmt + "' />");      //支付金额
             HttpContext.Current.Response.Write("<input type='hidden' name='CuryId' value='" + cpyCuryId + "' />");          //交易币种
             HttpContext.Current.Response.Write("<input type='hidden' name='TransDate' value='" + cpyTransDate + "' />");    //交易日期
             HttpContext.Current.Response.Write("<input type='hidden' name='TransType' value='" + cpyTransType + "' />");    //交易类型
             HttpContext.Current.Response.Write("<input type='hidden' name='Version' value='" + cpyVersion + "' />");        //支付接入版本号
             HttpContext.Current.Response.Write("<input type='hidden' name='BgRetUrl' value='" + cpyBgRetUrl + "' />");      //后台接受应答地址
             HttpContext.Current.Response.Write("<input type='hidden' name='PageRetUrl' value='" + cpyPageRetUrl + "' />");  //为页面接受应答地址
             HttpContext.Current.Response.Write("<input type='hidden' name='GateId' value='" + cpyGateId + "' />");          //支付网关号
             HttpContext.Current.Response.Write("<input type='hidden' name='Priv1' value='" + cpyPriv1 + "' />");            //商户私有域，这里将订单自增编号放进去了
             HttpContext.Current.Response.Write("<input type='hidden' name='ChkValue' value='" + strChkValue + "' />");      //此次交易所提交的关键数据的数字签名
             HttpContext.Current.Response.Write("<script>");
             HttpContext.Current.Response.Write("document.chinapayForm.submit();");
             HttpContext.Current.Response.Write("</script></form>");
            }       
        }

        //订单号
         private string getOrderID(string orderID)
        {
            //程序中的订单号 案例12022800001
            string orderid = string.Format("{0}{1}{2}", orderID.Substring(0, 4), "12345", orderID.Substring(4)); //订单前四位+商家最后五位+订单后七位
            return orderid;
        }

        //返回交易金额
         private string getTransAmt(string count)
        {
            string moneyCount = count.ToString().Replace(".", "");
            return moneyCount.PadLeft(12, '0');
        }
    }

 

5.    下面的需要解决的就是写四个页面（支付页，银行选择页面，后台接受处理页和用户支付成功后跳转页），银行选择页面，主要是自己定义图标，这里目的就是为了选择不同的网关来对应不同的银行.罗列出常用的银行。

   

protected void Page_Load(object sender, EventArgs e)
    {
        Chinapay cpy = new Chinapay(); 
        string TransDate = "",MerId = "",OrdId = "",TransType = "",TransAmt = "",CuryId = "",ChkValue = "",OrderStatus = "",GateId = "",Priv1 = "";
        bool bolCheck=false;

        TransDate = Request["transdate"].Trim(); //交易日期
        MerId = Request["merid"].Trim();        //商家号
        OrdId = Request["orderno"].Trim();      //订单号
        TransType = Request["transtype"].Trim();//交易类型
        TransAmt = Request["amount"].Trim();    //交易货币值
        CuryId = Request["currencycode"].Trim();   //交易币种
        ChkValue = Request["checkvalue"].Trim();
        OrderStatus = Request["status"].Trim();  //订单状态
        GateId = Request["GateId"].Trim();       //支付网关号
        Priv1 = Request["Priv1"].Trim();         //商户私有域

        ///检验是否是银联chinapay返回的交易数据
        bolCheck = cpy.getCheck(MerId,OrdId,TransAmt,CuryId,TransDate,TransType,OrderStatus,ChkValue);
        if (bolCheck){
            if (OrderStatus == "1001")//交易成功
            {
              
                string myOrderID = OrdId.Replace("12345", string.Empty);//移除商户号后正好是我系统的订单号
                //更新订单表              
                OrderDetailBLL bll = new OrderDetailBLL();
                bll.UpdateStateAll(myOrderID);//订单号                 
            }         
        }
    }

 

三、需要注意的地方

1. 后台接受页面验证签名后还要判断下订单状态 只有1001状态才是成功交易，退款其他 要看文档

2. 商户提交给ChinaPay的交易订单号，订单号的第五至第九位必须是商户号的最后五位（04版的，现在07版不用这样做了），即“12345”；16位长度

     例如商家号是: 8080805801123456   则提交的订单号必须如下形式

      例如    2012123450000000 ;

    这里你要看着 怎么处理比较好，根据这个订单号 能对应上，你网站里面的订单号

    我的订单号生成规则是

     订单号=年数后2位+月数2位+天2位+五位自增数（不够补0）；

     例如 :12030100001; //12年3月1号 第00001个单子，能看出当天的销售量 也就是说 每天售量最大值是99999,一般小商场足够用了。