Skip to main content

Move funds

Request

URI: /moveFunds

Example usage: https://{callback_url}/moveFunds

The request is executed using the POST method.

This method is required for transaction transmission.

tip

Move Funds will be conducted using a static game ID, regardless of the game on Betby.
This ID must be specified by the support team during integration.

Request parameters

NameTypeRequiredDescription
tokenstringYesAuthorization code of the user's session
Restrictions: 1..250
userIdstringYesThe unique identifier of the user
gameIdintegerYesThe identifier of the game
extraDatastringYesAdditional information about the transaction in JSON format
Examples can be viewed at Link example
Can return an empty object
eventIdstringYesFor gameplay-related balance changes within a round
bonusCodestringNoBonus code for freespins
directionstringYesIndicates either Debit or Credit
debit: from the player's wallet
credit: to the player's wallet
Accepted values: debit, credit
transactionIdstringYesUniquely identifies the intent to change the balance
eventTypestringYesWin - user win
Lose - user loss
BetPlacing, BetPayedAbort, BetPlacingAbort, SportBetCancel, Tip, PromoWin, technicalFix, DropAndWin, PromoStreamersDebit, PromoStreamersCredit, PromoStreamersBetPlacingAbort, PromoStreamersBetPayedAbort
View the description of event types Here
amountdecimalYesThe amount of the moved funds

Response parameters

NameTypeRequiredDescription
statusbooleanYesResponse status code for Callback API
Accepted values: true, false
balancedecimalYesPlayer's latest balance at the time of request completion
balance is the sum of realBalance and bonusBalance values
Decimal format required
Maximum possible value:
  • Fiat currencies - 999999999999999999.99
  • Crypto currencies - 999999999999.99999999
  • realBalancedecimalNoPlayer's real balance at the time of request completion
    Decimal format required
    Maximum possible value:
  • Fiat currencies - 999999999999999999.99
  • Crypto currencies - 999999999999.99999999
  • bonusBalancedecimalNoPlayer's bonus balance at the time of request completion
    Decimal format required
    Maximum possible value:
  • Fiat currencies - 999999999999999999.99
  • Crypto currencies - 999999999999.99999999
  • errorsobjectNoDescription of errors in case status = false
    errors.codenumberNoError code
    errors.errorstringNoError description

    Example of a successful response

    Response: /moveFunds
    {
    "status": true,
    "balance": 124001.55,
    "realBalance": 124001.55,
    "bonusBalance": 0,
    }

    Example of an unsuccessful response

    Response: /moveFunds
    {
    "status": false,
    "errors": {
    "code": 400,
    "error": "Description"
    }
    }