As for Finance Management in Integration Casino, the Integration Service provides the following operations for checking, depositing, and withdrawing funds. These are relevant for the Basic Wallet mode integration only.

The Deposit operation is used for adding funds to the player’s account. The Customer must specify which player, the amount, currency, and unique transaction reference. The currency must be the same as the one specified when the player was created.

The Withdraw operation is used for subtracting funds from the player’s account. The Customer must specify which player, the amount, the currency, and the unique transaction reference. The currency must be the same as specified when the player was created. A special case is when the Customer specifies the amount as 0 (zero), in which case ALL the money is subtracted from the player’s balance and the amount withdrawn is returned in response.

By using the GetBalance operation, the Customer system can obtain information about the current balance of the player in Integration Casino. This operation will be usually used for displaying the player’s balance on the game lobby and before using the Withdraw operation to determine the amount that can be withdrawn.

Recommended Deposit Flow

The scheme below is the recommended flow of events for a Deposit transaction:

1. The Customer system must initiate a withdrawal operation from the player’s account. During this operation, deduct the funds from the player’s account in the Customer system and set the record of the withdrawal to ‘pending’ in the Customer database. A unique transaction ID should be generated during this process, typically as a sequential number.
2. Call the Deposit operation, sending the required parameters: the player’s username, the deposit amount, and the unique transaction ID generated in the previous step. These operations add the amount requested to the player’s Integration Casino account and return a unique deposit ID to the Customer system.
   Note: Errors may be generated during these operations. Tests must be performed to ensure that all errors are handled correctly. Errors are generated if:
• The player cannot be found.
• The transaction reference ID has already been used in a previous transaction.

A list of all possible errors is available in the Integration Service section.

1. The Customer system must verify that the transaction ID returned is not the same for any other transactions in the local transaction tables.
2. When it has been verified that the transaction ID is unique, store the returned deposit ID with the withdrawal transaction and set the transaction to a ‘completed’ state.

Note: If during the Deposit call communication problems occur, the call will either generate an exception or it will time out. Handling deposit and withdrawal failures is the responsibility of the Customer, who should, therefore, keep track of all problems that occur with these transactions. The Integration Casino Management Console can be used to determine whether the communication broke before reaching Integration Casino or during the response by tracking the transaction using the Customer transaction ID and Integration Casino Management Console. Appropriate action can be taken, usually canceling the transaction on the Customer side, or setting it to ‘completed’.

Recommended Withdraw Flow

The provider recommends adherence to the following flow of events when a player requests a certain amount to be transferred from their Integration Casino account to their Customer account:

1. The Customer system must initiate a Deposit operation to the player’s account. At this point, no money is added to the account. The withdrawal is set to a ‘pending’ state in the database. Generate a unique transaction ID.
2. Call the Withdraw operation, sending the required parameters: the player’s username, the amount to withdraw, and the transaction ID generated in the previous step. If the player has sufficient funds in their Integration Casino account, the requested amount is deducted from the account and a unique Integration Casino withdrawal ID is returned.
   Note: The Withdraw operation may also generate errors. It is imperative that the Customer system handles these errors correctly. Errors are generated if:
• The player cannot be found.
• The transaction ID has already been used in a withdrawal or deposit.
• The player does not have enough funds available in their Integration Casino account to cover the requested amount.

A list of all possible errors is available in the Integration Service section.

1. The Customer system must verify that the returned withdrawal ID is a positive long number and that it is unique (i.e., that it has not been used to identify any previous transactions). Funds cannot be added to the player’s Customer account until the ID unique status has been confirmed. Once the withdrawal ID has been verified, the Customer system can add the requested amount to the player’s Customer account, set the transaction to a “completed” state, and store the Integration Casino withdrawal ID.