支出微信门户及应用亚洲必赢app在哪下载

By admin in 亚洲必赢app在哪下载 on 2019年4月1日

前边几篇介绍了微信支付方面包车型地铁始末,本篇继续微信接口的一对别样方面包车型大巴剧情:卡劵管理。卡劵管理是微信接口里面格外复杂的三个有的,里面包车型客车接口格外多,我花了许多时间对它进行了打包处理,重构优化等等工作,卡劵在经营销售方面是1个相比较好的门路,能够采纳在会员管理、店铺优惠等方面的运动,可是万层高楼从底起,大家需求把卡劵管理的连带接口抓好完善,才能在它的基础上拓展更进一步的选取操作。

壹 、微信卡券接口表明

微信卡券效能是腾讯为商家提供的一套完整的电子卡券消除方案,卖家可在法律允许的限量内通过该功效完毕电子卡券生成、下发、领取、核销的闭环,并行使对账、卡券管理等配套作用。微信卡券功效可分为API接口成效和民众平台卡券作用,使用二种意义均可实现卡券生成、下发、领取、审核销账,有开发意愿的经纪人可利用API接口功能,无开发意愿商户可选取公众平台卡券功用。

微信公众平台这次扩充了微信卡券效能,开放接口供公司使用。
帮助开发者调用接口创造几连串型的卡券,通过发出新闻、二维码、JS-SDK等艺术展开投放,在用户选用时经过API接口或卡证券商家帮手完毕核销。
同时扶助接口获取总括数据,以及各样环节给予开发者事件推送。 

此时此刻辅助促销券(代金券、折扣券、礼品券、团购券)、会员卡、景点门票、电影票、飞机票、红包、会议门票等各类卡券类型。
开发者能够因此卡券接口火速形成制券、发券及销券流程:

① 、创立卡券接口 开发者可经过该接口,创造卡券,导入/拉取卡券适用门店、获取卡券颜色列表。

二 、卡券投放接口 开发者可因而该接口,生成卡券领取二维码,也可在网页内调用JavaScript接口,辅导用户领取卡券。

叁 、卡券核销接口

调用核销接口可对点名卡券进行核销。接济网页内调用JavaScript接口拉取卡券列表,用户选用卡券后即可完结核销。

肆 、卡券管理接口 开发者可透过该接口,对已创立的卡券实行询问、删除、更改、设置失效等操作。同时,在卡券通过审查、卡券被领取、卡券被剔除时,均会推送事件通报开发者。

伍 、特殊卡票接口 帮助特殊卡票券(会员卡、电影票、飞机票、红包、会议门票)的适用场景,提供对应的接口能力,包涵激活/绑定会员卡、会员卡交易、更新电影票、在线选座、更新红包余额、更新会议门票等接口。

⑥ 、设置测试用户白名单 开发者可设置测试用户白名单,无论卡券是或不是通过审查均可领取卡券,测试整个卡券的选用流程。

为了打探这么些卡劵的扑朔迷离,我们先来看看它的官方的卡劵内容流程图

亚洲必赢app在哪下载 1

以此图里面涉及的内容很多,同样卡劵管理的API接口也很多,但是大家连年希望化繁为简,因而大家得以一步步来打探任何卡劵的内容。

 

二 、卡劵的轩然大波通报

卡劵的连锁事件,会由微信后台布告大家的服务后台,由此大家能够对卡劵的创制、使用等种种方面都有连锁的事件通报,我们在对应的风云上贯彻我们的卡劵管理逻辑也是很有益于的。

上边列出卡劵管理之中的后台消息布告分类。

亚洲必赢app在哪下载 2

这么些音信对应的事件,大家能够放置请求的事件类型里面,那样我们在集合调用事件的时候,就能够对他们进行区分了。

 

亚洲必赢app在哪下载 3

这么我们在微信音讯处理的入口,就能够分级对那一个事件进展处理了。WeixinApiDispatch便是1个散发的管理类,它提取请求音讯的情节,并营造差异品类的消息参数,传递给分裂的响应函数实行拍卖,然后再次来到封装好的XML内容,作为响应。

切实的代码处理逻辑如下图所示。

亚洲必赢app在哪下载 4

这样大家在代码里面就足以对相应个事件实行拍卖了。

亚洲必赢app在哪下载 5

