What's New in V3.0
Breaking Changes
Holding points
Holding points before redeem is now optional.
Transactions API will be flexible to accept redeeming points with or without a hold reference. This will allow integrators to pick the best integration sequence that fits their system flow.
Removed Hashing
Hashing is no longer required for sensitive APIs like transactions & customer's information. Gameball now uses two keys for authentication:
Web Key (Public Key) : used for non sensitive APIs and initialization of Widget
Secret\transactions Key: used to authenticate sensitive API calls.
New Features
New batch interfaces 👑
New batch interface is created to allow GURU clients to execute batches via API. The batch interfaces will support batches for:
Reward
Redeem
Manual Transaction
Balance Retrieval
New Endpoints
Order API Endpoint
New Orders API is created to support e-commerce clients to track their orders. This API supports sending an event for placing the order, reward for paid amount and redeem point. It also accepts guest orders for analytical purposes
Mark Notifications API Endpoint
New notifications API endpoint is introduced that enables systems to mark notifications as read.
Updated Endpoints
Removed Referral API
Referrer code can be sent within the create customer API without the need of the old API dedicated for the referral case.
Custom UI APIs for GURU Clients
New APIs are now available and updated to better suit different businesses, also specially designed for our GURU clients to support them in building their custom UIs. There APIs are as follows:
New Mobile SDKs Versions
We have released new versions of our mobile SDKs to leverage the power of the new V3 APIs. These upgraded SDK versions incorporate the latest best practices, resulting in accelerated performance and seamless functionality for your mobile apps.
The following list provides more details about the new SDKs
| Platform | Package Name | Min. version supporting V3 |
|---|---|---|
iOS | Gameball | 2.2.0 |
Android | gb-mobile-android | 1.5.1 |
React Native | react-native-gameball | 2.0.26 |
Flutter | gameball_sdk | 1.0.3 |
New API documentation structure
Better API documentation including changes in structure and organization. It also includes new tutorials and walkthrough sections as follows:
Last updated