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;
    }
}

  

posted on 2020-11-19 10:13  FangMu  阅读(460)  评论(0编辑  收藏  举报