In Game Transaction Call

The operator wallet must support real‑time transaction handling initiated by the game platform. The following transaction types are mandatory.

Primarily there would be 4 transaction types

Get Balance
Place Bet
Award Win
Refund
Purchase (Optional) - similar to Place Bet

Supported Protocols:

REST (JSON)
XML / SOAP - Legacy, not in use for new integrations

Additional formats can be supported based on requirements.

Endpoints, request type, request body, request format has to be provided by operator along with encryption and security measures needed.

Transaction Flow Diagram

The diagram below illustrates the standard transaction sequence for a real-money game round:

Step	Direction	Transaction Type	Description
1	GP → CloudAggregator → Operator	GetAccount	GP requests player identity and configuration for the session.
2	GP → CloudAggregator → Operator	GetBalance	GP requests the player's current wallet balance before the round begins.
3	GP → CloudAggregator → Operator	Wager	Player places a bet. Operator deducts the wager amount from the player's wallet.
4	GP → CloudAggregator → Operator	Result	GP reports the game outcome. Operator credits any winnings to the player's wallet.
4a	GP → CloudAggregator → Operator	Rollback	If the Result cannot be delivered, GP rolls back the Wager. Operator refunds the player.

Wallet Transactions Flow

sequenceDiagram
autonumber

actor Player
participant Game
participant CloudAgg as Cloud Aggregator
participant Wallet as Operator Wallet

Player->>Game: Launch game
Note over Game,CloudAgg: Game launch URL already generated

Game->>CloudAgg: Get player balance
CloudAgg->>Wallet: getBalance(playerId, sessionId, gameId)
Wallet-->>CloudAgg: PlayerBalance {balance, currency, status}
CloudAgg-->>Game: PlayerBalance

Player->>Game: Place bet
Game->>CloudAgg: Bet request
CloudAgg->>Wallet: placeBet(playerId, sessionId, gameId, amount)
Wallet-->>CloudAgg: PlayerBalance {balance, transactionId, status}
CloudAgg-->>Game: Bet result

Game->>CloudAgg: Win request
CloudAgg->>Wallet: awardWin(playerId, sessionId, gameId, amount)
Wallet-->>CloudAgg: PlayerBalance {balance, transactionId, status}
CloudAgg-->>Game: Win result

alt Bet refund required
Game->>CloudAgg: Refund request
CloudAgg->>Wallet: refundBet(playerId, sessionId, gameId, betTransactionId)
Wallet-->>CloudAgg: PlayerBalance {balance, transactionId, status}
CloudAgg-->>Game: Refund result
end