How a Promo API can work

Free spin promotions are a popular and engaging way to reward players in gaming environments. Behind the scenes, however, delivering a seamless “free spins” experience requires coordination between your promotion platform and the external game provider who actually grants the spins.

In this post, we’ll walk through how a Free Spin Promotional API typically works, from configuration to reward fulfilment, and what happens once a player starts using their spins.

1. What’s Required to Deliver Free Spins

To enable free spin rewards, two key components must be in place:

1. A game provider that can issue the free spin reward.
2. A promotion platform that triggers and manages the reward workflow.

With these components connected, the promotional flow can begin.

2. The End‑to‑End Free Spin Promotion Flow

Step 1: Configure the Promotion With the Provider

The setup begins on the provider’s side. Here, the following details are defined:

• Total reward value
• Value per spin
• Provider promotion ID
• Eligible games (the titles on which the free spins can be used)

This creates the foundation for the reward structure.

Step 2: Configure the Promotion in Your Promotion Platform

Next, the promotion is mirrored within the promotion platform. Typical configuration fields include:

• Provider promotion ID (sometimes called the template ID)
• Provider name
• Eligible product
• Reward type and value
• Currency

Once submitted, your promotion platform automatically performs an API call to the provider to fetch the list of eligible games. These games are then displayed on the front‑end promotional page.

3. Customer Experience Flow

Opt‑In

When the promotion goes live, the customer can opt in. After opting in, the promotion platform begins tracking the customer’s contributions toward the reward (e.g., wagering activity or action milestones depending on the promotion).

Triggering the Reward

When the customer meets the requirement, the platform:

1. Marks the reward as triggered.
2. Displays the reward availability to the customer.
3. Sends a request to the Reward Gateway (or equivalent internal system).

The Reward Gateway then:

• Registers the customer into the provider’s promotion,
• The provider grants the free spins,
• And returns an Instance ID (or similar token) back to your system.

4. How Free Spins Are Delivered to the Player

Once the reward is granted, the player launches any eligible game. From here, the experience may differ slightly based on the provider:

• Some providers use a dedicated free spins wallet, applying the spins automatically.
• Others grant the spins as soon as the first eligible game is launched.

In both cases, the spins generate free bet transactions, which your system processes like other gameplay transactions.

5. Summary

A Free Spin Promotional API links your promotion platform with a game provider to deliver seamless, automatically awarded spin rewards. The process includes:

1. Setup on provider and promotion platform
2. Fetching eligible games via API
3. Customer opt‑in and progress tracking
4. Reward triggering and provider fulfilment
5. Automatic application of spins in an eligible game

This structured workflow ensures players enjoy a frictionless promotional experience while your internal systems maintain full control and visibility at every step.