カジノ API のロールバックはどう動く？
ロールバックが存在する理由
ラウンドが無効化され、テーブルがハンド途中で失敗し、または重複イベントが検出されたとき、スタジオとアグリゲーターはベットやウィンを取り消す必要があります。明確なロールバック経路がなければプレイヤー残高とエージェント台帳が乖離し、財務とサポートの信頼を最も早く損ないます。
ロールバックのための設計
すべてのウォレット変更を 冪等 として扱ってください。Seamless エンドポイント（または Transfer セッション台帳）は、元の取引 / ラウンド id をキーにしたロールバックを受け取り、すでに適用済みなら成功を返すべきです。コールバック再試行で二重入金・二重引き落としを起こさないでください。
ハッピーパスとロールバックパスを、チームが Swagger サンプルと PDF 統合ガイドを置く同じ場所に文書化してください。
Transfer vs Seamless の挙動
- Transfer：セッション範囲の残高は、一部の無効化をプレイ境界でのウォレット調整として照合しやすくしますが、スタジオ起点の取り消しは依然正しく適用する必要があります。
- Seamless：ロールバックはウォレットコールバックとして到着します。使用する MegaNodes リージョン（kr / de / ca）から迅速かつ一貫して応答する必要があります。
両モデルの詳細：wallet models。
運用の可視性
ロールバック嵐の後の紛争調査には、BackOffice のゲーム履歴 — ベット、ウィン、Bonus Call、タイムスタンプ — を使ってください。エージェント単位の RTP と Bonus Call 活動は自然プレイと分離可能であるべきです。機能マップ：Features。
テストチェックリスト
- 同じロールバックを二度再生し、正味効果が一度だけであることを断言する。
- 部分ウィン系列の後の無効化を確認する。
- レポートのタイムゾーンが財務カレンダーと一致することを確認する。
- デモの 日次/セッション 上限が本番ロールバック規則のように見えないことを検証する。