Skip to main content

​
Gameball Web Integration

This documentation provides a comprehensive guide to integrating Gameball’s loyalty program with your website or web application. Unlike mobile SDKs, web integration uses REST APIs and an optional JavaScript widget to deliver a seamless loyalty experience to your online customers.
Gameball’s web integration is designed for websites and web applications. It combines REST API calls for server-side operations with an optional JavaScript widget for customer-facing features.

​
Integration Overview

By integrating Gameball with your web platform, you can:
  • Display the Gameball widget to show customers their loyalty profile, points, and achievements
  • Track customer events and behaviors to trigger rewards and campaigns
  • Process orders and award cashback points automatically
  • Enable point redemption for discounts and rewards
  • Track referrals to grow your customer base organically

​
Integration Guide

Getting Started

Learn about web integration requirements and setup

Initialize Widget

Integrate the Gameball customer widget into your website

Customer Management

Create and manage customer profiles via API

Track Events

Send customer events to trigger rewards and campaigns

Track Orders

Process orders and award cashback points

Integrate Redemption

Enable customers to redeem points for discounts

Track Referrals

Implement referral tracking and rewards

Go-Live Checklist

Verify your integration before going live

​
Requirements

  • Web Platform: Website or web application with server-side capabilities
  • API Access: Ability to make REST API calls from your backend
  • JavaScript Support: For widget integration (optional)
  • Authentication: Gameball API key and transaction key
  • HTTPS: Secure connection for API calls

​
Key Differences from Mobile SDKs

Unlike mobile SDKs, web integration:
  • Uses REST APIs instead of native SDKs
  • Requires server-side API calls for security (API keys should never be exposed client-side)
  • Includes an optional JavaScript widget for customer-facing features
  • Supports both guest and authenticated customer views