Add to Card API

Add to Card API

Koupon Media’s Add to Card Loyalty Solution enables a retailer launch a loyalty-linked offer program. In Koupon’s solution, offers are viewed in a mobile app or mobile web experience, added by the customer to their loyalty account, and redeemed by scanning a loyalty barcode at the register. This article explains how a retailer can use the Koupon Platform to implement this functionality.

Generating a Loyalty Barcode for a Customer

Offer Content

    1. Consumer downloads the loyalty application from their devices app store.
    2. Consumer enters in their registration information, such as email, password, date of birth, etc.
    3. This information is sent to the Loyalty CRM managed by the Retailer.
    4. The loyalty CRM stores all of the consumer registration information and generates a unique customer loyalty ID, which is then sent back to the mobile application.
    5. The loyalty CRM then creates a consumer_identity using the create consumer API located here.
    6. Once a consumer_identity has been created, the Loyalty CRM uses the consumer_identity and loyalty value to register the barcode to the consumer using the following API.
POSThttp://storeconnect.kouponmedia.com/v2/consumer_identity/loyalty/loyalty_id

Example Response


{
  "code": 200,
  "message": "success",
  "version": "1",
}

Displaying a Customer’s Available Offers

Offer Content

    1. Retrieving all offers for a consumer involves making a call to our Consumer GET Offers API which returns back with all offers that have not expired or been used. NOTE: Ellipses (…) have been used to omit attributes of the offers that are not necessary for loyalty integration.
GEThttp://consumer.kouponmedia.com/v2/consumer_identity/offers

Example Response


{
  "code": 200,
  "message": "success",
  "version": "2",
  "Offers": [
    {
      ...
      "offerId": 87853,
      "loyaltyCard":{
         "discount_code": "23423235434324", 
         "added": true
        }
      ...
    },
    {
      ...
      "offerId": 13434,
      "loyaltyCard":{
         "discount_code": "23423235434324", 
         "added": true
        }
      ...
    },
  ]
}
  1. The response from the Consumer GET Offers API contains an array of offer objects, each of which have a state and offerStyle associated with them. The application will display “Offer Added” text on the offer if the state is added. Any other offer state the application will display an active Add To Card button which will inform the consumer that this offer can be linked to their loyalty account.

Adding Offers to a Customer’s Loyalty Card

Offer Content

    1. The consumer now has a list of offers, all of which have not been added. The consumer must then be able to select Add To Card on each offer to show their intention of redeeming this offer in store.
    2. The consumer taking an action of adding an offer translates to updating the state of that offer to added. This will allow the POS to recognize this offer and will also update the state of the offer on the Consumer Get Offers call so that the next time this consumer opens up their application, they will not have the ability to add the offer again.
POSThttp://consumer.kouponmedia.com/v2/<consumer_identity>/offers/loyalty/<offerId>

Example Response


{
  "version": "2",
  "state": "added",
  "code": 200,
  "message": "success"
}

Retrieving Added Offers at the POS

To learn more about integrating Koupon Media’s Add to Card solution with your Point-of-Sale, please visit our Store Connect page.