> ## 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 |

## 使用流程

**1. 建立活動**

呼叫[建立免費場次](https://doc.va777.net/api-reference/freespin/create.md)取得 `eventID`。`joinOptions` 決定會員如何加入：`auto` 讓渠道內所有會員都能參加直到額滿；`add` 需由你指定會員。

**2. 派發給指定會員（joinOptions 含 add）**

呼叫[派發免費轉活動](https://doc.va777.net/api-reference/freespin/bind.md)，整批派發派發卡給會員。

**3. 管理派發卡**

以[取得免費旋轉派發卡列表](https://doc.va777.net/api-reference/freespin/grant.md)查詢狀態，必要時以[凍結免費轉活動](https://doc.va777.net/api-reference/freespin/freeze.md)凍結，或以[取消免費場次](https://doc.va777.net/api-reference/freespin/cancel.md)取消整個活動。

**4. 對帳**

以[取得玩家提領紀錄](https://doc.va777.net/api-reference/freespin/withdraw.md)、[取得活動紀錄列表](https://doc.va777.net/api-reference/freespin/list-by-time.md)與[取得免費旋轉報表](https://doc.va777.net/api-reference/freespin/report.md)查詢派彩與下注紀錄。


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