介紹
本文件旨在提供遊戲 API 服務的整合指引，協助 平台業者 與 遊戲內容 之間建立穩定且順暢的串接機制。
術語對照表
為確保協作過程中對技術術語理解一致並避免歧義，本文件針對核心術語進行統一界定。後續章節提及定義範圍內之術語時，均將以 斜體字（italics-style） 標註，以供辨識。
身份相關
| 名詞 | 說明 |
|---|---|
| Licensee | 或稱 Operator 負責 Player 帳戶管理、資金保管及最終帳務結算。在 One Wallet 架構下，由其系統主導 Player 錢包的即時扣款與入帳，並須確保 API 響應的高可用性。 |
| Player | 指在 Licensee 系統中註冊並擁有唯一身分識別（Player ID）的終端用戶。 在系統架構中，Player 是所有交易與遊戲行為的主體，其法律合規檢查（如年齡驗證、區域限制）、帳戶權限及最終資金餘額均由 Licenser 負責管理與維護。 |
| Game Provider | 負責開發、營運遊戲產品並維護遊戲邏輯。 透過 API 與 Licensee 平台對接，發送交易請求（如：下注、派彩、取消），在非轉帳模式下不直接管理 Player 資金。 |
錢包相關
| 名詞 | 說明 |
|---|---|
| Seamless Wallet | Single Wallet Player 僅持有 Licensee 管理的唯一餘額，所有遊戲行為均即時透過 API 存取主錢包。此模式不需手動轉帳即可開始遊戲。 |
| Transfer Wallet | 或稱Multi Wallet Game Provider 會在自家系統內為 Player 建立獨立的「子錢包」。 Player 須手動或透過介面將資金由主帳戶劃轉至子錢包後方可遊戲，遊戲端的交易與結算僅在該子錢包內運作。 |
| Withdrawal | Player 將資金 Game Provider 錢包轉入 Licensee 的操作。 |
| Deposit | Player 將資金 Licensee 錢包轉入 Game Provider 的操作。 |
遊戲相關
| 名詞 | 說明 |
|---|---|
| Main Bet | 指遊戲核心邏輯中的基本投注項。例如在「百家樂」中指莊、閒、和；在「老虎機」中則指每一轉的基礎投注。 |
| Side Bet | 附加在主遊戲之外的投注選項，通常賠率較高。例如百家樂中的「對子」、「大/小」或「完美對子」。 |
| Demo Mode | 允許 Player 使用虛擬資金進行遊戲體驗的模式。在此模式下，系統不會向 Licensee 發起實際的資金扣款請求。 |
| Jackpot | 指從 Player 投注中提取一定比例累積而成的巨額獎金。分為固定彩金與累積式彩金，由 Game Provider 運算並觸發。 |
| Session | 指 Player 從進入遊戲到離開遊戲的有效期間。每個 Session 通常會對應一個唯一的 ID，用於追蹤該期間內的所有 Transaction 及遊戲行為，並作為安全驗證的基礎。 |
| Transaction | 指每一次資金變動的最小單位。包含 Debit（扣款）、Credit（派彩）及 Cancel（撤銷交易）等操作。 |
| Payout | 指 Game Provider 在遊戲結果成立後，將應得點數回補至 Licensee 主錢包 的請求。 此行為代表「玩家贏得的遊戲結果」，包含一般派彩、倍數獎勵、回收未用完的押注等。 |
| Promo Payout | 基於 Licensee 或 Game Provider 的行銷活動、促銷規則、優惠機制所產生的額外點數回補。它不代表遊戲勝負結果，而是獨立於下注邏輯之外的「額外加值點數」，與一般的 Payout 分開統計 |
快速開始
請您優先閱讀並確認 S2S 認證 的流程說明，並與 Game Provider 確認以下實作細節：
- 使用 One Wallet 或 Multi Wallet 架構
- 認證方式（JWT / 簽章演算法 / 金鑰交換）
- 幣別與點數精度設定
- 語系與遊戲模式支援範圍
整合前準備
在進入測試環境前，請確認已完成：
- API Endpoint 設定
- IP 白名單開通
- 公私鑰交換或 Client Secret 配置
上線前檢查清單
- 玩家登入與啟動流程驗證完成
- 錢包扣款與結算測試通過
- 錯誤碼對照表確認
- 安全與限流機制驗證