Revoke batch bonuses

This method revokes bonuses from players. If the bonus were successfully revoked, it would return a list of players’ bonus items. In case of an error, it will return a list of error bonus items.

NOTE: This method is optional. The PartnerBoard is the most reasonable way to revokes bonuses from players.

POST https://{S2S_API_URL}/bonuses/bonus/revokeBatch

A request examples:

An example using firebase/php-jwt and guzzlehttp/guzzle packages:

use Firebase\JWT\JWT;
use GuzzleHttp\Client;
$PARTNER_SECRET = 'testdemo';
$payload = [
    'cid' => 'fbet',
    "bonusesIds" => [
        20
    ]
];

$jwtParts = explode('.', JWT::encode($payload, $PARTNER_SECRET, 'HS256'));
$signature = implode('.', [$jwtParts[0], '', $jwtParts[2]]);

// x-sign-jws=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..dHeSv09pyg1TZOhAbrNobciONz2-rfUuoDojV-wrOJQ
echo "x-sign-jws=$signature";

// send the request
$body = json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

$url = 'https://{S2S_API_URL}/bonuses/bonus/revokeBatch';

$client = new Client();
$response = $client->request('POST', $url, [
    'body' => $body,
    'headers' => [
        "Content-type" => "application/json",
        "x-sign-jws" => $signature
    ]
]);

echo $response->getBody()->getContents();

An example using jsonwebtoken package:

const jwt = require('jsonwebtoken');
const { fetch } = require('undici');

const PARTNER_SECRET = 'testdemo';
const payload = {
    cid: 'fbet',
    bonusesIds: [
        20
    ]
};

const [jwtHeader, , jwtSignature] = jwt
  .sign(payload, PARTNER_SECRET, {
    algorithm: 'HS256',
    // jsonwebtoken adds iat claim in payload but we need JWT payload to match request body
    // so ask jsonwebtoken to drop redundant fields
    noTimestamp: true,
  })
  .split('.');
const signature = [jwtHeader, '', jwtSignature].join('.');

// x-sign-jws=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..dHeSv09pyg1TZOhAbrNobciONz2-rfUuoDojV-wrOJQ
console.log(`x-sign-jws=${signature}`);

// send the request
const req = await fetch('https://{S2S_API_URL}/bonuses/bonus/revokeBatch', {
  method: 'POST',
  body: JSON.stringify(payload),
  headers: {
    'Content-type': 'application/json',
    'x-sign-jws': signature,
  },
});

curl --location 'https://{S2S_API_URL}/bonuses/bonus/revokeBatch' \
--header 'x-sign-jws: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..dHeSv09pyg1TZOhAbrNobciONz2-rfUuoDojV-wrOJQ' \
--header 'Content-Type: application/json' \
--data '{"cid":"fbet","bonusesIds":[20]}'

The table below describes the following parameters:

Parameter	Type	Description
cid	string	Partner API Key.
bonusesIds	List of integer	An array of unique bonus identifiers assigned by Sportsbook.

A response examples:

HTTP status code: 200

{
  "items":{
    "1243":{
      "id":1243,
      "templateId":359,
      "name":"Bonus freebet",
      "type":"freebet_standart",
      "userId":"6",
      "cid":"fbet",
      "stage":3,
      "disciplines":[
        "csgo"
      ],
      "activationDate":1707749397,
      "endingDate":null,
      "status":"revoked",
      "fromTime":1707609600,
      "toTime":1708041600,
      "freebetData":{
        "betAmount":5,
        "betCount":4,
        "availableBetCount":4,
        "maxWin":100,
        "currency":"USD",
        "minSelection":1,
        "maxSelection":2,
        "minOdd":1,
        "maxOdd":5
      },
      "availableCountries": null,
      "availableTournaments": null
    }
  },
  "errorItems":[]
}

HTTP status code: 200

{
  "items":[],
  "errorItems":{
    "20":{
      "id":20,
      "errorCode":32
    }
  }
}

The table below describes the following parameters:

Parameter	Type	Description
items	List of <PlayerBonusItem>	The array contains information about the players who need to be given a bonus.
errorItems	List of <ErrorRevokeBonus>	The array contains information about errors.

The table below describes the ErrorRevokeBonus:

Parameter	Type	Description
id	integer	A unique bonus identifier assigned by Sportsbook.
errorCode	integer	Error code. Possible error codes:
31 - Bonus is expired;
32 - Bonus not found;
35 - Bonus already revoked;
36 - It is not possible to revoke a bonus when its status is done.;

HTTP status code: 400

Example response body:

{
    "code": 1,
    "message": "Request signature is invalid"
}

Parameter	Type	Description
code	Integer	Error number. Possible error codes:
1 - Request signature is invalid,
5 - Request validation error
message	string	A detailed explanation of the error.

HTTP status code: 422

Example response body:

{
  "message":"The given data was invalid.",
  "errors":{
    "bonusesIds":["The bonuses ids field is required."]
  },
  "code": 5
}

Parameter	Type	Description
message	string	A detailed explanation of the error.
errors	object	Detailed information for each validation error.
code	integer	Error code. The default value – 5.