目的:公司的支付寶小程序向指定用戶發送紅包。javascript
場景:積分兌換、邀請註冊。 html
說明:進入支付寶商家中心 → 營銷工具 → 營銷活動送紅包java
備註:祕鑰選擇PKCS8。web
入口:https://b.alipay.com/signing/productSetV2.htm算法
說明:申請經過後,進入app管理界面可找到經過後的應用。小程序
入口:https://openhome.alipay.com/platform/appManage.htm#/appsapi
說明:點擊應用列表的[查看詳情]。進入應用信息,設置加密方式。app
備註:在這裏咱們將使用簽名算法類型爲'RSA2' 和 'PKCS8' 。(根據自身的SDK進行設置)。async
文檔: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工具
建立並配置好應用後,就能夠進行開發了,支付寶紅包發送到用戶手上只須要兩步:
①建立現金(紅包)活動:好比建立100個1元紅包的活動。
②發送紅包給用戶:根據活動id、用戶openId,將紅包發送給用戶。
說明:要想把紅包發給用戶,首先得建立一個現金(紅包活動)。
文檔: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; } }
說明:建立完紅包活動後,就能夠把紅包發送給用戶。
文檔: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; } }