Gameball Developers Guide
v4.0
v4.0
  • Introduction
  • Installing Gameball
    • Web
      • Initialize Gameball Customer Widget
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • iOS
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Push Notifications
      • Track Referrals
      • Go-Live Checklist
    • Android
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Push Notifications
      • Go-Live Checklist
    • React Native
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
      • Go-Live Checklist
    • Flutter
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • Generic Mobile App
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
  • REST API
    • Overview
      • What's New in V4.0
      • Authentication
      • Rate Limiting
      • Status and Error Codes
    • Customers
      • Customer Management
      • Customer Progress
      • Customer Tags
      • Customer Notifications
    • Events
    • Order
      • Order Tracking
      • Order Rewards & History
    • Payment
      • Payment Tracking
    • Transactions
      • Cashback & Redemptions
      • Hold Management
      • Transaction Management
      • Transaction Validation
    • Coupons
    • Configurations
      • Reward Configurations
      • Program Configurations
      • Widget Configuration
    • Leaderboard
    • Batches
      • Batch Creation
      • Batch Management
  • Webhooks
    • Overview
    • Subscribing to Webhooks
    • Webhook Topics
      • Customer's Notifications
      • Customer's Profile Updates
  • Tutorials
    • Tracking Customer Events
    • Redemption Integration
      • Direct debit redemption
      • Coupons Redemption
        • Use Your Own Couponing Engine
        • Gameball Couponing Engine
    • Checkout Integration
    • Build Custom UI Elements
      • Reward Campaigns
      • VIP Tiers
      • Customer Balance
      • Widget Configurations
      • Coupons Customer Experience
      • Customer Notifications
      • Customer Leaderboard
    • Build your Own Notification System
    • Channel Merging Guide
    • Previewing Potential Points Before Purchase
    • Refund
    • Retail & POS Integration with Gameball Loyalty Program
    • Referrals
    • Widget Deep Links
    • Batch APIs usage example
  • Branch.io Integration
  • Adjust Integration
Powered by GitBook
On this page
  • GET - Widget Configurations
  • Response
  1. REST API
  2. Configurations

Widget Configuration

Retrieve configuration details such as the main colors and styling for the Gameball widget. This API provides the necessary settings to display a widget that aligns with your program’s branding.

PreviousProgram ConfigurationsNextLeaderboard

Last updated 6 months ago

Available APIs


GET - Widget Configurations

https://api.gameball.co/api/v4/integrations/configurations/widget

This API call retrieves the current widget settings for Gameball, including whether specific features like redemption, cashback, and notifications are enabled.

Security: Requires apiKey header

Response

application/json

gameballEnabled Indicates if the Gameball widget is enabled on the website or platform.


redemptionEnabled Indicates whether the redemption feature is enabled for customers, allowing them to redeem points as discounts or offers. Example: If true, customers can use their accumulated points to receive discounts or rewards through redemption.


cashbackEnabled Indicates whether the cashback program is enabled, allowing customers to earn cashback on their purchases. Example: If true, customers can receive a percentage of their purchase amount as cashback that can be used for future transactions.


visitorProfileEnabled Indicates if the widget is visible to guest customers (unregistered visitors). Example: If true, the widget is displayed to visitors even if they are not signed in, showing limited features such as how to join the loyalty program.


userProfileEnabled Indicates if the widget is visible to signed-up customers (registered users). Example: If true, signed-in users will see their profile within the widget, including their points balance, rewards, and progress.


leaderboardEnabled Indicates whether the leaderboard feature is enabled, allowing customers to see rankings and competition stats. Example: If true, customers can view how they rank against others in terms of points, transactions, or other competitive criteria.


notificationsEnabled Indicates if notifications are enabled in the widget to notify users about their points, rewards, or other updates. Example: If true, customers will receive notifications for actions like points earned, points expiry reminder, or campaigns achievement.


currency The currency used in the widget, such as "USD" (Dollars).


programName The name of the loyalty program as displayed on the widget.


rankPointsName The label used for score displayed on the widget.


walletPointsName The label used for wallet points displayed on the widget.


botMainColor The primary color of the widget, represented in hexadecimal format (e.g., #E7633F).


Sample Response

{  
  "gameballEnabled": true,
  "redemptionEnabled": true,
  "cashbackEnabled": true,
  "visitorProfileEnabled": true,
  "userProfileEnabled": true,
  "leaderboardEnabled": true,
  "notificationsEnabled": true,
  "currency": "EGP",
  "programName": "Loyalty Program",
  "rankPointsName": "Score",
  "walletPointsName": "Points",
  "botMainColor": "#E7633F"
}

Get Widget Configurations