个中咱们注意到,我们对卡劵的例外交事务件,把它们的事件新闻对象化后开展对应的处理的,如下代码所示。

                            case RequestEvent.card_pass_check:      //卡劵通过审核
                            case RequestEvent.card_not_pass_check:  //卡劵未通过审核
                                {
                                    // 卡券通过审核(或审核不通过)
                                    RequestEventCardCheck info = XmlConvertor.XmlToObject<RequestEventCardCheck>(postStr);
                                    if (info != null)
                                    {
                                    }
                                    LogTextHelper.Info(eventName + ((info == null) ? "info is null" : info.ToJson()));
                                }
                                break;

 

三 、卡劵的分类及创立操作

1)卡劵分类

前方介绍了,微信卡劵如今扶助减价券(代金券、折扣券、礼品券、团购券)、会员卡、景点门票、电影票、飞机票、红包、会议门票等多样卡券类型。大家在微信后台,能够手工创设减价卷,如下图所示。

亚洲必赢app在哪下载 6

鉴于各类卡劵之间的多少有一致的一对,也有一对的一对,我们要求在类的范畴上对她们开展不相同的新闻建立模型。

亚洲必赢app在哪下载 7

咱俩再来定义三个卡劵类型的枚举,方便大家在代码中运用,那些枚举对象也带有了我们近来介绍到的那个卡劵类型了。

    /// <summary>
    /// 卡券类型
    /// </summary>
    public enum CardType
    {
        /// <summary>
        /// 折扣券
        /// </summary>
        DISCOUNT = 0,
        /// <summary>
        /// 代金券
        /// </summary>
        CASH = 1,
        /// <summary>
        /// 礼品劵、兑换券
        /// </summary>
        GIFT = 2,
        /// <summary>
        /// 优惠券/通用券
        /// </summary>
        GENERAL_COUPON = 3,
        /// <summary>
        /// 团购券
        /// </summary>
        GROUPON = 4,

        /// <summary>
        /// 会员卡
        /// </summary>
        MEMBER_CARD = 5,
        /// <summary>
        /// 门票
        /// </summary>
        SCENIC_TICKET = 6,
        /// <summary>
        /// 电影票
        /// </summary>
        MOVIE_TICKET = 7,
        /// <summary>
        /// 飞机票
        /// </summary>
        BOARDING_PASS = 8,
        /// <summary>
        /// 红包
        /// </summary>
        LUCKY_MONEY = 9,
        /// <summary>
        /// 会议门票
        /// </summary>
        MEETING_TICKET = 10,
        /// <summary>
        /// 汽车票
        /// </summary>
        BUS_TICKET,
    }

鉴于差异品类卡劵的音信不一样,由此我们需求封闭创制那一个对应的卡劵类,以方便创设对应的新闻用于创建操作。

 

2)创造卡券

开创卡券的接口调用顺序

亚洲必赢app在哪下载 8

里面上传图片,正是运用通用的图纸上传接口上传即可,上传后得到对应的图形UEvoqueL地址。

上传图片接口调用请求表明

HTTP请求方式: POST/FROM
URL:https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN

降价劵的背景象,在微信里面有部分参阅色样,如下图所示。

亚洲必赢app在哪下载 9

成立卡券接口是微信卡券的基础接口,用于创设一类新的卡券,获取card_id,创立成功并通过审查批准后,商行能够经过文档提供的任何接口将卡券下发给用户,每回成功领取,仓库储存数据相应扣除。

接口调用请求表达

HTTP请求方式: POST
URL: https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN

 

参数表明

参数 是否必须 说明
access_token 调用接口凭证
POST数据 Json数据

 

 

 

两种不一致系列的卡劵,他们POST的JSON对象新闻都以不太一致的,如团购劵的实业新闻如下所示。

 

团购券

参数名 必填 类型 示例值 描述
card_type string(24) GROUPON 团购券类型。
base_info JSON结构 见上述示例。 基本的卡券数据,见下表,所有卡券类型通用。
deal_detail string(3072) 双人套餐\n -进口红酒一支。\n孜然牛肉一份。 团购券专用,团购详情。

 

 

 

 

 

 

 

 

团购劵JSON示例

{
 "card": {
     "card_type": "GROUPON",
     "groupon": {
         "base_info": {
         ················
         },
          "advanced_info": {
         ················
          },
         "deal_detail": "示例"
     }
 }
}

 

而代金券提交的消息如下所示。

代金券

参数名 必填 类型 示例值 描述
card_type string(24) CASH 代金券类型。
base_info JSON结构 见上述示例。 基本的卡券数据,见下表,所有卡券通用。
least_cost int 10000 代金券专用,表示起用金额(单位为分),如果无起用门槛则填0。
reduce_cost int 10000 代金券专用,表示减免金额。(单位为分)

 

 

 

 

 

 

 

 

代金券JSON示例

