微信摇一摇红包介绍说明

由 如此轻盈 创建，Carrie 最后一次修改 2016-10-08 目录1 摇一摇红包说明2 红包预下单接口3 创建红包活动4 录入红包信息5 设置红包活动抽奖开关6 红包JSAPI7 红包绑定用户事件通知8 红包查询接口 摇一摇红包说明功能说明摇一摇周边红包接口是为线下商户提供的发红包功能。用户可以在商家门店等线下场所通过摇一摇周边领取商家发放的红包，在线上转发分享无效。开发者可通过接口开发摇一摇红包功能，特点包括： 可选择使用模板加载页或自定义Html5页面调起微信原生红包页面(详见创建红包活动中use_template字段，1为使用模板，2为使用自定义Html5页面) 原生红包页面拆红包，无需通过公众号消息下发 提供关注公众号能力，用户可自行选择是否关注(裂变红包分享时无效) 完成页面可配置跳转链接，可跳转商户的其他自定义Html5页面 同一个用户在单个红包活动中只能领取1次红包用户侧交互流程 红包组件接口调用流程 申请红包接口权限：登录摇一摇周边商户后台https://zb.weixin.qq.com ,进入开发者支持，申请开通摇一摇红包组件接口; 红包预下单：调用微信支付的api进行红包预下单，告知需要发放的红包金额，人数，生成红包ticket； 创建活动并录入红包信息：调用摇周边平台的api录入创建红包活动并录入信息，传入预下单时生成的红包ticket； 调用jsapi抽红包：在摇出的页面中通过调用jsapi抽红包，抽中红包的用户可以拆红包； 调用以上接口时，红包提供商户和红包发放商户公众号要求一致。 说明： 红包提供商户：红包预下单接口传入的参数wxappid所代表的商户 红包发放商户：调用红包接口创建红包活动、录入红包信息、发放红包的商户公众号 红包预下单接口接口说明设置单个红包的金额，类型等，生成红包信息。预下单完成后，需要在72小时内调用jsapi完成抽红包的操作。（红包过期失效后，资金会退回到商户财付通帐号。）接口调用说明服务器端调用http请求方式: POSThttps://api.mch.weixin.qq.com/mmpaymkttransfers/hbpreorderPOST数据格式：XML需要商户证书请求参数说明参数字段是否必须示例值类型说明随机字符串nonce_str是5K8264ILTKCH16CQ2502SI8ZNMTM67VSString(32)随机字符串，不长于32位签名sign是C380BEC2BFD727A4B6845133519F3AD6String(32)生成签名方式查看签名算法商户订单号mch_billno是10000098201411111234567890String(28)商户订单号（每个订单号必须唯一）组成： mch_id+yyyymmdd+10位一天内不能重复的数字。接口根据商户订单号支持重入， 如出现超时可再调用。商户号mch_id是10000098String(32)红包提供者的商户号（微信支付分配的商户号）公众账号appidwxappid是wx8888888888888888String(32)红包提供者公众号的appid，对应头像展示在红包页面商户名称send_name是天虹百货String(32)红包提供者名称，展示在红包页面红包类型hb_type是NORMALString(16)NORMAL-普通红包；GROUP-裂变红包(可分享红包给好友，无关注公众号能力)。总金额total_amount是1000int总付款金额，单位分红包发放总人数total_num是1int红包发放总人数，即总共有多少人可以领到该组红包（包括分享者）。普通红包填1，裂变红包必须大于1。红包金额设置方式amt_type是ALL_RANDString(32)红包金额设置方式，只对裂变红包生效。ALL_RAND—全部随机红包祝福语wishing是感谢您参加猜灯谜活动，祝您元宵节快乐String(16)红包祝福语，展示在红包页面活动名称act_name是猜灯谜抢红包活动String(32)活动名称，在不支持原生红包的微信版本中展示在红包消息备注remark是猜越多得越多，快来抢！String(32)备注信息，在不支持原生红包的微信版本中展示在红包消息授权商户号auth_mchid是1000052601String(32)用于发红包时微信支付识别摇周边红包，所有开发者统一填写摇周边平台的商户号：1000052601授权商户APPIDauth_appid是wxbf42bd79c4391863String(32)用于发红包时微信支付识别摇周边红包，所有开发者统一填写摇周边平台的appid:wxbf42bd79c4391863风控设置risk_cntl是NORMALString(32)用于管控接口风险。具体值如下：NORMAL—正常情况；IGN_FREQ_LMT—忽略防刷限制，强制发放；IGN_DAY_LMT—忽略单用户日限额限制，强制发放；IGN_FREQ_DAY_LMT—忽略防刷和单用户日限额限制，强制发放；如无特殊要求，请设为NORMAL。若忽略某项风险控制，可能造成资金损失，请谨慎使用。请求示例<xml> <sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign> <mch_billno><![CDATA[0010010404201411170000046545]]></mch_billno> <mch_id><![CDATA[10000097]]></mch_id> <wxappid><![CDATA[wxcbda96de0b165486]]></wxappid> <send_name><![CDATA[send_name]]></send_name> <hb_type><![CDATA[NORMAL]]></hb_type> <auth_mchid><![CDATA[10000098]]></auth_mchid> <auth_appid><![CDATA[wx7777777]]></auth_appid> <total_amount><![CDATA[200]]></total_amount> <amt_type><![CDATA[ALL_RAND]]></amt_type> <total_num><![CDATA[3]]></total_num> <wishing><![CDATA[恭喜发财 ]]></wishing> <act_name><![CDATA[ 新年红包 ]]></act_name> <remark><![CDATA[新年红包 ]]></remark> <risk_cntl><![CDATA[NORMAL]]></risk_cntl> <nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str></xml> 返回数据说明返回格式为xml参数字段是否必须示例值类型说明返回状态码return_code是SUCCESSString(16)SUCCESS/FAIL；此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断返回信息return_msg否签名失败String(128)返回信息，如非空，为错误原因 签名失败 参数格式校验错误以下字段在return_code为SUCCESS的时候有返回参数字段是否必须示例值类型说明签名sign是C380BEC2BFD727A4B6845133519F3AD6String(32)生成签名方式查看 签名算法业务结果result_code是SUCCESSString(16)SUCCESS/FAIL错误代码err_code否SUCCESSString(32)错误码信息错误代码描述err_code_des否系统错误String(128)结果信息描述以下字段在return_code 和result_code都为SUCCESS的时候有返回参数字段是否必须示例值类型说明商户订单号mch_billno是10000098201411111234567890String(28)商户订单号（每个订单号必须唯一）组成： mch_id+yyyymmdd