介绍支付宝小程序如何向指定用户发送红包。场景如：积分兑换、邀请注册。
1. 介绍
目的：公司的支付宝小程序向指定用户发送红包。
场景：积分兑换、邀请注册。
2. 开通权限
2.1 开通服务
说明：进入支付宝商家中心 → 营销工具 → 营销活动送红包
备注：秘钥选择PKCS8。
入口：https://b.alipay.com/signing/productSetV2.htm
2.2 查看应用
说明：申请通过后，进入app管理界面可找到通过后的应用。
入口：https://openhome.alipay.com/platform/appManage.htm#/apps
2.3 设置秘钥
说明：点击应用列表的[查看详情]。进入应用信息，设置加密方式。
备注：在这里我们将使用签名算法类型为'RSA2' 和 'PKCS8' 。(根据自身的SDK进行设置)。
文档：https://opendocs.alipay.com/open/200/105310#%E9%85%8D%E7%BD%AE%E5%BA%94%E7%94%A8%E7%8E%AF%E5%A2%83
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;
}
}
