Skip to main content

Credit Experience Points and Tokens

Welcome to the Gamanza Engage Platform! This guide will help you integrate and utilize two key functionalities: Credit Experience Points and Credit Virtual Currency Coins. These features allow casino operators to reward players easily and expand engagement opportunities through custom workflows.

Authentication​

To access the API, you'll need to authenticate using OAuth client credentials that you can create in our Admin UI under the system settings section. Please check out these docs for more details: Authentication with Platform API

Prerequisites​

Before you begin, ensure the following:

  • You have access to the Gamanza Engage Platform API.
  • API credentials are available and configured.
  • Players are registered on the platform and have unique identifiers.
  • Your system is ready to implement API workflows.

Functionality Overview​

1. Credit Experience Points​

Purpose:​

The Credit Experience Points functionality allows casino operators to award players with Experience Points (XP) as a form of recognition and reward. Experience Points can be used to gamify engagement and track player progression.

Example Use Case:​

You can use XP rewards for achievements like completing specific tasks, reaching milestones, or participating in promotions.

2. Credit Virtual Currency Coins​

Purpose:​

The Credit Virtual Currency Coins functionality allows casino operators to award players with Virtual Coins, which can be used within in the Gamanza Engage Rewards Shop to purchasing items.

Example Use Case:​

Reward coins for actions such as login streaks, high scores, or participation in special events.

3. Assign Rewards to Player​

Purpose:​

Assign rewards to players allows casino operators to award players with Gamanza Engage rewards like:

  • Boosters (Token Boosters, Experience Boosters, Mission Boosters)
  • Bonus
  • Tokens
  • Experience Points

When you assign rewards through this API, allows you to define extra configurations like claim rewards and reflect this data in my rewards section in the Admin UI and in the Gamanza Engage Widgets.

Important in the request please provide the source with a clear description to properly identify the reward assignation in the Gamanza Engage Admin UI from the rest of rewards.

Example Use Case:​

Reward XP booster for actions such as login streaks, high scores, or participation in special events.

You can configure a rewards bundle to give to a player or a group of player a bundle that contains multiple reward in a single request like for example when a VIP player deposits you can award the player with:

  • XP Boosters
  • Tokens
  • Experience Points

Rate Limiting​

To ensure the stability and reliability of our API, we enforce rate limiting. The rate limit the crediting APIs is 100 requests per minute.

How Rate Limiting Works

  • Rate Limit Window: A sliding window of one minute.
  • Maximum Requests: 100 requests can be made within this window.
  • Throttle Behavior: If the limit is exceeded, further requests will be blocked until the window resets.

Best Practices​

  • Reason Descriptions: Provide meaningful reason values for better tracking and auditing.
  • Error Handling: Implement robust error handling for scenarios like invalid playerId or insufficient permissions.
  • The maximum limit of assignations per request are 1000.
tip

Please review our Integration Best Practices for more details.

Next Steps​

Now, please take a look to our Data Fetch API Reference. Happy integration and happy coding!

Footer diceFooter dice