插件版本號(hào):1.4.13(更新時(shí)間 2021/06/23)
【推薦】如希望每次默認(rèn)使用最新版本,可在app.json 文件配置"version": "1.4.13";
如需指定版本,可點(diǎn)擊查看更新記錄選擇版本
在小程序配置app.json 文件中加入如下配置:
{
"plugins": {
"sendCoupon": {
"version": "1.4.13",
"provider": "wxf3f436ba9bd4be7b"
}
}
}
1)在小程序頁(yè)面配置文件中加入如下配置,引入send-coupon組件:
{
"usingComponents": {
"send-coupon": "plugin://sendCoupon/send-coupon"
}
}
2)在小程序頁(yè)面的WXML模板中加入如下代碼,并填入相關(guān)字段,字段說(shuō)明參見(jiàn)小程序發(fā)券插件字段說(shuō)明表
//page.wxml
<send-coupon
bind:sendcoupon="getcoupon"
bind:userconfirm="redirectuser"
send_coupon_params="{{send_coupon_params}}"
sign="{{sign}}"
send_coupon_merchant="{{send_coupon_merchant}}"
suggest_immediate_use="{{suggest_immediate_use}}"
>
<!-- 內(nèi)部為自定義代碼,按鈕點(diǎn)擊部分的代碼寫在這里 -->
<!-- [[以下為示例代碼 -->
<view class="text">領(lǐng)券</view>
<!-- 以上為示例代碼 ]] -->
</send-coupon>
javascript
//page.js
Page({
// 此函數(shù)名稱可以自定義,跟bindcustomevent綁定的保持一致
getcoupon: function(params) {
// 插件返回信息在params.detail
console.log('getcoupon', params)
}
})
如果事件綁定正確,在用戶點(diǎn)擊領(lǐng)券后,會(huì)觸發(fā)領(lǐng)券事件,得到返回之后會(huì)調(diào)用getcoupon函數(shù)。
從回調(diào)函數(shù)參數(shù)detail中,獲取參數(shù)。
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
外層錯(cuò)誤碼 | errcode | string[1,32] | 是 | 返回整體錯(cuò)誤碼 |
錯(cuò)誤信息 | msg | string[1,128] | 是 | 返回整體錯(cuò)誤信息 |
+發(fā)券結(jié)果 | send_coupon_result | object | 是 | 發(fā)券結(jié)果,包含需要發(fā)放的每張券的結(jié)果信息,是否成功或失敗原因 |
javascript
//獲取代碼示例
Page({
data: {
// ...
},
onLoad: function() {
// ...
},
getcoupon: function(params) {
console.log('getcoupon', params)
console.log('detail', params.detail)
}
})
Detail中errcode返回錯(cuò)誤碼
錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|
OK | 調(diào)用成功 | 接口調(diào)用成功,具體發(fā)券結(jié)果(是否發(fā)券成功)需查看發(fā)券結(jié)果(send_coupon_result)中的參數(shù) |
PARAM_ERROR | 參數(shù)錯(cuò)誤 | 參數(shù)錯(cuò)誤,請(qǐng)開(kāi)發(fā)者查看msg中具體的錯(cuò)誤信息并進(jìn)行修復(fù)處理 |
USER_NOT_EXISTS | 登錄態(tài)獲取失效 | 引導(dǎo)用戶重試 |
USER_GET_FAILED | 登錄態(tài)獲取失敗 | 報(bào)錯(cuò),提示用戶稍后操作 |
SIGN_ERROR | 簽名錯(cuò)誤 | 請(qǐng)開(kāi)發(fā)者檢查簽名正確性 |
SYSTEMERROR | 發(fā)券超時(shí) | 提示報(bào)錯(cuò),提示用戶稍后操作 |
FREQUENCY_LIMITED | 發(fā)券頻率過(guò)高 | 提示報(bào)錯(cuò),引導(dǎo)用戶稍后操作。例如“活動(dòng)太過(guò)火爆,請(qǐng)稍后再領(lǐng)取” |
發(fā)券結(jié)果(send_coupon_result)中的錯(cuò)誤碼
錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|
SUCCESS | 該張券發(fā)券成功 | 提示用戶領(lǐng)取成功/改變前端領(lǐng)券按鈕狀態(tài) |
FAILED | 該張券發(fā)券失敗,查看message中的具體錯(cuò)誤信息 | 提示用戶領(lǐng)券失敗,請(qǐng)開(kāi)發(fā)者查看message中具體的錯(cuò)誤信息并進(jìn)行修復(fù)處理 |
NOTENOUGH | 總預(yù)算用完 | 提示用戶領(lǐng)券失敗,請(qǐng)?jiān)黾优晤A(yù)算 |
DAYLIMIT | 用戶達(dá)到單天限領(lǐng) | 提示用戶領(lǐng)券失敗,如需繼續(xù)發(fā)放,可調(diào)整該批次單天發(fā)放上限 |
NATURELIMIT | 用戶自然人限領(lǐng) | 提示用戶領(lǐng)券失敗,可提示用戶檢查其所有微信號(hào)領(lǐng)券情況,并請(qǐng)商戶留意刷單風(fēng)險(xiǎn) |
MAXQUOTA | 用戶領(lǐng)取張數(shù)達(dá)到上限 | 提示用戶領(lǐng)券失敗,該用戶領(lǐng)取數(shù)量已達(dá)上限 |
DUPREQUEST | 已通過(guò)該發(fā)券憑證給用戶發(fā)券 | 提示用戶領(lǐng)取成功/改變前端領(lǐng)券按鈕狀態(tài) |
NOTRUNNING | 批次狀態(tài)非運(yùn)營(yíng)中 | 提示用戶領(lǐng)券失敗,并檢查批次狀態(tài)
|
EXPIRED | 該批次已過(guò)期 | 請(qǐng)更換在有效期內(nèi)的批次,再進(jìn)行發(fā)放 |
NOTMONEY | 賬戶余額不足 | 請(qǐng)聯(lián)系制券商戶進(jìn)行充值 |
USERLIMIT | 用戶已超限領(lǐng)額度 | 提示用戶已超限領(lǐng)額度 |
FREQUENCYLIMIT | 超過(guò)頻率限制 | 可稍后重試 |