JA

Home/Technology

コールバック3回で
1ゲームが完了します。

起動、引き落とし、入金。ゲームプロバイダーが何社あっても、運営会社が受け取るリクエストはこの3つだけです。HIGHEND ASIAがその間で何をしているのか、確認できる事実だけを記載しました。

Round trip

1ゲームがやり取りされる流れ

シームレスウォレットの場合です。運営会社のウォレットはHIGHEND ASIAとだけやり取りし、ゲームプロバイダーごとに異なる仕様は間で吸収します。

Operator運営会社のウォレット
Asia HubHIGHEND
Providerゲームプロバイダー
Operator wallet · USD1,000.00
LAUNCHBETSETTLE

枠が光っているのが、いまリクエストを受けている側です。運営会社のウォレット残高はコールバックが届くたびにすぐ変わります。

wallet-callback.log · USD
  1. — LAUNCH
  2. POST /game/launch運営会社がゲーム起動をリクエスト
  3. POST /sessionゲームプロバイダーの仕様に変換してセッションを作成
  4. 200 game_urlゲームプロバイダーが起動URLを返却
  5. 200 game_url運営会社のサイトでゲームが起動
  6. — BET
  7. bet 5.00ゲームプロバイダーでベットが発生
  8. POST /wallet/usd/debit運営会社のウォレットへ引き落としコールバック
  9. 200 balance引き落とし後の残高を応答
  10. 200 okゲームプロバイダーへ処理結果を送信
  11. — SETTLE
  12. win 12.50ゲームプロバイダーが結果を確定
  13. POST /wallet/usd/credit運営会社のウォレットへ入金コールバック
  14. 200 balance入金後の残高を応答
  15. 200 ok1ゲーム終了

Wallet modes

標準はシームレス

残高を移し替えないシームレスウォレットを標準で接続します。ウォレット構成の変更が難しい運営会社様は、まずトランスファー方式についてご相談ください。

項目Seamless標準Transfer要協議
ユーザー残高の保管場所運営会社のウォレット。HIGHEND ASIAはコールバックを中継するだけです。プレイ中はゲームプロバイダーのウォレット。入室・退室時に移動します。
運営会社が実装するもの残高照会・引き落とし・入金のコールバック入金・出金リクエスト
残高の反映タイミングベットごとに即時振替時
通貨の追加通貨別のエンドポイントをひとつ追加します。ゲームプロバイダーごとのウォレット設定も合わせて増えます。
適しているケース複数のゲームプロバイダーをひとつのウォレットで運用する場合既存のウォレット構成をすぐには変更できない場合

Specification

技術仕様

開発チームが初回の打ち合わせ前に確認したい点を、先にまとめました。

Wallet
シームレスコールバック — 残高照会、引き落とし、入金
Endpoint
通貨ごとに個別のエンドポイント。ステージ環境と本番環境のURLを別々に発行します。
Currency
MNT · JPY · CNY · PHP · VND · MYR · THB · TWD · HKD · USD · USDT。ゲームプロバイダーの対応範囲により異なります。
Access
API呼び出しは登録済みのIPからのみ受け付けます。
Environment
ステージ環境と本番環境を分離。仕様は同じで、URLとキーのみが異なります。
Test
ステージ環境のサイトとテストアカウントで実際のゲームをプレイし、検収します。
Back office
管理画面のアカウントを全体・レポート・カスタマーサポートの権限に分けてお渡しします。
Report
ゲームプロバイダーごとの精算データを、通貨・ゲームプロバイダー基準でまとめてお渡しします。

Reliability

安定性とセキュリティ

認証マークではなく、実際に行っていることを記載しました。

ISOLATION

通貨単位で分離

エンドポイントが通貨別に分かれているため、ある通貨の問題をその通貨の中で食い止めます。

ALLOWLIST

許可されたIPのみ

運営会社・ゲームプロバイダーの双方とも、登録済みのアドレスからのリクエストのみを処理します。

ROLES

役割別アカウント

管理画面は全体・レポート・カスタマーサポートの権限に分け、必要な範囲だけを開放します。

STAGING

まずはステージ環境で

ゲームプロバイダーの追加や仕様変更は、ステージ環境での検収を通過した後にのみ本番環境へ反映します。

TRACE

コールバックごとに記録

引き落としと入金のコールバックを1件ずつ記録し、紛争が生じた際は同じ記録を一緒に確認します。

NOTICE

障害はすぐに共有

原因、影響範囲、復旧時刻を、判明し次第お知らせします。

Stage access

ドキュメントより先に
呼び出してみてください。

ステージ環境のURLとテストアカウントを契約前に発行します。