Grant FRB to players

Grant a free round bonus to one or more players using a previously created template.

Request endpoint: /frb/grant/{version}/players?subProvider=1

Request Method: POST

Usage information:

The request body specifies the template to grant and the target players.

Note

This request requires an authorization token: Bearer authorization token.
Token Format: The authorization token must be Base64-encoded as follows:
AuthorizationToken = encode(back_office_email:back_office_password)

Note

For Playson and Evoplay Entertainment, only one player can be sent in the array.

Note

templateId should be the id field from the root object returned by the Create FRB template endpoint.

In the response body, templateId inside succeeded_frb_awarded is the granted template ID. Use this ID for subsequent status checks and cancellations.

Request parameters:

Parameter	Data type	Description
version	String required	The API version. Only version 1.0 is currently supported. Other version values are accepted, but are treated as 1.0. Example: v1
subProvider	Integer required	Must be `1`. Ensures the response contains the correct `providerName` and `providerId`.
Authorization	Yes (Header)	Sinatra back office user

Request body:

{
  "templateId": "663b1f77bcf86cd799439011",
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "players": [
    {
      "playerId": "player_001",
      "playerCurrency": "EUR",
      "playerCountry": "USA"
    }
  ]
}

Note

transactionId - (optional) The unique transaction ID for this request, generated by the casino platform. This is used for idempotency, to avoid processing the same request multiple times. If a request with the same transactionId has already been processed, the system will return the result of the previous request instead of processing it again, we recommend sending it in UUID format, while there is no validation on TechFusion side, some providers have, and our internal tests use UUID.V4
Currency - ISO 4217 currency code, should be the same as the currency of the player, which is used to play the game.
Country - alpha-3 country code, should be the same as the country (alpha-2) of the player, which is used to play the game.

Response parameters:

None

Example Response

Success response

{
  "id": "663b1f77bcf86cd799439022",
  "templateId": "663b1f77bcf86cd799439011",
  "players": [
    {
      "playerId": "player_001",
      "playerCurrency": "EUR",
      "playerCountry": "USA"
    }
  ],
  "status": "Success",
  "templatesAwardedCollections": {
    "failed_frb_awarded": [],
    "succeeded_frb_awarded": [
      {
        "templateId": "TMP_82600118_11_BetSoft",
        "providerName": "BetSoft",
        "providerId": 82,
        "operatorId": 11,
        "numberOfRounds": 10,
        "availableFromDate": "2026-04-29 00:00:00",
        "availableDuration": 7,
        "expirationDate": "2026-05-06 00:00:00",
        "offerName": "WelcomeBonus",
        "gameInfoList": [
          {
            "gameId": "82600118",
            "betAmount": [100]
          }
        ],
        "players": [
          {
            "playerId": "player_001",
            "playerCurrency": "EUR",
            "playerCountry": "USA"
          }
        ],
        "status": "Success"
      }
    ]
  }
}

Info

For transactions(wager/result), the frbid which will be sent in request is the template id within succeeded_frb_awarded.

Info

For Get / Cancel FRB requests, the id which should be sent is the template id within succeeded_frb_awarded.

Error Response:

{
  "errMsg": "bad request"
}

Response codes:

Code	Status	Message
200	success	FRB granted successfully
400	bad request	bad request
422	Invalid parameters	One of: • bet amount should be an integer • no metadata fields for this provider • Available date is empty • Available date should be with format yyyy-MM-dd HH:mm:ss • Available date should be a future date • Expiration date is empty • Expiration date should be with format yyyy-MM-dd HH:mm:ss • Expiration date should be a future date • Number of rounds is empty • Balance type id is empty • Balance type id allowed values are 0 or 1 • Wrong balance type id size - values are 0 or 1 • Offer name can not be more than 255 characters • Game info list is empty • Game id not exist in this provider • provider supports only single game
500	internal server error	internal server error