TaDa 遊戲平台整合上線指南

Agent 規劃與評估
開始整合前，營運商需要評估自身有多少個平台將會串接 TaDa 遊戲。建議為每個平台申請獨立的 Agent，這樣可以獨立追蹤各平台的營收數據，分析不同平台的玩家行為差異，並便於進行精準的數據分析和營運決策。

取得必要資訊

• TaDa 客服引導建立代理
• 取得 AgentId 和 AgentKey（參考文件 0. 設定與注意事項）
• 取得 API 端點（測試環境和正式環境）

• 文件參考：1.1.2 Key 產生方式
• 重要注意事項：
  • 時間必須使用 UTC-4 時區，且不可受日光節約時間影響而自動調整
• 多語言範例程式碼：
  • 提供 Go、Python、C# 範例程式碼
  • 範例程式碼下載連結已提供於文件中（1.1.3 Key 產生範例）

玩家驗證 API（/auth）

• 說明：驗證玩家身份及餘額
• 文件參考：4.2.2 驗證帳號
• 技術要點：
  • 支援貨幣種類：
    • SC
    • GC
  • 貨幣顯示客製化：
    • 可自訂遊戲畫面中的貨幣顯示名稱
    • 例如：實際使用 SC 幣別，但遊戲畫面顯示為 "SSC"
    • 如需設定客製化顯示，請聯繫 TaDa 技術人員協助配置

下注 API（/bet）

• 說明：處理玩家下注交易
• 文件參考：4.2.3 玩家注單 (下注與結算同時發送)

取消注單 API（/cancelBet）

• 說明：取消玩家下注交易
• 文件參考：4.2.5 取消注單 (回滾下注及結算)

特殊遊戲類型 API

• 牌局型注單 API（/sessionBet）

  • 文件參考：4.2.7 牌局型注單 (下注和結算分別發送)
  • 技術要點：
    • 處理下注和結算分別發送的情況
    • 有效投注額（Turnover）的理解 Turnover (有效投注額)

• 取消牌局型注單 API（/cancelSessionBet）

  • 文件參考：4.2.8 取消牌局型注單 (回滾一筆下注)

玩家登入 (/LoginWithoutRedirect)

• API：LoginWithoutRedirect
• 文件參考：2.1.2 回傳登入網址
• 技術要點：
  • 登入連結使用限制：每個登入網址連結只可使用一次
  • 遊戲 ID 取得：GameId 可從 遊戲列表 取得
  • 語言支援：目前僅提供英文 "en-US"

遊戲管理 API

• 登出玩家

  • 強制單一玩家或所有玩家登出： 3.1.1 強制登出遊戲 / 3.1.2 強制登出遊戲(所有玩家或依遊戲)

• 注單查詢

  • 取得單筆注單的詳細遊戲結果 URL：3.1.3 取得注單詳細結果連結

• 其他管理功能

  • 遊戲列表：3.1.6 取得遊戲列表
  • MustHitBy 查詢：3.1.7 查詢 MustHitBy
  • 會員狀態：3.1.8 查詢會員狀態

• 取得遊戲Icon

  • 我們有兩種途徑提供取得各遊戲的Icon

  • 透過遊戲列表取得遊戲Icon

    

  • 透過API取得遊戲Icon
    詳情請見3.2.1 取得遊戲Icon