WalletId

Overview

The WalletId parameter represents a unique identifier of the wallet in the operator’s system where the user has money. This identifier is used by GPAS to associate game transactions with the correct player wallet.

Purpose

The WalletId serves several important functions:

Wallet Identification: Uniquely identifies the player’s wallet in the operator’s system
Transaction Association: Links game transactions to the correct wallet
Balance Management: Allows the system to retrieve and update the correct player balance
Multi-Wallet Support: Enables support for players with multiple wallets

Wallet Types

A Wallet can have sub-Wallets, intended for various purposes:

Real Money: The player’s main balance of real money
Bonuses: Special promotional balances with specific rules
Different Credit Channels: Various sources of funds with different rules or restrictions
Segmented Balance Information: Separation of balance information for different purposes

Implementation

When implementing the WalletId:

Generate a unique identifier for each player wallet
Include the WalletId in the game launcher URL as a query string parameter
Ensure that the WalletId is properly URL-encoded
Implement proper error handling for invalid or non-existent wallet IDs

Example

https://subdomain.example.com/launcher/game/?authToken=abc123&walletId=wallet123

Multi-Wallet Considerations

If your system supports multiple wallets per player:

Implement a mechanism for players to select which wallet to use
Clearly display the selected wallet and its balance
Ensure that transactions are correctly associated with the selected wallet
Provide a way for players to switch between wallets

Security Considerations

Transport Security: Always use HTTPS to transmit the WalletId
Validation: Validate that the WalletId belongs to the authenticated player
Error Handling: Implement proper error handling for invalid or non-existent wallet IDs
Logging: Log all transactions associated with each WalletId for auditing purposes