Cheetah CES Docs Portal

Corporate Site

Getting Started
At a Glance: Using the Cheetah Loyalty Kits
Using Sample Application
UI Customization
iOS Kit Reference
Swift SDK Reference

Getting Started

The Cheetah Loyalty Digital Kits for iOS is built with dependency management in mind. Cocoapods is therefore a requirement for developers to be able to incorporate the kits into their projects and build loyalty applications in no time.

Setting up Cheetah Loyalty Access

Before creating an app running on top of the Cheetah Loyalty Platform, make sure you have a valid login to the Cheetah Marketing Console.

Then, navigate to the Applications screen in the Cheetah Marketing Console to get your Member API OAuth Client ID and Client Secret.


  • Deployment Target: iOS 11.0
  • Xcode 11.x
  • Swift 5.1



  1. Open a terminal window then add the private podspec repo to the Cocoapods installation by entering the following:
     pod repo add CheetahLoyaltySDK
  2. Add a source for the CheetahLoyaltySDK then add the Cheetah Digital Kits pod in your podfile:

     platform :ios, '11.0'
     source ''
     source ''
     target '<YourApp>' do
       # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
       pod 'CheetahDigitalCore'
       pod 'CheetahDigitalUI'
       pod 'CheetahDigitalChallenges'
       pod 'CheetahDigitalPlaces'
       pod 'CheetahDigitalRewards'
       pod 'CheetahDigitalNotifications'
  3. Open a terminal window to where your project and podfile is located and run the following to install the pod:
     pod install


  1. Download the CheetahDigitalCore SDK from the releases.
  2. Extract it then drag & drop <CheetahDigitalKit>.xcframework to your project’s directory.
  3. In “Frameworks, Libraries, and Embedded Content” section under the “General” tab, click on the “+” button then “Add Other”, and then “Add Files…”.
  4. Select the <CheetahDigitalKit>.xcframework file and make sure that it is set to “Embed & Sign” in the “Embed” column in the “Frameworks, Libraries, and Embedded Content” section under the “General” tab.


Before using the Cheetah Digital Kits, a configuration file is needed to determine the settings it needs upon sending requests. The configuration file is a plist named CheetahDigital-Info. The file is to be included in the project bundle.

The primary contents of this CheetahDigital-Info.plist are as follows:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">

The keys used in the CheetahDigital-Info.plist are:

  • BUSINESS_UNIT - String indicating the business unit.
  • USER_AGENT_NAME - The user agent name to be used in the header of requests.
  • CLIENT_ID - The API KEY for the Loyalty API
  • CLIENT_SECRET - The API SECRET KEY for the Loyalty API
  • CLIENT_URL - The URL of the Loyalty API gateway
  • METRIC - The API metric
  • GEOFENCING_ENABLED - Boolean flag that indicates whether geofencing is enabled
  • ACCESS_TOKEN_EXTERNAL - Boolean flag that indicates whether the access token is from an external source
  • APP_LANGUAGE - String indicating the app language

Some of these values can be found in the console of the environment the app is going to use.

After completing the steps outlined above, you are now ready to make an app using the Cheetah Digital Kits!

Next: At a Glance: Cheetah Loyalty Kits