红包

商户想给用户发送微信红包福利时,可以看这里的流程:

red_envelope_paymentflow

Ping++ 红包 Redenvelope 功能 只需要服务端 SDK,目前仅支持微信红包。

  1. 服务端调用 Server-SDK 封装的发送红包的方法请求 Ping++ 。
  2. Ping++ 响应你的服务端请求,返回红包 Redenvelope 对象,此时订单状态为 pending,此时仅代表发送红包请求成功,不代表红包成功发送与拆开;使用 Ping++ 测试模式发起的红包请求,必须主动调用红包查询接口查询订单状态才能触发 Webhooks 回调。
  3. 在 Ping++ 管理平台配置 Webhooks 的 red_envelope.sentred_envelope.received 事件。红包发送成功时,Ping++ 会主动以 POST 方式向你配置在管理平台上的 Webhooks 通知地址发送红包发送和接收结果。
  4. 同时,建议在处理逻辑中添加主动查询机制:如果在可接受的时间范围内没有收到 Webhooks 通知,你也可以调用 Server-SDK 封装的查询方法,主动向 Ping++ 发起请求来获得订单状态,该查询结果可以作为交易结果。

注意事项

  1. 发送频率规则
    • 每分钟发送红包数量不能超过 1800 个;
  2. 红包规则
    • 单个红包金额介于人民币 1 元 ~ 200 元之间(小于 1 元或大于 200 元时请传入 scene_id 参数);
    • 同一个红包只能发送给一个用户;
    • 红包发放后 24 小时未被领取,将退回商户账户。
  3. 确保可用余额充足
    • 发放现金红包将扣除商户的可用余额,可用余额并不是微信支付交易额,需要预先充值,确保可用余额充足。
    • 查看可用余额、充值、提现请登录 微信支付商户平台 ,进入资金管理菜单,进行操作,如下图所示:

funds_management

  1. 特别提醒
    • 微信官方和 Ping++ 目前均仅支持 wx_pub 渠道的红包,即微信 JSAPI 的红包。