多啦客传媒平台对接微信摇一摇说明文档
南京鲜老虎微信摇一摇卡券分为现金卡券、折扣卡券、通用券(礼品、创意
等券)三大类;橘花分期平台需要对接到就是一个卡券功能,当微信摇一摇当卡
券通过核销时可以直接在橘花分期平台上进行使用。
摇一摇关注JS API目的是为已开通微信摇一摇周边,且有一定开发能力的商户提供摇一
摇关注能力。商户可以在摇出来的页面直接调用摇一摇关注接口,实现关注公众账号的
功能。
数据示例
关注JS API调用与微信的JS API调用格式一致,如下:
例子:
v
}
引入BeaconAddContactJsBridge
API详细说明
(一)判断是否关注checkAddContactStatus
例子:
(二)跳转到关注页jumpAddContact
例子:
卡券接口概述
微信公众平台本次增加了微信卡券功能,开放接口供商家使用。支持开发者调用接口创建多种类型的卡券,通过下发消息、二维码、JS-SDK等方式进行投放,在用户使用时通过API接口或卡券商户助手完成核销。同时支持接口获取统计数据,以及各个环节给予开发者事件推送。接口调用流程图如下:
卡券HelloWorld
开发者可以通过debug工具,快速完成创建卡券、投放卡券和核销卡券的流程,若要深入了解卡券接口,则需要对对应的部分的文档详细阅读。
debug页面获取
页面地址:https://www.wendangku.net/doc/1213547754.html,/debug/
接口类型:基础支持
接口列表:获取access_token接口
注意事项:参数填写开发者的appid和secret
点击检查问题,即可返回access_token,access_token的有效期是两小时,两小时之后须重新获取
接口地址:获取Access token接口
debug页面获取页面地址:https://www.wendangku.net/doc/1213547754.html,/debug/
接口类型:基础支持
接口列表:上传logo接口
access_token: 上一步获得的access_token
buffer:你选择的图片
点击检查问题,即可获取图片url,在下一步创建卡劵的参数中需要接口地址:上传Logo接口
debug页面创建
页面地址:https://www.wendangku.net/doc/1213547754.html,/debug/
接口类型:卡劵接口
接口列表:创建卡劵接口
access_token:第一步获得的access_token
json: 示例:
注意事项:date_info中用的是Unix时间戳,注意把begin_timestamp修改小于当前时间,end_timestamp修改成今天之后的时间,这样在后面核销卡劵测试才能成功
接口地址:创建卡券接口
debug页面获取
页面地址:https://www.wendangku.net/doc/1213547754.html,/debug/
接口类型:卡劵接口
接口列表:创建二维码ticket接口
access_token:第一步获得的access_token
json示例:
在上一步的返回中点击字段show_qrcode_url字段中的链接,即可显示卡券领取二维码。
示例:
https://https://www.wendangku.net/doc/1213547754.html,/cgi-bin/showqrcode?ticket=gQEr8ToAAAAAAAAAASxodHRwO i8vd2VpeGluLnFxLmNvbS9xLy1YV21CQi1sc3dUS0p1M3NjRjVuAAIE3kqwVQMEgDPhAQ==
打开微信扫一扫,然后领取卡劵,如果显示卡劵未通过审核,那么需要下一步设置测试白名单,如果可以领取就忽略第六步。
debug页面获取
页面地址:https://www.wendangku.net/doc/1213547754.html,/debug/
接口类型:卡劵接口
接口列表:设置测试白名单接口
access_token:第一步获得的access_token
json示例:
注意事项:其中usr1,sur2是领取卡劵的微信号
接口地址:设置白名单接口
debug页面获取
页面地址:https://www.wendangku.net/doc/1213547754.html,/debug/
接口类型:卡劵接口
接口列表:核销卡劵接口
access_token:第一步获得的access_token
json: 示例:
注意事项:仅支持审核通过且在有效期内的卡劵接口地址:核销接口
开发者注意事项
由于微信6.0.2版本后才支持卡券功能模块,低版本用户调用JS-SDK无效。因此,微信团队建议商户通过user agent来确定用户当前的版本号后再调用添加至卡包JS-SDK接口。以iPhone版本为例,可以通过user agent可获取如下版本示例信息:
其中6.0.2为用户安装的微信版本号。商户可以判定版本号是否高于或者等于6.0.2。
公众号会话环境内仅支持调起该公众号域名下的卡券。未经平台允许不支持在公众号会话内推送其他商户的卡券,公众号会话外(如朋友圈、对话环境)无此限制。
特别注意事项
公众号的对话框中发生的行为以及从公众号对话框跳转的网页链接均处于该公众号的会话环境内。
所有API接口POST的数据只支持utf8编码,否则会返回报错。
遇到卡券开发问题,可以通过邮箱weixin_card@https://www.wendangku.net/doc/1213547754.html, 联系我们。也可以加入开发者QQ交流群 198219212,验证请务必说明商家名及业务。
卡券术语介绍
以下是卡券开发过程中需要了解的关键概念:
卡券资料包下载
开发者可下载卡券接口资料包:- 创建&签名工具SDK;
- 卡券接口调用流程图;
- 新增接口特性说明;
- SDK for Android;
- SDK for iOS;