Skip to main content
This guide walks you through integrating Gameball’s loyalty program with your point-of-sale (POS) system using REST APIs, so you can deliver a consistent, rewarding experience to your in-store shoppers without a mobile app or separate interface.
Whether you’re operating in retail chains, mall kiosks, or standalone stores, Gameball’s REST APIs plug loyalty directly into your existing POS workflow, no third-party apps or extra overhead.

​
What You Can Do

  • Identify customers by registering new ones or recognizing existing ones at checkout
  • Display loyalty balance so customers see their points and what they’re worth
  • Reward purchases with points and campaigns in real time
  • Redeem points for discounts at checkout, securely and quickly
  • Refund orders and automatically restore the customer’s points
  • Track events and referrals for additional engagement (optional)

​
The End-to-End Checkout Flow

Most POS integrations follow the same sequence at checkout. This is the path the core guide pages walk through, in order:

​
Integration Guide

Getting Started & API Setup

Requirements, credentials, environments, and choosing your customer ID

Identify the Customer

Get or create customers at checkout

Show Customer Balance

Retrieve and display customer loyalty balance

Track Orders & Earn Points

Submit in-store orders to award loyalty points

Redeem Points at Checkout

Let customers apply points as a discount

Refund Order

Refund or cancel orders and restore customer points

Fetch Order Details

Retrieve order transaction history and customer activities

Track Events

Track customer events and actions at your POS

Track Referrals

Implement referral tracking and rewards

Go-Live Checklist

Verify your integration before going live

​
Requirements

  • POS System: Must support API integration (REST API calls)
  • Network: Internet connectivity for API calls
  • Authentication: Gameball API key and secret
  • QR Scanner (Optional): For QR code-based customer verification

​
How POS Integration Differs from Mobile SDKs

Unlike mobile SDKs, POS integration:
  • Uses REST APIs instead of native SDKs
  • Requires server-side API calls from your POS backend
  • Focuses on checkout workflows rather than app experiences
  • Supports QR code verification for customer identification
  • Enables real-time point redemption during checkout