NetgamingLogo

GrantBonus() API

This API request enables the operator to grant bonus free spins (promotional free spins) to the player.

POST   /wallet/grant-bonus/

JSON

Content-Type: application/json
Host: https://test-api.netgaming.com/v1/
{
    "api_key": "1pghjl4v5apt2bks",
    "amount_type": "promo_freespin",
    "campaign_id": "BON-3",
    "game_ids": [3,4,5],
    "coin_value_level": 1,
    "num_rounds": 10,
    "player_ids": [ "586", "3434" ],
    "currencies": [ "GBP", "USD" ],
    "start_date": "2020-07-19 14:00:00",
    "end_date": "2020-08-30 15:00:00"
}

 

Parameters Type Description
api_key String API Key allocated to each front-end
amount_type String Mode of the play. 
Ex:
‘promo_freespin’ – It  is when the player is playing with promo freespins
campaign_id String It should be unique campaign id
game_ids List List of game_id for which promo free spins are granted.
Ex: game_ids: [1,10,6,3]
coin_value_level Integer The value must be an integer and must be from allowed list of coin values levels.
Before you start with promo freespins, please refer the coinvaluelevels() API
num_rounds Integer It indicates the number of free spin rounds that is granted to the player.
player_ids List Player ID of the player known to the operator. Free spins are granted to all these player IDs mentioned in this list and for all the games mentioned in the game_ids list.
currencies List Currency of the player and it should match with the player currency which is already registered with us. Currencies count should match with the players count.
Ex:- ["EUR", "USD"]
start_date String(Optional) Date time from which this bonus can be used. It should not be less than are equal to current time
format = “YYYY-MM-DD HH:MM:SS”
end_date String Expire date time of the promotion. It cannot be less than the start_date
format = “YYYY-MM-DD HH:MM:SS”
Response Example
{
    "result": {
        "status": "success",
        "promo_freespin_id": "qwertyuiopasdfghjkl"
    }
}

 

Parameters Type Description
status Integer 0 Indicates fail, 1 indicates success response
promo_freespin_id String Provide will generate the unique ID for each awarded bonus

grantbonus() API additional notes

  1. Combination of bonus_id, player_id and game_id is always unique per operator/aggregator.
  2. Coin value levels are explained below. Below are the coin values per game and per currency for reference. Actual coin values will be provided during the integration.
  3. Example: For Game-1 if the coin value level 3 is chosen, coin value for EUR player would be 3, coin value for ARS player would be 90, coin value for BRL would be 15. These are the coin values that will be used during the promo free spins play.
Game Name Game Name-1
Coin Value Levels 1 2 3 4 5
Currencies Coinvalues
EUR 1 2 3 4 5
ARS 30 60 90 120 180
AUD 1 2 3 4 6
BRL 5 10 15 20 30
BGN 1 2 3 4 6
CAD 1 2 3 4 6
CNY 10 20 30 40 60