微信支付接入和API封装使用

在微信的利用上,微信支付是一个相比较实用的片段,但也是相比较复杂的技术中央,在微商大行其道的年份,自己的店家没有扩张微信支付类似也说但是去,微信支付目的在于为广泛微信用户及商户提供更优质的支出服务,微信的付出和哈密系统由腾讯财付通提供支撑。本文紧要介绍咋样在微信公众号上贯彻微信支付的过渡、微信支付API的卷入,以及API的调用,实现大家有些科普的工作调用。

1、开通微信支付并部署

微信支付是急需微信公众号的辨证基础,也就是只对验证的民众号开放,微信认证需要签字相关的材料,并且开展对账认证,一般会有电话联系确认有关的信息的。

必发bifa88手机客服端 1

在微信支付API起头运用前,我们一般需要在后台举行自然的部署,如大家需要配备公众号支付的授权目录,测试白名单等消息,以及扫码补助的回调处理地方(这一个实现在背后再讲),如下所示。

必发bifa88手机客服端 2

在应用API在此之前,我们要掌握微信一些重点的操作,如退款、撤除订单等操作是索要评释的,而且健康的支付操作,我们也亟需经纪人号、商户支付秘钥等信息,这么些阐明和秘钥新闻,是我们从微信支付的生意人平台上获取的,我们微信支付开通并查处通过后,我们就可以登录商户平台拓展有关的操作了。

率先我们需要在付出的电脑上设置证书。

必发bifa88手机客服端 3

下一场需要安装API的秘钥

必发bifa88手机客服端 4

最终在【API安全】项目上下载证书供我们付出环境使用。

必发bifa88手机客服端 5

 

2、微信支付API的介绍

微信支付配置相关的参数,并得到证件、API秘钥、商户号等音讯后,我们可以开端精通微信支付的API的实际使用了,大家需要先把API封装为C#的类库举办利用,这样才能在各个应用里面方便调用。

微信支付分为有多种主意,如扫码支付、公众号支付、JSAPI支付、APP支付等地点,不过基本的API都差不多,基本上都覆盖了下边截图的多少个API,只是有一部分的接口差别。

必发bifa88手机客服端 6

咱俩得以从里面扫码支付先导询问,这个是对二维码举办扫码支付的场景,分为了形式一和情势二二种情势。

必发bifa88手机客服端 7

必发bifa88手机客服端,扫码支付可分为三种格局,商户按照支付场景采取相应模式。

【情势一】:商户后台系统基于微信支付规则链接生成二维码,链接中带固定参数productid(可定义为产品标识或订单号)。用户扫码后,微信支付体系将productid和用户唯一标识(openid)回调商户后台系统(需要安装支出回调URL),商户后台系统基于productid生成支付交易,最终微信支付系列倡导用户支出流程。

【格局二】:商户后台系统调用微信支付【统一下单API】生成预付交易,将接口重返的链接生成二维码,用户扫码后输入密码完成开发交易。注意:该情势的预付单有效期为2刻钟,过期后无法支付。

依据扫码支付的API表达,我们可以分级对那些接口(如统一下单、查询订单、关闭订单、申请退款、查询退款、下载对账单等接口举行逐一封装,以有益我们的开销使用。

形式一和情势二,都亟需运用到了合并下单的接口,然后生成对应的二维码给客户扫码支付应用。

这就是说大家先来探视统一下单的接口表达,以明白它的实际运用。

1)应用场景

除被扫支付场景以外,商户系统先调用该接口在微信支付服务后台生成预支付交易单,再次来到正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同景观生成交易串调起支付。

2)接口链接

URL地址:https://api.mch.weixin.qq.com/pay/unifiedorder

3)是否需要讲明

不需要

4)请求参数

呼吁参数近似很多,大概分为两片段,一部分是系统必须的固定参数,一部分是工作所需的参数。

系统必须的一直参数如下所示。

必发bifa88手机客服端 8

