> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 免費旋轉活動

> 以 Free Spin 作為推廣活動獎勵的規則與使用流程。

本功能用於推廣活動，可將 Free Spin 贈與玩家作為獎勵。

> [!NOTE]
>
> 僅支援**老虎機遊戲**。開放免費旋轉的遊戲清單請洽我方 AM 團隊。

## 活動規則

* 可設定每一轉的 **Bet** 與**免費旋轉次數**。
* 免費旋轉次數在會員進入遊戲時綁定。會員中途可離開遊戲進行一般下注，未用完的次數會保留至活動時間結束。
* 若提前離開遊戲，未用完的次數會保留，下次進入遊戲時會有圖示提醒會員。
* 免費旋轉過程中，仍可**正常觸發免費遊戲與特色遊戲**。
* 免費旋轉活動獎勵會**直接派彩到會員錢包**。
* 活動開始時間到結束時間須**小於或等於 31 天**。

### 提領上下限

可設定**最低與最高提領金額**作為玩家提領的上下限。以最低 1、最高 100 為例：

| 會員 | 10 轉總派彩 | 實際提領 | 原因 |
| - | - | - | - |
| 會員 A | 0.5 | 0 | 派彩低於最低提領金額 1 |
| 會員 B | 180 | 100 | 派彩超過最高提領金額 100 |

## 流程圖

```mermaid theme={null}
flowchart TD
    A["建立免費場次<br/>POST /freespin/create"] --> B["取得 eventID"]
    B --> C{"joinOptions"}
    C -->|auto| D["渠道內會員進入活動遊戲時<br/>自動取得派發卡，直到額滿"]
    C -->|add| E["派發免費轉活動<br/>POST /freespin/bind"]
    E --> F["指定會員取得派發卡 grantID"]
    D --> G["會員進入遊戲，綁定免費旋轉次數"]
    F --> G
    G --> H{"settlePerSpin"}
    H -->|true| I["每轉皆派彩<br/>triggerType = PER_SPIN"]
    H -->|false| J["次數用完後一次結算<br/>triggerType = FINAL_SETTLE"]
    G -.->|到期仍未用完| K["到期結算<br/>triggerType = EXPIRE_SETTLE"]
    I --> L["套用最低／最高提領金額"]
    J --> L
    K --> L
    L --> M["派彩直接入會員錢包"]
    M --> N["對帳：提領紀錄 / 活動紀錄 / 報表"]
    F -.->|需要時| O["凍結派發卡<br/>POST /freespin/freeze"]
    B -.->|需要時| P["取消整個場次<br/>POST /freespin/cancel"]
```

## 使用流程

1. **建立活動**：呼叫[建立免費場次](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/create.md)取得 `eventID`。`joinOptions` 決定會員如何加入：`auto` 讓渠道內所有會員都能參加直到額滿；`add` 需由你指定會員。
2. **派發給指定會員（joinOptions 含 add）**：呼叫[派發免費轉活動](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/bind.md)，整批派發派發卡給會員。
3. **管理派發卡**：以[取得免費旋轉派發卡列表](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/grant.md)查詢狀態，必要時以[凍結免費轉活動](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/freeze.md)凍結，或以[取消免費場次](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/cancel.md)取消整個活動。
4. **對帳**：以[取得玩家提領紀錄](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/withdraw.md)、[取得活動紀錄列表](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/list-by-time.md)與[取得免費旋轉報表](https://doc.va777.net/zh-Hant/v2/api-reference/freespin/report.md)查詢派彩與下注紀錄。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.