1. 介绍

目的：公司的支付宝小程序向指定用户发送红包。

场景：积分兑换、邀请注册。

2.开通权限

2.1开通服务

说明：进入支付宝商家中心 → 营销工具 → 营销活动送红包

备注：秘钥选择PKCS8。

入口：https://b.alipay.com/signing/productSetV2.htm

2.2查看应用

说明：申请通过后，进入app管理界面可找到通过后的应用。

入口：https://openhome.alipay.com/platform/appManage.htm

2.3设置秘钥

说明：点击应用列表的[查看详情]。进入应用信息，设置加密方式。

备注：在这里我们将使用签名算法类型为'RSA2' 和 'PKCS8' 。(根据自身的SDK进行设置)。

文档：https://opendocs.alipay.com/open/200/105310

3.开发操作

创建并配置好应用后，就可以进行开发了，支付宝红包发送到用户手上只需要两步：

①创建现金(红包)活动：比如创建100个1元红包的活动。

②发送红包给用户：根据活动id、用户openId，将红包发送给用户。

3.1创建现金活动

说明：要想把红包发给用户，首先得创建一个现金(红包活动)。

文档：https://opendocs.alipay.com/apis/api_5/alipay.marketing.campaign.cash.create

示例：在这里创建了每个2元金额的红包活动，共20元、10个包。

/**
 * 创建现金红包
 * @param {AlipayCashHBEntity} en 实体对象
 * @see https://docs.open.alipay.com/api_5/alipay.marketing.campaign.cash.create
 */
async createCashHB(en) {
  let alipaySdk = this._getAlipaySdk();
  try {
    const rs = await alipaySdk.exec('alipay.marketing.campaign.cash.create', {
      bizContent: {
        couponName: en.couponName,
        prizeType: en.prizeType,
        totalMoney: en.totalMoney,
        totalNum: en.totalNum,
        prizeMsg: en.couponName,
        startTime: en.startTime,
        endTime: en.endTime,
        merchantLink: en.merchantLink,
        sendFreqency: `L${en.sendFreqency}`
      }
    });
    if (rs.code != '10000') {
      throw new Error(rs.subMsg);
    } else {
      return rs;
    }
  } catch (err) {
    throw err;
  }
}

3.2发送红包给用户

说明：创建完红包活动后，就可以把红包发送给用户。

文档：https://opendocs.alipay.com/apis/api_5/alipay.marketing.campaign.cash.trigger

注意：发送的红包金额会转入用户的【余额】里。

/**
 * 发送现金红包
 * @param {String} crowdNo 红包编号
 * @param {String} alipayUserOpenId 支付宝用户openId
 * @param {String} productExchangeId 兑换记录Id
 * @see https://docs.open.alipay.com/api_5/alipay.marketing.campaign.cash.trigger
 */
async sendCashHB(crowdNo, alipayUserOpenId, productExchangeId) {
  let alipaySdk = this._getAlipaySdk();
  try {
    const rs = await alipaySdk.exec('alipay.marketing.campaign.cash.trigger', {
      bizContent: {
        user_id: alipayUserOpenId,
        crowd_no: crowdNo,
        out_biz_no: productExchangeId
      }
    });
    if (rs.code != '10000') {
      throw new Error(rs.subMsg);
    } else {
      return rs;
    }
  } catch (err) {
    throw err;
  }
}