Skip to content

Prize Cashback

When a player interacts with the LoyaltyGyre iframe and requests a cashback for a prize (e.g., returning a reward for monetary credit), LoyaltyGyre will inform the casino’s backend to ensure that the player’s balance is updated accordingly.

By notifying the casino when a player requests a prize cashback, LoyaltyGyre ensures that the player’s balance is kept in sync with their in-game actions, providing a smooth and seamless rewards experience.

How It Works

  1. Player requests a cashback: The player selects an eligible prize and requests a cashback while interacting with the iframe.

  2. LoyaltyGyre sends a cashback request to the casino's backend:

    • LoyaltyGyre will notify the casino's backend that the player has requested a prize cashback.
    • This request typically includes the player's ID, the prize ID, and the cashback amount (or equivalent value in credits).

  3. Casino processes the cashback request:

    • The casino’s backend verifies the request and updates the player’s balance, adding the corresponding cashback amount or credits.

  4. Casino responds with confirmation:

    • The casino’s backend responds to LoyaltyGyre, confirming that the cashback request has been processed successfully.
    • If the cashback cannot be processed (e.g., due to player restrictions or insufficient balance), the request may be denied, and LoyaltyGyre will notify the player.

Flexibility in Implementation

Since each casino may have its own system for handling balance updates and cashback requests, LoyaltyGyre does not enforce a specific API for this interaction. It is expected that:

  • The casino provides an endpoint for processing prize cashback requests.
  • The casino implements the necessary logic to validate and update player balances or handle credits based on the cashback request.
  • The casino ensures accurate and timely responses to cashback notifications from LoyaltyGyre.

Handling Failures

If the casino’s backend is unable to process a prize cashback request due to technical issues or player restrictions, the cashback action in the iframe will not proceed.

In such cases, the player will receive a message indicating that the cashback could not be completed.

Workflow

sequenceDiagram
  participant P as Player
  participant C as Casino
  participant L as LoyaltyGyre
  autonumber
  P->>L: Request cashback for prize
  L->>C: Notify casino of cashback request
  destroy C
  C-->>L: Casino confirms cashback
  Note over P,L: Cashback applied