Skip to content

General Bonus Information

Overview

This section provides essential information about bonus integration, including bonus identification, supported types, and how to get started with implementation.

Bonus Identification

Each bonus is uniquely identified by the combination of two fields:

  • sportBonusOfferId - The Activity ID from Journey Builder (same for all users)
  • sportBonusPlayerOfferId - Unique identifier for each player's bonus activation

How it works:

  • Bonuses are represented as Journey entities (combination of blocks in Journey Builder)
  • Each block has its own sportBonusOfferId (Activity ID)
  • When a user participates in a journey, they receive a unique sportBonusPlayerOfferId
  • This player offer ID is duplicated for each concrete player activation

Webhook Integration

Activation ID Mapping

When integrating bonuses via webhooks, you can map the activationId from the webhook to sportBonusPlayerOfferId in wallet transactions. This allows you to:

  • Track bonus award/retract operations
  • Link bets to specific bonus activations
  • Monitor bonus lifecycle events

Getting Webhook Access

To integrate bonuses through webhooks:

  1. Contact your Account Manager (AM) or Project Manager (PM) from the GR8 Tech team
  2. Request webhook access and provide your IP addresses for whitelisting
  3. Review the Webhook API Source documentation

Supported Bonus Types

Wallet-Dependent Bonuses

These bonuses require wallet integration:

Bonuses Without Wallet Integration

These bonuses don't require wallet transactions:

  • Bet Condition
  • Bet Collection (Cashback)
  • Bet Insurance

Getting Started

1. Understand the Product

Before starting integration:

  1. Download the bonuses in GR8 Sportsbook iFrame for a comprehensive overview
  2. Visit the Knowledge Hub to explore the CRM Module where bonuses are configured
  3. Review the complete list of bonus offer types
  4. Familiarize yourself with Journey Activities

2. Choose Your Bonus Type

Select the bonus type you want to integrate and follow the specific implementation guide:

3. Set Up in Journey Builder

  1. Access the CRM Module in your GR8 Tech dashboard
  2. Create a new Journey or edit an existing one
  3. Add the appropriate bonus Activity block
  4. Configure bonus parameters (amount, wagering requirements, etc.)
  5. Note the Activity ID - this will be your sportBonusOfferId in transactions

4. Implement Wallet Integration

Follow the specific transaction flows for your chosen bonus type. Each bonus type requires implementing specific transaction types (award, release, retract, etc.).

Additional Resources