摇一摇红包介绍说明.pdfVIP

摇⼀摇红包介绍说明 ⽬录 1 摇⼀摇红包说明 2 红包预下单接⼜ 3 创建红包活动 4 录⼊红包信息 5 设置红包活动抽奖开关 6 红包JSAPI 7 红包绑定⽤户事件 知 8 红包查询接⼜ 摇⼀摇红包说明 功能说明 摇⼀摇周边红包接⼜是为线下商户提供的发红包功能。⽤户可以在商家门店等线下场 所 过摇⼀摇周边领取商家发放的红包，在线上转发分享⽆效。 开发者可 过接⼜开发摇⼀摇红包功能，特点包括： 1. 可选择使⽤模板加载页或⾃定义Html5页⾯调起微信原⽣红包页⾯(详见创建红 包活动中use_template字段，1为使⽤模板，2为使⽤⾃定义Html5页⾯) 2. 原⽣红包页⾯拆红包，⽆需 过公众号消息下发 3. 提供关注公众号能⼒，⽤户可⾃⾏选择是否关注(裂变红包分享时⽆效) 4 . 完成页⾯可配置跳转链接，可跳转商户的其他⾃定义Html5页⾯ 5. 同⼀个⽤户在单个红包活动中只能领取1次红包 ⽤户侧交互流程 红包组件接⼜调⽤流程 1. 申请红包接⼜权限：登录摇⼀摇周边商户后台https://z .weixin .qq .com ,进⼊开发 者⽀持，申请开 摇⼀摇红包组件接⼜; 2. 红包预下单：调⽤微信⽀付的api进⾏红包预下单，告知需要发放的红包⾦额， ⼈数，⽣成红包ticket ； 3. 创建活动并录⼊红包信息：调⽤摇周边平台的api录⼊创建红包活动并录⼊信 息，传⼊预下单时⽣成的红包ticket ； 4 . 调⽤j sapi抽红包：在摇出的页⾯中 过调⽤j sapi抽红包，抽中红包的⽤户可以 拆红包； 5. 调⽤以上接⼜时，红包提供商户和红包发放商户公众号要求⼀致。 说明： 红包提供商户：红包预下单接⼝传⼊的参数wxappid所代表的商户 红包发放商户：调⽤红包接⼝创建红包活动、 ⼊红包信息、发放红包的商户公众号 红包预下单接⼜ 接⼜说明 设置单个红包的⾦额，类型等，⽣成红包信息。预下单完成后，需要在72⼩时内调⽤ j sapi完成抽红包的操作。 （红包过期失效后，资⾦会退回到商户财付 帐号。） 接⼜调⽤说明 服务器端调⽤ http请求⽅式: POST /mmpaymkttransfers/hbpreorder POST数据格式：XML 需要商户证书 请求参数说明 是 否 参数 段 ⽰例值 类型 必 须 5K8264ILTKCH 16CQ2502SI8Z 随机字 符串 nonce_str 是 NMTM67VS String(32) 随机字符串， C380BEC2BFD727A4B6845 1335 ⽣成签名⽅式 签名 sign 是 19F3AD6 String(32) 法 商户订单号 （ 必须唯⼀）组 商户订 mch_id+yyyy 单号 mch_ illno 是 1000009820 14 11111234567890 String(28)