多啦客传媒平台对接微信摇一摇说明文档副本

南京多啦客网络传媒有限公司 近场营销解决方案 多啦客传媒平台对接微信摇一摇说明文档 南京鲜老虎微信摇一摇卡券分为现金卡券 折扣卡券 通用券 礼品 创 意等券 三大类 橘花分期平台需要对接到就是一个卡券功能 当微信摇一摇 当卡券通过核销时可以直接在橘花分期平台上进行使用 摇一摇关注摇一摇关注 JSJS APIAPI 摇一摇关注 JS API 目的是为已开通微信摇一摇周边 且有一定开发能力的商户提供摇 一摇关注能力 商户可以在摇出来的页面直接调用摇一摇关注接口 实现关注公众账号 的功能 数据示例数据示例 关注 JS API 调用与微信的 JS API 调用格式一致 如下 公用函数公用函数 invokeinvoke 用途主动调用指定 API 通用形式 BeaconAddContactJsBridge invoke API 名称 调用参 数 注意 文档中所有代码只能在微信摇周边的场景下才能正确运行 直接在微信浏览器中打开网页 BeaconAddContactJsBridge 不会正确运行 开发人员调试的时候注意 必须走完整的摇周边流程 通过摇一摇进入页面测试 例子 例子 开 发者调用关注 JS 的 example BeaconAddContactJsBridge ready function 判断是否 关注 BeaconAddContactJsBridge invoke checkAddContactStatus function apiResult if apiResult err code 0 var status apiResult data if status 1 alert 已关注 else alert 未关注 跳转到关注页 BeaconAddContactJsBridge invoke jumpAddContact else alert apiResult err msg 引入引入 BeaconAddContactJsBridgeBeaconAddContactJsBridge 南京多啦客网络传媒有限公司 近场营销解决方案 APIAPI 详细说明详细说明 一 判断是否关注 checkAddContactStatus a 参数 无 传入 b 回调函数 function apiResult apiResult err code 错误码 0 代表正常返会 其他代表发生错误 apiResult err msg 错误详情 ok 代表正常返回 其他代表具体的错误信息 apiResult data 是否关注 1 代表已经关注 0 代表未关注 例子 例子 BeaconAddContactJsBridge invoke checkAddContactStatus function apiResult if apiResult err code 0 var status apiResult data if status 1 alert 已关注 else alert 未关注 else alert apiResult err msg 二 跳转到关注页 jumpAddContact a 参数 无 JS API 通过查询后台获取设备所归属的公众账号 而不是直接在 JS API 参数中获取 因此只能关注此设备归属的公众账号 b 回调函数 无 例子 例子 BeaconAddContactJsBridge invoke jumpAddContact 卡券接口概述卡券接口概述 微信公众平台本次增加了微信卡券功能 开放接口供商家使用 支持开发者调用接口 创建多种类型的卡券 通过下发消息 二维码 JS SDK 等方式进行投放 在用户使用 时通过 API 接口或卡券商户助手完成核销 同时支持接口获取统计数据 以及各个环 节给予开发者事件推送 接口调用流程图如下 南京多啦客网络传媒有限公司 近场营销解决方案 卡券 HelloWorld 开发者须知 开发者可以通过 debug 工具 快速完成创建卡券 投放卡券和核销卡券的流程 若要 深入了解卡券接口 则需要对对应的部分的文档详细阅读 获取获取 access tokenaccess token debugdebug 页面获取页面获取 页面地址 接口类型 基础支持 接口列表 获取 access token 接口 注意事项 参数填写开发者的 appid 和 secret 点击检查问题 即可返回 access token access token 的有效期是两小时 两小时之 后须重新获取 南京多啦客网络传媒有限公司 近场营销解决方案 接口地址 获取 Access token 接口 上传卡卷上传卡卷 logologo debugdebug 页面获取页面获取 页面地址 接口类型 基础支持 接口列表 上传 logo 接口 access token 上一步获得的 access token buffer 你选择的图片 点击检查问题 即可获取图片 url 在下一步创建卡劵的参数中需要 接口地址 上传 Logo 接口 创建卡卷创建卡卷 debugdebug 页面创建页面创建 页面地址 接口类型 卡劵接口 南京多啦客网络传媒有限公司 近场营销解决方案 接口列表 创建卡劵接口 access token 第一步获得的 access token json 示例 card card type GROUPON groupon base info logo url cFNjakmx ibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g 0 brand name 海底 捞 code type CODE TYPE TEXT title 132 元双人火锅套 餐 sub title 周末狂欢必备 color Color010 notice 使用时向服务员出示此券 service phone 020 88888888 description 不可与其他优惠同享 n 如需团购券发票 请在消费时向商户提出 n 店内均可使 用 仅限堂食 date info type DATE TYPE FIX TERM fixed term 15 fixed begin term 0 sku quantity 500000 get limit 3 use custom code false bind openid false can share true can give friend true location id list 123 12321 345345 custom url name 立即使用 custom url custom url sub title 6 个汉字 tips promotion url name 更多优 惠 promotion url source 大众点评 deal detail 以下锅底 2 选 1 有菌王锅 麻辣锅 大骨锅 番茄锅 清补凉锅 酸 菜鱼锅可选 n 大锅 1 份 12 元 n 小锅 2 份 16 元 注意事项 date info 中用的是 Unix 时间戳 注意把 begin timestamp 修改小于当前 时间 end timestamp 修改成今天之后的时间 这样在后面核销卡劵测试才能成功 接口地址 创建卡券接口 创建二维码投放创建二维码投放 debugdebug 页面获取页面获取 页面地址 接口类型 卡劵接口 接口列表 创建二维码 ticket 接口 access token 第一步获得的 access token json 示例 南京多啦客网络传媒有限公司 近场营销解决方案 action name QR CARD action info card card id po 2DjgJ2zrboM6SzK3qNuje5iWQ 接口地址 创建二维码接口 显示二维码显示二维码 在上一步的返回中点击字段 show qrcode url 字段中的链接 即可显示卡券领取二维码 示例 bin showqrcode ticket gQEr8ToAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xLy1YV2 1CQi1sc3dUS0p1M3NjRjVuAAIE3kqwVQMEgDPhAQ 打开微信扫一扫 然后领取卡劵 如果显示卡劵未通过审核 那么需要下一步设置测试 白名单 如果可以领取就忽略第六步 设置测试白名单设置测试白名单 debugdebug 页面获取页面获取 页面地址 接口类型 卡劵接口 接口列表 设置测试白名单接口 access token 第一步获得的 access token json 示例 username usr1 usr2 注意事项 其中 usr1 sur2 是领取卡劵的微信号 接口地址 设置白名单接口 核销卡劵核销卡劵 debugdebug 页面获取页面获取 页面地址 南京多啦客网络传媒有限公司 近场营销解决方案 接口类型 卡劵接口 接口列表 核销卡劵接口 access token 第一步获得的 access token json 示例 code 759733467744 注意事项 仅支持审核通过且在有效期内的卡劵 接口地址 核销接口 开发者注意事项开发者注意事项 微信版本判断微信版本判断 由于微信 6 0 2 版本后才支持卡券功能模块 低版本用户调用 JS SDK 无效 因此 微 信团队建议商户通过 user agent 来确定用户当前的版本号后再调用添加至卡包 JS SDK 接口 以 iPhone 版本为例 可以通过 user agent 可获取如下版本示例信息 Mozilla 5 0 iphone CPU iphone OS 5 1 1 like Mac OS X AppleWebKit 534 46 KHTML like Geocko Mobile 9B206 MicroMessenger 6 0 2 其中 6 0 2 为用户安装的微信版本号 商户可以判定版本号是否高于或者等于 6 0 2 卡券投放限制卡券投放限制 公众号会话环境内仅支持调起该公众号域名下的卡券 未经平台允许不支持在公众号会 话内推送其他商户的卡券 公众号会话外 如朋友圈 对话环境 无此限制 特别注意事项特别注意事项 公众号的对话框中发生的行为以及从公众号对话框跳转的网页链接均处于该公众号的会 话环境内 编码规则编码规则 所有 API 接口 POST 的数据只支持 utf8 编码 否则会返回报错 联系我们联系我们 南京多啦客网络传媒有限公司 近场营销解决方案 遇到卡券开发问题 可以通过邮箱 weixin card 联系我们 也可以加入 开发者 QQ 交流群 198219212 验证请务必说明商家名及业务 卡券术语介绍卡券术语介绍 以下是卡券开发过程中需要了解的关键概念 参数名参数名描述描述 cardid 卡券 ID 一个卡券 ID 对应一类 卡券 包含了相应库存数量的 Code 码 code 卡券 Code 码 一张卡券的唯一标 识 核销卡券时使用此串码 支 持商户自定义 openid 用户在该公众号下的唯一身份 access token 调用接口的凭证 有效时间为 7200s 通过获取 access token 接口获取 api ticket 调用微信卡券接口时签名的临时 票据 通过获取 api ticket 接口 获取 card ext 可扩张卡券的附加信息 outer id 领券渠道的场景值 支持商户自 定义场景值填入 card ext