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 a transaction transmission.

tip

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

Request parameters

NameTypeRequiredDescription
tokenstringYesAuthorization code of user's session
Restrictions: 1..250
userIdstringYesThe unique identifier of the user
gameIdintegerYesThe identifier of the game
extraDatastringYesAdditional information about transactions in JSON format
Examples may be viewed at Link example
Can return an empty object
eventIdstringYesFor gameplay related balance change within a round
bonusCodestringNoBonus code for freespin
directionstringYesIndicates either Debit or Credit
debit: from wallet of the player
credit: to wallet of the player
Accepted values: debit, credit
transactionIdstringYesUniquely identifies the intent to change the balance
eventTypestringYesWin - user win
Lose - user lose
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 Call back API
Accepted values: true, false
balancedecimalYesPlayer's latest balance at the time of the 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 latest balance at the time of the request completion
    Decimal format required
    Maximum possible value:
  • Fiat currencies - 999999999999999999.99
  • Crypto currencies - 999999999999.99999999
  • bonusBalancedecimalNoPlayer's latest balance at the time of the 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"
    }
    }