风凌天下,完结小说,小说排行榜完结版

云業(yè)務(wù)管理系統(tǒng)（國(guó)內(nèi)版）

如何開(kāi)發(fā)用戶領(lǐng)取代金券功能說(shuō)明

最后更新時(shí)間：2023-01-17 14:13:31

#### 說(shuō)明

1. 該功能用于客戶自行領(lǐng)取代金券
2. 該功能僅提供調(diào)用方法，需合作商自行編寫前后端相關(guān)代碼（如前端領(lǐng)取按鈕，后端調(diào)用控制器等）
3. 領(lǐng)取代金券與后臺(tái)代金券贈(zèng)送設(shè)置關(guān)聯(lián)，請(qǐng)先添加新的贈(zèng)送設(shè)置

#### 添加代金券組

位置：【財(cái)務(wù)】-【代金券管理】-【組管理】-【添加新分組】

**示例**

分組名稱：領(lǐng)券組

排序數(shù)值：1

狀態(tài)：可用

![](https://upload.apayun.com/2019/07/5d245d95c90a6.png?token=FkUmSsSCVXcUUBXAbeSPhQ&expires=1731674313)

#### 設(shè)置贈(zèng)送場(chǎng)景

位置：【財(cái)務(wù)】-【代金券管理】-【贈(zèng)送場(chǎng)景設(shè)置】-【添加新設(shè)置】

**示例**

設(shè)置場(chǎng)景名稱：領(lǐng)取云服務(wù)器購(gòu)買代金券

設(shè)置每位用戶限領(lǐng)次數(shù)：1

![](https://upload.apayun.com/2019/07/5d245dd3ba553.png?token=ErzK7NyOKYNekxhT_n9prg&expires=1731674313)

贈(zèng)送場(chǎng)景設(shè)置成功后，系統(tǒng)會(huì)自動(dòng)生成一個(gè)code值，該值將用于下面代碼調(diào)用

![](https://upload.apayun.com/2019/07/5d245de5e16f4.png?token=Te2NafTl3udu3TR1AKkvuA&expires=1731674313)

#### 代金券贈(zèng)送設(shè)置

位置：【財(cái)務(wù)】-【代金券管理】-【代金券贈(zèng)送設(shè)置】-【添加新設(shè)置】

如設(shè)置用戶可領(lǐng)取的云服務(wù)器購(gòu)買代金券 2 張

使用條件為：滿 200 減 100

每張券最多可使用1次，可購(gòu)買云服務(wù)器數(shù)量為 1 臺(tái)

有效期：6個(gè)月

![](https://upload.apayun.com/2019/07/5d245e039fb16.png?token=9UE_ObTprxTL_7jsCloU2g&expires=1731674313)

#### 添加相關(guān)代碼

* **后端調(diào)用領(lǐng)取代金券接口**

**調(diào)用方式**
 
 ```
 //$userId 用戶ID
 //$presentCode 贈(zèng)送場(chǎng)景
 //$remarks  用于生成代金券時(shí)記錄備注
 //$sms  發(fā)送消息方式 ：0 不發(fā)送 1 站內(nèi)信，2 站內(nèi)信+短信 ，默認(rèn)為0 不發(fā)送消息，可不傳
 //$code  發(fā)送消息的模板，發(fā)送消息時(shí)才用到 ，可不傳
 $cashCoupon = new CashCoupon();
 $receive = $cashCoupon->cashcouponReceive($userId, $presentCode, $remarks, $sms,$code);
```

**調(diào)用實(shí)例**
 
 此處以新建控制器調(diào)用為例
 
 后端代碼：在 `app/Home/Controller` 文件夾中添加新的控制器 `CashcouponReceiveController.class.php`
 代碼如下：
 ```
 <?php
 namespace Home\Controller;
 use Common\Controller\HomeController;
 use Niaoyun\Common\CashCoupon;

/**
 * 領(lǐng)取代金券控制器
 */
 class CashcouponReceiveController extends HomeController
 {
    public function getCashcoupon()
    {
        if (!IS_POST) {
            //只接受POST請(qǐng)求
            $this->ajaxReturn(['result' => false, 'text' => '無(wú)效請(qǐng)求']);
        }
        $userId = is_front_login(); //判斷是否已登錄
        if (!$userId) {
            $this->ajaxReturn(['result' => false, 'text' => '請(qǐng)先登錄',]);
        }
        //贈(zèng)送場(chǎng)景的code值
        $presentCode = 'lDsmL2RQGREEZ3Jg';
        $remarks = '領(lǐng)取云服務(wù)器購(gòu)買代金券';

$cashCoupon = new CashCoupon();
        $receive = $cashCoupon->cashcouponReceive($userId, $presentCode, $remarks);
        if ($receive['result']) {
            $this->ajaxReturn($receive);
        }
        $this->ajaxReturn($receive);
    }
 }
```
 
 **添加調(diào)用路由**
 
 自定義路由文件：`config/userDefinedRouter.php`
 ```
 <?php 
 return [
    'CashcouponReceive/getCashcoupon' => 'Home/CashcouponReceive/getCashcoupon',
 ];
```

* **前端代碼**
 
 以上方添加的代碼為例，在需要添加領(lǐng)取按鈕的地方使用post請(qǐng)求調(diào)用 `CashcouponReceive/getCashcoupon` 即可

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎開(kāi)放API

文檔首頁(yè)

云業(yè)務(wù)管理系統(tǒng)（國(guó)內(nèi)版）

如何開(kāi)發(fā)用戶領(lǐng)取代金券功能說(shuō)明

18+

1000+

30+

5+