Gambling bonus change

Use Sumsub API to send and receive gambling bonus change data.

Gambling bonus change is the fluctuation or alteration in the bonuses offered by gambling or betting platforms. Such changes can be influenced by several factors, including competition, market trends, promotional campaigns, and regulatory policies.

Monitoring gambling bonus changes helps operators prevent bonus abuse when actions taken by players exploit the bonus offerings of online casinos or gambling sites in a way that gives them an unfair advantage.

Initiate gambling bonus change

Use the type of transaction below to document gambling bonus changes initiated by your users.
The required fields basically include the following.

{
    "txnId": "eaub8yhi6e45s3nx0pgpl",  //Unique transaction identifier within your system 
    "type": "gamblingBonusChange",
    "gamblingBonusChangeInfo": {
      "bonusId": "test-bonus-id",  //Unique bonus identifier within your system
      "amount": 80,
      "maxBonusAmount": 100,  //The maximum amount of bonus that can be received by a player
      "maxBetAmount": 5,  //The maximum bet allowed for the player
      "wagerRequirement": 4000,  //Indicates the total amount of bets that a player should bet to get bonus funds to his real balance. (example: wager = x40. with 100 EUR deposit + 100 EUR bonus amount player should bet 4000 EUR (100 eur bonus x 40) 
      "status": "activated"  //Options are activated/canceled/lost/finished/expired
    },
    "applicant": {
      "device": {
        "fingerprint": "wuzeu5iv89"  //Unique device fingerprint, used to track device usage
      }
    },
    "txnDate": "2024-01-25 14:20:06+0200"  //Transaction date. If the date is not provided, the current date will be used
  }

Check out response

The response contains the info from the created transaction (all attributes) above with additional objects that contain the current review and scoring info of the requested transaction.

{
    "id": "65b37b87db20fb058978aca2",
    "applicantId": "65a906b659df1414adf1107b",
    "scope": "events",
    "externalUserId": "dash-2385a803-1cce-46f6-a9f8-675957c0da32",
    "clientId": "clientId",
    "data": {
      "txnId": "eaub8yhi6e45s3nx0pgpl",
      "txnDate": "2024-01-25 12:20:06+0000",
      "applicant": {
        "externalUserId": "dash-2385a803-1cce-46f6-a9f8-675957c0da32",
        "fullName": "John Smith",
        "type": "individual",
        "device": {
          "fingerprint": "wuzeu5iv89"
        }
      },
      "type": "gamblingBonusChange",
      "gamblingBonusChangeInfo": {
        "bonusId": "test-bonus-id",
        "amount": 80,
        "maxBonusAmount": 100,
        "maxBetAmount": 5,
        "wagerRequirement": 4000,
        "status": "activated"
      },
      "sourceKey": "123"
    },
    "score": 0,  //Bonus risk score
    "review": {
      "reviewId": "WkmZN",
      "attemptId": "hgVYl",
      "attemptCnt": 0,
      "elapsedSincePendingMs": 26,
      "elapsedSinceQueuedMs": 26,
      "createDate": "2024-01-26 09:29:43+0000",
      "reviewResult": {
        "reviewAnswer": "GREEN"  //Transaction status: GREEN (approved), RED (rejected)
      },
      "reviewStatus": "completed"
    },
    "createdAt": "2024-01-26 09:29:43+0000",
    "scoringResult": {
      "score": 0,
      "dryScore": 0,  //The risk score of the transaction including the matched rules in the “dry run” mode
      "matchedRules": [],
      "unmatchedRules": [],
      "action": "score",
      "ruleCnt": 0,  //Matched rules total
      "dryRunRuleCnt": 0,  //Matched rules in the “dry run” mode total
      "tagScores": []
    },
    "typedTags": [],
    "txnInactive": false
  }