POST/v1/games/start

Start Game

Initialize a new game session for a player.

Headers

Content-Typeapplication/json

Request body

{
  "merchantCode": "string",
  "playerId": "string",
  "betAmount": 100,
  "isDemoMode": false,
  "payload": {
    "userToken": "string",
    "customData": "any"
  }
}

HTTP 200application/json

{
  "status": "SUCCESS",
  "success": true,
  "message": "Game started successfully",
  "data": {
    "betAmount": 10,
    "currentBalance": 17530,
    "winStreak": 0,
    "loseStreak": 0,
    "totalGames": 0,
    "betHistory": [],
    "currentCard": "9♥",
    "currentCardValue": 9,
    "currentCardSuit": 3,
    "currentCardSuitText": "Hearts",
    "cardsRemaining": 51,
    "nextTierCredit": 2,
    "probabilities": {
      "higherProb": 0.45098039215686275,
      "lowerProb": 0.6078431372549019,
      "sameProb": 0.058823529411764705
    },
    "isSameChoiceDisabled": true,
    "sameCardBehavior": "win"
  }
}

HTTP 400HTTP 400

{
  "status": "ERROR",
  "success": false,
  "message": "Bet amount 50000 exceeds maximum bet 10000",
  "data": null
}

cURL example

curl -X POST \
  "{API_BASE_URL}/v1/games/start" \ 
  -H "Content-Type: application/json" \
  -d '{
  "merchantCode": "string",
  "playerId": "string",
  "betAmount": 100,
  "isDemoMode": false,
  "payload": {
    "userToken": "string",
    "customData": "any"
  }
}'

← Back to API list