> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Web SDK Integration (v4)

> Complete guide to integrate Gameball with your website or web application using REST APIs and the Gameball widget

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.

> [!NOTE]
>
> 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

> [card] [Getting Started](https://docs.gameball.co/installation-guides/v4/web/getting-started.md)
>
> Learn about web integration requirements and setup

> [card] [Initialize Widget](https://docs.gameball.co/installation-guides/v4/web/initialize-widget.md)
>
> Integrate the Gameball customer widget into your website

> [card] [Customer Management](https://docs.gameball.co/installation-guides/v4/web/customer-management.md)
>
> Create and manage customer profiles via API

> [card] [Track Events](https://docs.gameball.co/installation-guides/v4/web/track-events.md)
>
> Send customer events to trigger rewards and campaigns

> [card] [Track Orders](https://docs.gameball.co/installation-guides/v4/web/track-orders.md)
>
> Process orders and award cashback points

> [card] [Integrate Redemption](https://docs.gameball.co/installation-guides/v4/web/integrate-redemption.md)
>
> Enable customers to redeem points for discounts

> [card] [Track Referrals](https://docs.gameball.co/installation-guides/v4/web/track-referrals.md)
>
> Implement referral tracking and rewards

> [card] [Go-Live Checklist](https://docs.gameball.co/installation-guides/v4/web/go-live-checklist.md)
>
> 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.