Cancel FRB

Cancel FRB

Cancel an active free round bonus granted to a player.

Request endpoint: /frb/{version}/bonus?subProvider=1&operator_id=XXXXX&template_id=XXXXX&player_id=XXXXX

Request Method: DELETE

Usage information:

The request query parameters include the operator ID, template ID, and player ID.

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)

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 provider_id reflects the correct provider.
operator_id Integer required TechFusion operator ID
template_id String required FRB grant template ID (the templateId from succeeded_frb_awarded in the grant response).
player_id String required The granted player ID.
Authorization Yes (Header) Sinatra back office user

Example Response

Success response

{
  "player_id": "player_001",
  "player_currency": "EUR",
  "operator_id": 11,
  "provider_id": 82,
  "status": "canceled",
  "template_id": "TMP_82600118_11_BetSoft",
  "left_rounds": 8,
  "total_rounds": 10,
  "expiration_date": "2026-05-06T00:00:00Z",
  "games": [
    {
      "game_id": "82600118",
      "bet_amount": [100],
      "currency": "EUR"
    }
  ],
  "error_message": ""
}
Info

provider_id in the response is the numeric ID of the provider used when creating the template.

Error Response:

{
  "player_id": "player_001",
  "player_currency": "EUR",
  "operator_id": 11,
  "provider_id": 82,
  "template_id": "TMP_82600118_11_BetSoft",
  "expiration_date": "2026-05-06T00:00:00Z",
  "error_message": "Internal Server Error"
}

Status Index:

Status Description
active The FRB is active, and the player can play.
canceled The FRB is inactive; the operator requested to cancel the bonus.
expired The FRB is inactive. The expiration date has passed.
completed The player has finished playing; no available rounds remain for this bonus.

Http response codes:

Code Status Description
200 success 200 success status update
400 bad request bad request
403 forbidden access forbidden access
500 internal server error internal server error