- ·上一篇文章:微信平台会员卡专区(二)
- ·下一篇文章:微信特殊票券
微信优惠券 朋友的券专区
ACK 已回退,系统失败 ORDER_STATUS_HAS_RECEIPT 已开发票sort_info否JSON结构 对结果排序sort_key否stringSORT_BY_TIME排序依据,SORT_BY_TIME 以订单时间排序sort_type否stringSORT_DESC排序规则,SORT_ASC 升序SORT_DESC 降序返回数据示例{ "errcode": 0, "errmsg": "ok", "total_num": 1, "order_list": [ { "order_id": "100005790120151221401000171", "status": "ORDER_STATUS_FINANCE_SUCC", "create_time": 1450712798, "pay_finish_time": 1450712905, "desc": "微信支付充值", "free_coin_count": "0", "pay_coin_count": "1", "refund_free_coin_count": "0", "refund_pay_coin_count": "0", "openid": "oWE-GwF1gGoyVVZC5PG6GXd4cKMY", "order_type": "ORDER_TYPE_WXPAY" } ]}返回数据说明参数名描述errcode错误码errmsg错误信息total_num符合条件的订单总数量order_list显示的订单详情列表,根据offset和count来显示order_id订单号status订单状态,ORDER_STATUS_WAITING 等待支付 ORDER_STATUS_SUCC 支付成功 ORDER_STATUS_FINANCE_SUCC 加代币成功 ORDER_STATUS_QUANTITY_SUCC 加库存成功 ORDER_STATUS_HAS_REFUND 已退币 ORDER_STATUS_REFUND_WAITING 等待退币确认 ORDER_STATUS_ROLLBACK 已回退,系统失败 ORDER_STATUS_HAS_RECEIPT 已开发票create_time订单创建时间pay_finish_time支付完成时间desc支付描述,一般为微信支付充值free_coin_count本次充值的付费券点数量,以元为单位pay_coin_count二维码的数据流,开发者可以使用写入一个文件的方法显示该二维码refund_free_coin_count回退的免费券点refund_pay_coin_count回退的付费券点openid支付人的openidorder_tpye订单类型,ORDER_TYPE_WXPAY为充值券点流水详情事件推送当券点发生变动时,微信服务器会将本次变动的类型、券点数额以及时间等信息推送给开发者服务器。朋友的券投放接口说明该部分主要讲述微信卡券不同的投放渠道和投放方式,建议开发者仔细阅读本部分文档,避免在投放过程中出现消费者无法共享的情况。开发者注意事项共享券投放与普通券投放略有不同。现共享券仅支持线下二维码扫码投放(不包含长按二维码识别)、摇一摇Beacon投放的H5以及WIFI环境H5投放场景,共享券同时支持扫码跳转H5后领券,其他投放渠道暂不支持。案例介绍卡券二维码投放场景介绍二维码一般用于商户卡券的店内投放、海报投放和传单投放,商户通过接口生成二维码之后,可以将二维码贴在收银台、海报、传单等宣传物料上。用户扫码后可以将卡券共享至共享券列表,供自己和朋友们使用。使用流程完成以上流程,开发者需要:1.创建朋友的券并再通过审核之后在【微信公众平台商户后台】增加库存;2.调用创建二维码接口生成领券二维码;3.监听领取时间推送,记录卡券发放量并做数据统计;API列表步骤API名称用途API属性1生成二维码接口 创建二维码得到二维码的展示url投放接口2卡券领取事件推送 用户领取卡券后,获得用户的openid、code和card_id等信息事件推送H5网页投放场景介绍开发者可以开发领券H5网页,并将url转化成二维码或者配置在微信摇一摇或者微信Wi-Fi投放。 该渠道适用于对领取页面有要求的商户,可以自定义页面样式体现品牌价值或者自定义领取流程(如加入游戏环节)等。注意:1.目前仅支持线下场景投放,如卡券二维码、从扫码进入H5网页扫码或者从Wi-Fi或者iBeacon进入的网页领券。其他渠道暂不支持。2.点击此处了解Wi-Fi和微信摇一摇摇一摇周边(iBeacon)接口调用流程API列表步骤API名称用途API属性1获取JSAPI_TICKET接口 获取到JSAPI_TICKET用于参与JS SDK config基础接口2获取卡券API_TICKET接口 获取到卡券API_TICKET用于cardext内signarue签名投放接口3批量添加卡券接口 将共享券添加到用户的券列表投放接口4卡券领取事件推送 用户领取卡券后,获得用户的openid、code和card_id等信息事件推送API详情设置测试白名单接口当朋友的券审核未通过时,开发者可以通过设置白名单的方式领取朋友的券并共享。 共享的未审核状态的券仅白名单列表内可见。生成二维码接口接口调用请求说明http请求方式: POST https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN参数说明参数是否必须说明POST数据是JSON数据access_token是调用接口凭证POST数据开发者可以设置扫描二维码领取单张卡券,此时POST数据为:{ "action_name": "QR_CARD", "expire_seconds": 1800, "action_info": { "card": { "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", "code": "198374613512", "openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA", "is_unique_code": false, "outer_id": 1 } }}参数名必填类型示例值描述code是string(20)110201201245卡券Code码,use_custom_code字段为true的卡券必须填写,非自定义code不必填写。。card_id否string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc卡券ID。openid否string(32)oXch-jkrxp42VQu8ldweCwDt97qo指定领取者的openid,只有该用户能领取。bind_openid字段为true的卡券必须填写,非指定openid不必填写。expire_seconds否unsigned int60指定二维码的有效时间,范围是60 ~ 1800秒。不填默认为永久有效。is_unique_code否boolfalse指定下发二维码,生成的二维码随机分配一个code,领取后不可再次扫描。填写true或false。默认false。outer_id否int12领取场景值,用于领取渠道的数据统计,默认值为0,字段类型为整型,长度限制为60位数字。用户领取卡券后触发的事件推送中会带上此自定义场景值。注意事项:1.若开发者填写了is_unique_code为true,需要保证卡券已审核通过并有库存,否则会报错。返回数据数据示例:{ "errcode": 0, "errmsg": "ok", "ticket": "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==", "expire_seconds": 1800, "url": "http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o", "show_qrcode_url": " https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"}参数名描述errcode错误码errmsg错误信息ticket获取的二维码ticket,凭借此ticket调用通过ticket换取二维码接口可以在有效
微信优惠券 朋友的券专区