Skip to main content
The Bonus Call feature lets you apply temporary bonuses to a player’s active game session. Whether you want to reward new players with free spins or run a guaranteed-win promotion for retention, Bonus Call gives you a controlled mechanism to deliver those incentives through real gameplay rather than direct wallet credits.

​
Bonus types

iGamingAce supports two distinct types of bonus calls. Choose based on whether you want to offer risk-free spins or guarantee a specific winning outcome.
A Free Spin Bonus grants a player a fixed number of free spins on a specific game. The spins are played out through the game engine just like normal spins, but the player’s wallet is never charged — any wins are credited to their wallet automatically.Free Spin Bonus is available for only Pragmatic Play games.Key characteristics:
  • A fixed number of spins is assigned to the player for a specific game
  • Each spin does not deduct funds from the player’s wallet
  • Wins generated from free spins are credited to the player’s wallet automatically
  • The bet amount per spin and total spin count are predefined by you as the operator
  • The outcome of each spin is determined by normal game RTP mechanics — wins are not guaranteed
Typical use cases: welcome promotions, onboarding campaigns, re-engagement incentives for lapsed players.

​
Comparison

FeatureFree Spin BonusRegular Bonus Call
Wallet balance usedNoYes
Guaranteed outcomeNo (win depends on spin results)Yes (target win amount)
Gameplay executionYesYes
Spin typeFree spins onlyNormal spins and bonus rounds
Bet deducted per spinNoYes
Operator controlSpin countTarget win amount

​
How to use

Registering a bonus call Call POST /v1/bonus-call/register to initiate a bonus for a player. In the request, specify the bonus type (FreeSpin or Regular) along with the required parameters for that type — spin count and bet amount for Free Spin Bonus, or target winning amount for Regular Bonus Call. Once registered, the bonus becomes active for the player’s current or next game session. Canceling a bonus call If a bonus is still in progress and has not yet been completed, you can cancel it by calling POST /v1/bonus-call/cancel. Once a bonus has been fully delivered, it cannot be canceled. See the Register Bonus and Cancel Bonus API reference pages for full request and response schemas.

​
Bonus call lifecycle rules

Free Spin Bonuses have a predefined expiration time set at the time of registration.
  • If the player does not use all of their free spins before the expiration time, the bonus is automatically expired by the system
  • Any unused spins remaining at expiration are forfeited and cannot be recovered
  • Wins from spins used before expiration are unaffected and remain credited to the player’s wallet
A Regular Bonus Call remains active until one of two conditions is met:
  • The full target winning amount has been delivered to the player through gameplay, or
  • The bonus reaches its expiration time before the target is met
While active, the bonus must either complete naturally or be manually canceled via POST /v1/bonus-call/cancel. An incomplete Regular Bonus Call that reaches its expiration will be closed by the system automatically.