微信关注现金红包活动2017 微信有奖红包活动
淘宝搜:【天降红包222】领超级红包,京东搜:【天降红包222】
淘宝互助,淘宝双11微信互助群关注公众号 【淘姐妹】
英大财险邀友领10-100元京东E卡活动 2022-08-30 活动内容:英大财险邀请好友领取10-100元京东E卡、滴滴出行券——微信扫码英大财险邀请好友领取10-100元京东E卡、滴滴出行券推文“点击这里”进入生成自己邀请二维码,邀请好友关注达到5/15/30/50/100人会收到推文进入可... 英大财险邀友领10-100元京东E卡活动 2022-08-30 活动内容:英大财
公众号申请领取卡券接口 微信公众号卡券开发java
怎么领取公众号,公众号免费领取是真的吗?,微信公众号申请成功后怎么使用,怎么申领微信公众号- 说明
- 卡券术语介绍
- 卡券生命周期流程图
- 准备
- 申请开发账号
- 公众平台开发配置
- 公众号开发信息配置
- 填写服务器配置并验证有效性
- 申请微信认证及开通微信卡券功能
- 卡券分类
- 普通卡券
- 会员卡券
- 朋友的券
- 特殊票券
- 接口开发
- 创建卡券
- 1. 获取【【微信】】接口
- 2. 上传卡券Logo
- 3. ~~设置卡券适用门店~~(可选)
- 4. 选取卡券背景颜色
- 5. 创建卡券(这里以团购券为例)
- 注意事项
- 跳转外链带参数说明
- 投放卡券
- 二维码投放
- 【【微信】】投放
- 微信卡券货架投放
- 公众号下发消息投放
- 添加测试白名单账号
- 核销卡券
- 线下核销
- 线上核销
- 管理卡券
- 查询Code状态接口
- 获取用户已领取卡券接口
- 删除卡券接口
- 设置卡券快速买单
- 设置自助核销接口
- 更新卡券信息接口
- 修改库存接口
- 更改code接口
- 设置卡券失效接口
- 查看卡券详情
- 批量查询卡券列表
- 小程序接入微信卡券
- 开发准备
- 接口说明
- 添加卡券(wx.【【微信】】)
- 查看卡券(wx.openCard)
- 扩展
- 微信公众帐号测试号申请系统
- 微信公众平台接口调试工具
- 微信公众平台开发者文档
- 微信【【微信】】说明文档
- 微信卡券接口说明
- 微信卡券扩展字段及签名生成算法
- 卡券签名【【微信】】说明
- 卡券扩展字段cardExt说明
- 微信卡券创建接口字段
- 卡券创建接口POST报文示例
- 卡券基础信息base_info字段
- 卡券高级信息ad【【微信】】字段
- 微信卡券如何让用户购买后领取
《微信公众平台卡还δ芙尤胫改稀方樯芪⑿殴众平台提供卡券的创建、投放、核销整套的流程,为什么还提供API接口操作方式?卡券API接口提供更加丰富的卡券功能(公众平台不具备的),我们可通过API接口形式来创建更加多样化的卡券(例如:设置卡券关联小程序、会员卡的储值功能、以及卡券的自助买单等等)。
。
卡券术语介绍
以下是卡券开发过程中需要了解的关键概念:
参数名 | 描述 |
---|---|
【【微信】】 | 卡券ID。一个卡券ID对应一类卡券,包含了相应库存数量的Code码。 |
code | 卡券Code码。一张卡券的唯一标识,核销卡券时使用此串码,支持商户自定义。 |
openid | 用户在该公众号下的唯一身份。 |
【【微信】】 | 调用接口的凭证,有效时间为7200s,每次请求刷新, 通过 获取【【微信】】接口 获取,开发者需妥善保存并建立缓存机制。 |
jsapi_ticket | 调用微信内网页调用微信原生功能的【【微信】】接口须使用的签名票据,详情见: 【【微信】】部分 |
api_ticket | 调用微信卡券接口时签名的临时票据,有效时间为7200s, 7200s内重复请求保持不变,通过 获取api_ticket接口 获取。 |
card_ext | 可扩展的卡券的附加信息,用于投放卡券时附带卡券基本信息。 |
outer_str | 领券渠道的场景值 。支持商户自定义场景值填入card_ext进行卡券投放, 当用户领取时会将相应场景值通过事件通知商户。 |
事件推送 | 在 卡券通过审核、卡券被领取、卡券被删除、卡券被核销 时, 均会推送事件通知开发者,接收地址为公众平台开发者中心填写的服务器URL。 |
自定义入口 | 通过API创建卡券支持商户自定义卡券详情页跳转外链的单元,用户跳转至该链接时会在链接后缀有卡券的【【微信】】和加密的code。 |
卡券生命周期流程图
申请开发账号
申请一个公众平台账号
公众平台开发配置
申请微信公众平台开发者账号后,开发者需要按照如下步骤完成:
公众号开发信息配置
填写服务器配置并验证有效性
申请微信认证及开通微信卡券功能
下面详细介绍这3个步骤。
公众号开发信息配置
账号申请完成后,我们进入公众平台官网的,首先完成公众号开发信息配置,包括启用和配置
填写服务器配置并验证有效性
然后,继续下面的服务器配置点击按钮,填写服务器地址(URL)、Token和EncodingAESKey,其中
-
URL是开发者用来接收微信消息和事件的接口URL
用户每次向公众号发送消息、或者产生自定义菜单、或产生微信支付订单等情况时,开发者填写的服务器配置URL将得到微信服务器推送过来的消息和事件,开发者可以依据自身业务逻辑进行响应,如回复消息)。
-
Token可由开发者可以任意填写,用作生成签名
,因此填写的url地址内需要实现返回业务逻辑,下面会有代码示例,从而验证安全性)。
-
EncodingAESKey由开发者手动填写或随机生成,将用作消息体加解密密钥。
同时,开发者可选择消息加解密方式:
- 明文模式
- 兼容模式
- 安全模式
模式的选择与服务器配置在提交后都会立即生效,请开发者谨慎填写及选择。加解密方式的默认状态为明文模式,选择兼容模式和安全模式需要提前配置好相关加解密代码,详情请参考消息体签名及加解密部分的文档 。
填写好以后提交,微信服务器将发送GET请求到您填写的服务器地址URL上,GET请求携带参数如下表所示:
参数 | 描述 |
---|---|
【【微信】】 | 微信加密签名,【【微信】】结合了开发者填写的token参数和请求中的【【微信】】参数、nonce参数。 |
【【微信】】 | 时间戳 |
nonce | 随机数 |
echostr | 随机字符串 |
开发者通过检验【【微信】】对请求进行校验(下面有校验方式)。若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,成为开发者成功,否则接入失败。加密/校验流程如下:
-
将token、【【微信】】、nonce三个参数进行字典序排序
-
将三个参数字符串拼接成一个字符串进行sha1加密
-
开发者获得加密后的字符串可与【【微信】】对比,标识该请求来源于微信
检验【【微信】】的PHP示例代码:
PHP示例代码下载:下载
申请微信认证及开通微信卡券功能
在进行公众平台开发配置后,成为开发者。此时您仅具备较少的接口权限,商户如需进行卡券开发,需要在公众平台网站中申请微信认证并开通微信卡券功能,认证成功后,将获得更多接口权限,满足更多业务需求。
您也可以利用 微信公众帐号测试号申请系统来申请一个测试的公众平台开发账号(免去认证复杂流程)
注意
- 微信公众平台开发是指为微信公众号进行业务开发,为移动应用、PC端网站、公众号第三方平台(为各行各业公众号运营者提供服务)的开发,请前往微信开放平台接入。
- 在申请到认证公众号之前,你可以先通过测试号申请系统,快速申请一个接口测试号,立即开始接口测试开发。
- 在开发过程中,可以使用接口调试工具来在线调试某些接口。
- 。
- 在开发出现问题时,可以通过接口调用的返回码,以及报警排查指引(在公众平台官网-开发者中心处可以设置接口报警),来发现和解决问题。
- 。
- 微信公众号接口必须以http://或https://开头,分别支持80端口和443端口。
配置好商户开发信息后,商户开发者可依据接口文档实现业务逻辑。
普通卡券
普通卡券包含:、、、、
普通卡券特点
- 折扣券:为用户提供消费折扣。
- 代金券:可为用户提供现金减免服务。
- 礼品券:可为用户提供消费赠品服务。
- 团购券:可为用户提供团购套餐服务。
- 优惠券:即通用券,商户可自定义服务内容程度较高。
会员卡券
会员卡具体介绍及相关接口参考《创建会员卡》
朋友的券
是基于微信优惠券推出的新功能,实现的快速社交传播和转化的效果。
领取并与朋友共享此券,券会自动展示在领取人及其朋友的优惠券列表中,领取人及其朋友均可使用此券。商户可选择赠送配置:当”朋友的券”被使用后,根据商户配置的赠送量,使用者将立即获赠一张,继续与朋友共享此券。更多说明可参考《朋友的券》
注意
- 。
- (可参考《朋友共享的优惠券使用规则》―开放范围),凡是符合本次开放类目商户均可看到朋友的券入口。
特殊票券
微信卡券特殊的券包含:、、、。具体相关API接口操作可参考《特殊票券》
注:以下示例针对普通卡券操作
当具备微信公众平台合法账号,且经过微信认证具备相应权限后,我们可使用AppID和appsecret来进行微信相关接口调试,我们可使用 微信公众平台接口调试工具 选择合适的接口,系统会生成该接口的参数表,您可以直接在文本框内填入对应的参数值。(红色星号表示该字段必填)点击检查问题按钮,即可得到相应的调试信息。(以下是使用测试账号的进行调试)
创建卡券
1. 获取【【微信】】接口
【【微信】】是公众号的全局唯一接口调用凭据,。开发者需要进行妥善保存。【【微信】】的存储至少要保留512个字符空间。【【微信】】的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的【【微信】】失效。
,更多注意事项可阅读《获取Access token》
接口调用
http请求方式: GET
URL:https://api.weixin.qq.com/【【微信】】/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
请求参数
grant_type | 是 | 获取【【微信】】填写client_credential |
---|---|---|
appid | 是 | 第三方用户唯一凭证 |
secret | 是 | 第三方用户唯一凭证密钥,即appsecret |
响应参数
【【微信】】 | 获取到的凭证 |
---|---|
expires_in | 凭证有效时间,单位:秒 |
正常情况下,微信会返回下述JSON数据包给公众号:
2. 上传卡券Logo
接口调用
HTTP请求方式: POST/FROM(表单形式提交Logo图片)
URL:https://api.weixin.qq.com/【【微信】】/media/uploadimg?【【微信】】=ACCESS_TOKEN
响应报文
3. 设置卡券适用门店(可选)
适用场景
拥有线下门店的商户,使用前商户需调用微信门店接口,设置门店。详情参考《微信门店接口》
4. 选取卡券背景颜色
选择卡券背景适用色值
在创建卡券接口中将颜色名(如Color010)填入color字段。
目前微信提供以下十四种色值供开发者使用。
背景颜色名称 | 色值 | 颜色 |
Color010 | #63b359 | |
Color020 | #2c9f67 | |
Color030 | #509fc9 | |
Color040 | #5885cf | |
Color050 | #9062c0 | |
Color060 | #d09a45 | |
Color070 | #e4b138 | |
Color080 | #ee903c | |
Color081 | #f08500 | |
Color082 | #a9d92d | |
Color090 | #dd6549 | |
Color0100 | #cc463d | |
Color0101 | #cf3e36 | |
Color0102 | #5E6671 |
5. 创建卡券(这里以团购券为例)
经过上述步骤之后,我们可调用创建卡券接口来创建一类新的卡券,获取【【微信】】。创建卡券成功并通过审核后,商家可以通过文档提供的其他接口将卡券下发给用户,每次成功领取,库存数量相应扣除。
接口调用
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/【【微信】】?【【微信】】=ACCESS_TOKEN
请求参数说明
参数 | 是否必须 | 说明 |
---|---|---|
【【微信】】 | 是 | 调用接口凭证 |
POST数据 | 是 | Json数据 |
POST数据示例请参考扩展《卡券创建接口POST报文示例》
普通卡券字段示例 会员卡字段示例 POST数据格式如下
团购券
参数名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | GROUPON | 团购券类型。 |
base_info | 是 | JSON结构 | 见扩展《卡券创建接口POST报文示例》 | 基本的卡券数据 ,见扩展《卡券基础信息base_info字段》,所有卡券类型通用。 |
ad【【微信】】 | 否 | JSON结构 | 见扩展《卡券创建接口POST报文示例》 | 卡券高级信息字段,见扩展《卡券高级信息ad【【微信】】》,所有卡券类型通用。 |
deal_detail | 是 | string( 3072 ) | 双人套餐 -进口红酒一支。 孜然牛肉一份。 | 团购券专用,团购详情。 |
代金券
参数名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | CASH | 代金券类型。 |
base_info | 是 | JSON结构 | 见扩展《卡券创建接口POST报文示例》 | 基本的卡券数据 ,见扩展《卡券基础信息base_info字段》,所有卡券类型通用。 |
ad【【微信】】 | 否 | JSON结构 | 见扩展《卡券创建接口POST报文示例》 | 卡券高级信息字段,见扩展《卡券高级信息ad【【微信】】》,所有卡券类型通用。 |
least_cost | 是 | int | 10000 | 代金券专用,表示起用金额(单位为分),如果无起用门槛则填0。。 |
reduce_cost | 是 | int | 10000 | 代金券专用,表示减免金额。(单位为分) |
折扣券
参数名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | DISCOUNT | 折扣券类型。 |
base_info | 是 | Json结构 | 见扩展《卡券创建接口POST报文示例》 | 基本的卡券数据 ,见扩展《卡券基础信息base_info字段》,所有卡券类型通用。 |
ad【【微信】】 | 否 | JSON结构 | 见扩展《卡券创建接口POST报文示例》 | 卡券高级信息字段,见扩展《卡券高级信息ad【【微信】】》,所有卡券类型通用。 |
discount | 是 | int | 30 | 折扣券专用,表示打折额度(百分比)。填30就是七折。 |
兑换券
参数名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
card_type | 是 | string(24) | GIFT | 兑换券类型。 |
base_info | 是 | Json结构 | 见扩展《卡券创建接口POST报文示例》 | 基本的卡券数据 ,见扩展《卡券基础信息base_info字段》,所有卡券类型通用。 |
ad【【微信】】 | 否 | JSON结构 | 见扩展《卡券创建接口POST报文示例》 | 卡券高级信息字段,见扩展《卡券高 版权声明:除非特别标注原创,其它均来自互联网,转载时请以链接形式注明文章出处。
|