介紹

本文件旨在提供遊戲 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 確認以下實作細節：

在進入測試環境前，請確認已完成：