Rewards

Unibo requires a dedicated endpoint to facilitate various types of payouts for rewarding players.

Key Requirements

Authorization

  • Unibo utilizes an API key in request headers or IP whitelisting for authorization.

Idempotency

  • To prevent duplicate prize payouts, an idempotency mechanism is used. Each prize payout request includes a unique identifier in the headers. If the platform has already processed a request but encountered an error (e.g., timeout or connection drop), it will ignore duplicate requests with the same identifier.

Jackpot Campaigns

To support jackpot campaigns, the system must include the capability to distribute cash prizes with dynamic amounts and currencies for individual players.

Rewards Predefined on the Platform

Unibo offers a mechanism to distribute prizes using rewards predefined on the platform. This process includes fetching a list of available rewards, enabling administrators to select a reward from a drop-down menu in the back office, and subsequently sending a request to execute the reward for a given player ID.

Implementation Details

  • Periodic Synchronization
  • The system periodically checks (e.g., every minute) the rewards available for a given casino.
  • Rewards are synchronized with the local state, and unavailable rewards are marked accordingly.
  • Back Office Functionality
  • Administrators can select rewards for prize payouts.
  • Rewards can be customized for player-facing displays (e.g., overlays) with the following options:
  • Catalog Item: Configurable with a title (localized per language) and a prize value for reporting purposes.
  • Cash: Requires a specified amount in EUR.
  • Bonus Money: Requires a specified amount and associated wagering requirements.
  • Deposit Bonus: Requires a percentage value and wagering requirements.
  • Free Spins: Requires the number of spins and applicable games (to display accurate Terms and Conditions and overlay information).