一些是事情参数,业务参数如下所示,重要是记录订单的连带产品ID、表达、费用等等

必发bifa88手机客服端 9

微信支付接口的调用和群众号另外接口调用不太雷同,这里所有是使用XML举行交流的,感觉并未JSON那么便民灵活,如下所示是统一下单的接口提交数据。

必发bifa88手机客服端 10 

下一场回来的数据也是XML的,如下边例子代码所示,而且内部的字段内容还不太确定,由此按官网的指出,使用字典集合来囤积重回的数额对象。

必发bifa88手机客服端 11

 

3、微信支付APIC#打包和调用

按照地点的叙说,大家大致了然了微信支付API
的大概表达,遵照这一个信息,我们可以对它举行C#代码的包装了,对于代码的卷入,我们关键点在中间第一个,假如顺利封装好第一个接口,那么后边的依照通用的模式,就很容易继续处理这么些接口了。

譬如,大家能够定义好微信支付的API接口定义,如下所示。

    /// <summary>
    /// 微信支付接口
    /// </summary>
    public interface ITenPayApi
    {      
        /// <summary>
        /// 生成扫描支付模式一URL
        /// </summary>
        /// <param name="productId">商品ID</param>
        /// <returns></returns>
        string GetPrePayUrl(string productId);

        /// <summary>
        /// 生成直接支付url,支付url有效期为2小时,模式二
        /// </summary>
        /// <param name="info">商品订单数据</param>
        /// <returns></returns>
        string GetPayUrl(WxPayOrderData info);

        /// <summary>
        /// 统一下单。(不需要证书,默认不需要)
        /// 除被扫支付场景以外,商户系统先调用该接口在微信支付服务后台生成预支付交易单,
        /// 返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。
        /// </summary>
        /// <param name="info">商品订单数据</param>
        WxPayData UnifiedOrder(WxPayOrderData info);

        .............

里头的接口方法的输入参数我们定义一个实体类 WxPayOrderData 来存储一些业务参数,那么些参数遵照第二点的接口表明进行定义,代码如下所示

    /// <summary>
    /// 统一下单的商品订单信息
    /// </summary>
    public class WxPayOrderData
    {
        /// <summary>
        /// 商品ID, trade_type=NATIVE,此参数必传
        /// </summary>
        public string product_id { get; set; }
        /// <summary>
        /// 商品或支付单简要描述
        /// </summary>
        public string body { get; set; }
        /// <summary>
        /// 订单总金额,单位为分
        /// </summary>
        public int total_fee { get; set; }
        /// <summary>
        /// 商品标记,代金券或立减优惠功能的参数,说明详见代金券或立减优惠
        /// </summary>
        public string goods_tag { get; set; }

        /// <summary>
        /// 交易类型,默认为:NATIVE。
        /// JSAPI--公众号支付、NATIVE--原生扫码支付、APP--app支付
        /// </summary>
        public string trade_type { get; set; }

        /// <summary>
        /// 商品名称明细列表
        /// </summary>
        public string detail { get; set; }
        /// <summary>
        /// 附加数据
        /// 在查询API和支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
        /// </summary>
        public string attach { get; set; }
        /// <summary>
        /// 用户标识
        /// trade_type=JSAPI,此参数必传,用户在商户appid下的唯一标识。
        /// </summary>
        public string openid { get; set; }

        public WxPayOrderData()
        {
            this.trade_type = "NATIVE";
        }
    }

然后我们定义一个接口再次来到的类WxPayData,它用来储存重回的目标信息的,那个类在官网例子里面有认证,其内部内置一个排序过的字典对象举行仓储数据,部分代码如下所示,我对它举办了连带的修改,以便于在构造函数里面起头化一些必不可少的参数(固定参数)。

    public class WxPayData
    {
        //采用排序的Dictionary的好处是方便对数据包进行签名,不用再签名之前再做一次排序
        private SortedDictionary<string, object> m_values = new SortedDictionary<string, object>();

        /// <summary>
        /// 默认构造函数
        /// 如果initDefault为true,则自动填入字段(appid,mch_id,time_stamp,nonce_str,out_trade_no,)
        /// </summary>
        public WxPayData(bool initDefault = false)
        {
            if(initDefault)
            {
                Init();
            }
        }

        /// <summary>
        /// 对象初始化后,自动填入字段(appid,mch_id,time_stamp,nonce_str,out_trade_no,)
        /// </summary>
        public void Init()
        {
            //初始化几个参数
            this.SetValue("appid", WxPayConfig.APPID);//公众帐号id
            this.SetValue("mch_id", WxPayConfig.MCHID);//商户号
            this.SetValue("nonce_str", GenerateNonceStr());//随机字符串
            this.SetValue("out_trade_no", GenerateOutTradeNo(WxPayConfig.MCHID));//随机字符串

        }

接下来大家依照下面的数额定义,可以兑现统一下单的函数内容,首假若把输入参数转换为我们需要的字典参数集合,如下代码所示。

        /// <summary>
        /// 统一下单。(不需要证书,默认不需要)
        /// 除被扫支付场景以外,商户系统先调用该接口在微信支付服务后台生成预支付交易单,
        /// 返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。
        /// </summary>
        /// <param name="info">商品订单数据</param>
        public WxPayData UnifiedOrder(WxPayOrderData info)
        {
            WxPayData data = new WxPayData(true);
            data.SetValue("product_id", info.product_id);//商品ID
            data.SetValue("openid", info.openid);//商品ID

            //其他信息
            data.SetValue("body", info.body);//商品描述
            data.SetValue("attach", info.attach);//附加数据
            data.SetValue("total_fee", info.total_fee);//总金额
            data.SetValue("goods_tag", info.goods_tag);//商品标记
            data.SetValue("trade_type", info.trade_type);//交易类型

            //默认构建
            data.SetValue("time_start", DateTime.Now.ToString("yyyyMMddHHmmss"));//交易起始时间
            data.SetValue("time_expire", DateTime.Now.AddMinutes(10).ToString("yyyyMMddHHmmss"));//交易结束时间

          ..............

最终的数据互换逻辑,我们经过对URL举办POST提交XML数据给它拿到重临结果就可以了,如下所示。

            string url = "https://api.mch.weixin.qq.com/pay/unifiedorder";
            return GetPostResult(data, url);

个中地方的函数的代码逻辑如下所示,紧假设把重回的结果再还原为XML对象类WxPayData。

        /// <summary>
        /// 通用的获取结果函数
        /// </summary>
        private WxPayData GetPostResult(WxPayData data, string url)
        {
            string xml = data.ToXml();
            string response = helper.GetHtml(url, xml, true);

            WxPayData result = new WxPayData();
            result.FromXml(response);
            return result;
        }   

对于扫码操作的形式二,直接生成一种二维码,不需要后台实行回调的,那么它的兑现逻辑只需要对地点代码举行包装就可以了,如先构建二维码的函数代码如下所示。

        /// <summary>
        /// 生成直接支付url,支付url有效期为2小时,模式二
        /// </summary>
        /// <param name="info">商品订单数据</param>
        /// <returns></returns>
        public string GetPayUrl(WxPayOrderData info)
        {
            WxPayData result = UnifiedOrder(info);//调用统一下单接口
            return result.GetString("code_url");//获得统一下单接口返回的二维码链接
        }

如在Winform界面里面,调用生成二维码的代码如下所示,重要逻辑就是构建好二维码,然后展现在界面上。

        private void btnGetPayUrl_Click(object sender, EventArgs e)
        {
            //测试扫码模式二的生成二维码方式
            WxPayOrderData data = new WxPayOrderData()
            {
                product_id = "123456789",
                body = "测试支付-模式二",
                attach = "爱奇迪技术支持",
                detail = "测试扫码支付-模式二",
                total_fee = 1,
                goods_tag = "test1"
            };

            var url = api.GetPayUrl(data);
            var image = api.GenerateQRImage(url);

            this.imgGetPayUrl.Image = image;
            this.imgGetPayUrl.SizeMode = PictureBoxSizeMode.StretchImage;
        }

必发bifa88手机客服端 12

其余对于情势一,它在前端传入一个大概的出品ID,生成二维码,当用户扫码的时候,微信后台会调用商户平台(大家服务器)的回调处理模式,这么些回调方法会调用统一下单的API举行变更支付交易,过程有点复杂,大家来探视,我们的贯彻代码如下所示。

        /// <summary>
        /// 生成扫描支付模式一URL
        /// </summary>
        /// <param name="productId">商品ID</param>
        /// <returns></returns>
        public string GetPrePayUrl(string productId)
        {
            WxPayData data = new WxPayData(true);
            data.SetValue("product_id", productId);//商品ID     
            data.SetValue("time_stamp", data.GenerateTimeStamp());//随机字符串         
            data.SetValue("sign", data.MakeSign());//签名

            string str = data.ToUrlParams();//转换为URL串
            string url = "weixin://wxpay/bizpayurl?" + str;

            return url;
        }

它的调用代码生成二维码操作如下所示。

        private void btnGetPrePayUrl_Click(object sender, EventArgs e)
        {
            var productId = "12345678";
            var url = api.GetPrePayUrl(productId);
            var image = api.GenerateQRImage(url);

            this.imgGetPrePayUrl.Image = image;
            this.imgGetPayUrl.SizeMode = PictureBoxSizeMode.StretchImage;
        }

咱俩在率先小节里面介绍了,需要在微信后台配置扫码的回调函数,如下所示。

必发bifa88手机客服端 13

这样大家还索要加上一个页面aspx、或者一般处理程序ashx的艺术来促成扫码的回调过程。具体的逻辑也就是在这么些页面里面拿到到提交过来的参数,然后调用统一下单处理后,举办数量重回即可,代码逻辑如下所示。

必发bifa88手机客服端 14

 

4、在页面上进展扫码处理

面前的事例,我介绍了Winfrom的扫码例子,很多时候,大家的应用可能是基于Web的,那么它的落实是怎么样的啊,下边我继续介绍一下。

先是我们在协调的政工Web后台系统里头,添加几个页面,首假使用来生成二维码在页面上拓展展示的,如下所示。

必发bifa88手机客服端 15

终极我们在NativePayPage.aspx页面上体现我们的二维码,方便用户展开扫码支付处理,页面的代码很简短,我们只需要在前者页面放置四个图片控件,图片内容通过MakeQRCode.aspx页面进行生成就可以了。

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <meta http-equiv="content-type" content="text/html;image/gif;charset=utf-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1" /> 
    <title>微信支付样例-扫码支付</title>
</head>
<body>
    <div style="margin-left: 10px;color:#00CD00;font-size:30px;font-weight: bolder;">扫码支付模式一</div><br/>
    <asp:Image ID="Image1" runat="server" style="width:200px;height:200px;"/>
    <br/><br/><br/>
    <div style="margin-left: 10px;color:#00CD00;font-size:30px;font-weight: bolder;">扫码支付模式二</div><br/>
    <asp:Image ID="Image2" runat="server" style="width:200px;height:200px;"/>

</body>
</html>

页面后台的代码就是绑定二维码的经过,代码如下所示,和Winform的代码类似操作。

        protected void Page_Load(object sender, EventArgs e)
        {
            TenPayApi api = new TenPayApi();

            var productId = "123456789";
            //生成扫码支付模式一url
            string url1 = api.GetPrePayUrl(productId);

            //生成扫码支付模式二url
            WxPayOrderData info = new WxPayOrderData()
            {
                product_id = "123456789",
                body = "测试支付-模式二",
                attach = "爱奇迪技术支持",
                detail = "测试扫码支付-模式二",
                total_fee = 1,
                goods_tag = "test1"
            };
            string url2 = api.GetPayUrl(info);

            //将url生成二维码图片
            Image1.ImageUrl = "MakeQRCode.aspx?data=" + HttpUtility.UrlEncode(url1);
            Image2.ImageUrl = "MakeQRCode.aspx?data=" + HttpUtility.UrlEncode(url2);
        }

心想事成后的页面效果如下所示。

必发bifa88手机客服端 16

贯彻并预览效果,确定是大家所需的页面后,我们可以宣布在万众号的菜系连接上进行测试使用了。

必发bifa88手机客服端 17

开拓微信公众号-布宜诺斯Ellis爱奇迪,我们得以看六柱预测应的菜系暴发改变,并且探望进入微信支付的菜谱能够开展开发了。

必发bifa88手机客服端 18  必发bifa88手机客服端 19  必发bifa88手机客服端 20

 

以上就是微信支付的扫码过程的一个落实,微信支付还包括不少其他API接口,前面有机会可以持续展开介绍。微信支付的接口实现即便相对其他微信接口相比复杂一些,可是我们假诺完成多少个案例,前面的就相对相比较便于的了,因为它的调用情势大多相比一致,很接近。

 

一旦对这么些《C#支付微信门户及使用》系列感兴趣,可以关注自身的此外作品,系列小说如下所示:

C#支付微信门户及使用(36)–微信卡劵管理的卷入操作

C#支付微信门户及运用(35)–微信支付之公司付款封装操作

C#开发微信门户及应用(34)–微信裂变红包

C#支出微信门户及运用(33)–微信现金红包的包装及使用

C#支付微信门户及应用(32)–微信支付接入和API封装使用

C#开发微信门户及采用(31)–微信语义了解接口的实现和拍卖

C#付出微信门户及利用(30)–音讯的群发处理和预览功效

C#支出微信门户及使用(28)–微信“摇一摇·周边”效能的利用和接口的落实

C#支付微信门户及采纳(27)-公众号模板音讯管理 

C#开发微信门户及利用(26)-公众号微信资料管理

C#开发微信门户及使用(25)-微信公司号的客户端管住效用

C#付出微信门户及运用(24)-微信小店货架新闻保管

C#支付微信门户及应用(23)-微信小店商品管理接口的卷入和测试

C#支付微信门户及采纳(22)-微信小店的开销和行使

C#付出微信门户及利用(21)-微信集团号的音讯和事件的收受处理及解密 

C#付出微信门户及应用(20)-微信集团号的菜系管理

C#支出微信门户及接纳(19)-微信公司号的音讯发送(文本、图片、文件、语音、录像、图文信息等)

C#付出微信门户及拔取(18)-微信公司号的通讯录管理支付之成员管理

C#开发微信门户及运用(17)-微信集团号的通讯录管理支出之部门管理

C#支出微信门户及使用(16)-微信集团号的布局和使用

C#开发微信门户及应用(15)-微信菜单扩大扫一扫、发图片、发地理地点功用

C#支出微信门户及利用(14)-在微信菜单中运用重定向获取用户数据

C#支付微信门户及采取(13)-使用地理地点扩张相关应用

C#付出微信门户及使用(12)-使用语音处理

C#开发微信门户及采纳(11)–微信菜单的多种表现方法介绍

C#支出微信门户及应用(10)–在治本序列中一块微信用户分组音讯

C#支付微信门户及运用(9)-微信门户菜单管理及提交到微信服务器

C#付出微信门户及运用(8)-微信门户应用管理体系功效介绍

C#开发微信门户及采纳(7)-微信多客服效能及支出集成

C#支付微信门户及运用(6)–微信门户菜单的管理操作

C#开发微信门户及应用(5)–用户分组信息保管

C#支出微信门户及采纳(4)–关注用户列表及详细消息管理

C#支付微信门户及利用(3)–文本信息和图文音信的作答

C#开发微信门户及采纳(2)–微信信息的拍卖和回答

C#付出微信门户及利用(1)–着手应用微信接口

 

相关文章