{
 "card": {
     "card_type": "CASH",
     "cash": {
         "base_info": {
         ················
         },
          "advanced_info": {
         ················
          },
         "least_cost": 1000,
         "reduce_cost": 100,
     }
 }
}

眼下别的二种档次个卡劵也各有不相同,不在一一赘述,能够看到各个卡劵引导的新闻,有一对同样,有一对不一致,然而它们创立卡劵的时候,使用的是同一个接口,那种接口格局在卡劵接口里面很广泛。

中间卡劵里面包车型客车base_info(卡券基础新闻)字段-必填字段、base_info(卡券基础音信)字段-非必填字段、Advanced_info(卡券高级音讯)字段相比较复杂,具体请参见相关的字段表明列表。

 

成立卡劵的回来表达

多少示例:

{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}

 

参数名 描述
errcode 错误码,0为正常。
errmsg 错误信息。
card_id 卡券ID。

 

 

 

 

肆 、创制卡劵的类定义和API封装

据他们说那几个音讯,大家创设卡劵的时候,大家能够定义不一致的新闻实体,如下所示是卡劵基类和折扣劵的类定义音信。

    /// <summary>
    /// 卡劵基类信息
    /// </summary>
    public class CardJson
    {
        /// <summary>
        /// 基础信息
        /// </summary>
        public CardBaseInfo base_info { get; set; }

        /// <summary>
        /// 高级字段
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public CardAdvanceInfo advanced_info{ get; set; }
    }

    /// <summary>
    /// 折扣券数据
    /// </summary>
    public class DisCountCardJson : CardJson
    {
        /// <summary>
        /// 折扣券专用,表示打折额度(百分比)。填30就是七折。
        /// </summary>
        [JsonProperty(DefaultValueHandling = DefaultValueHandling.Ignore)]
        public int discount { get; set; }
    }

其他卡劵的新闻也是相仿,依照供给扩展即可,如会员卡的消息,大家能够依照上面的接轨关系进展字段的填补即可。

    /// <summary>
    /// 会员卡的详细信息,是CardDetailJson的子类
    /// </summary>
    public class MemberCardJson : CardJson
    {
        /// <summary>
        /// 显示积分,填写true或false,如填写true,积分相关字段均为必填。
        /// </summary>
        [JsonProperty(DefaultValueHandling = DefaultValueHandling.Ignore)]
        public bool supply_bonus { get; set; }

        /// <summary>
        /// 是否支持储值,填写true或false。如填写true,储值相关字段均为必填。
        /// </summary>
        [JsonProperty(DefaultValueHandling = DefaultValueHandling.Ignore)]
        public bool supply_balance { get; set; }

        /// <summary>
        /// 特权说明
        /// 非必填
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string prerogative { get; set; }

        /// <summary>
        /// 设置为true时用户领取会员卡后系统自动将其激活,无需调用激活接口
        /// </summary>
        [JsonProperty(DefaultValueHandling = DefaultValueHandling.Ignore)]
        public bool auto_activate { get; set; }

        /// <summary>
        /// 设置为true时会员卡支持一键激活,不允许同时传入activate_url字段,否则设置wx_activate失效。
        /// 非必填
        /// </summary>
        [JsonProperty(DefaultValueHandling = DefaultValueHandling.Ignore)]
        public bool wx_activate { get; set; }

        ..........

还有此外类型的数额,如会议卡劵,电影卡劵消息等类库也同等处理,别的的根据此规则扩充即可。

    /// <summary>
    /// 会议门票数据
    /// </summary>
    public class MettingTicketJson : CardJson
    {
        /// <summary>
        /// 会议详情
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string meeting_detail { get; set; }

        /// <summary>
        /// 会场导览图
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string map_url { get; set; }
    }

    /// <summary>
    /// 门票数据
    /// </summary>
    public class ScenicTicketJson : CardJson
    {
        /// <summary>
        /// 票类型,例如平日全票,套票等
        /// 非必填
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string ticket_class { get; set; }
        /// <summary>
        /// 导览图url
        /// 非必填
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string guide_url { get; set; }
    }

有了那几个音讯,大家就能够通过合并的接口函数进行卡劵的始建操作了。

亚洲必赢app在哪下载 10

在促成函数的末段,我们就是调用接口的U昂科威L,提交相应的数据就足以了

            var url = string.Format("https://api.weixin.qq.com/card/create?access_token={0}", accessToken);
            var result = JsonHelper<CardCreateResultJson>.ConvertJson(url, cardData);
            return result != null ? result.card_id : null;

 

假若对那几个《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)–起头应用微信接口

 

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图
Copyright @ 2010-2019 亚洲必赢app官方下载 版权所有