Versions Compared

Old Version 1

changes.mady.by.user Andros Papageorgiou

Saved on

compared with

New Version Current

changes.mady.by.user Joseph Ioannou (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Image Added

Introduction

This document aims to provide a general overview of how SKU based purchases can be submitted over to myLoyalty via JCC terminals. By the end of this guide, merchants will gain a solid understanding on how to setup products on their POS and myLoyalty platform in order to support such flow.

Product Configuration

Merchants that want to support SKU based purchases through myLoyalty need to create a list of product categories and include under such categories only the products that they decided to provide cashback to their buyers.

Each product category on the merchant platform behaves as a master product and has its unique code. All product categories created in the merchant’s platform should be created as well in myLoyalty platform as products, having as product SKU the product category’s code.

Product

Product SKU

Amount

Product Category

Product Category Code

1

Coca Cola

010

€2.00

Soda

000010

2

Pepsi

011

€2.50

Soda

000010

3

Sparkling Water

012

€1.50

Water

000011

4

Chocolate Bar

101

€1.50

Candy

000012

5

Vanilla Bar

102

€1.25

Candy

000012

SKU Based Purchases

Image Added

STEP 1

On checkout, the front-end system agent submits the itemized purchase transaction to JCC (gateway) via the JCC terminal.

During the process of submitting such purchase to JCC, the front-end system (ECR)

  • retrieves all the purchased products,

  • identifies the agreed product category of each product,

  • calculates the total amount of all products under the same product category (quantity is always set to one) and

  • creates a sequence of characters with such information

SEQUENCE OF CHARACTERS FORMAT

<sequence length, 3 digits><Product Category Code>|<Quantity>|<Total Amount>|<Product Category Code>|<Quantity>|<Total Amount>…

Note: The maximum supported sequence length is 250 that corresponds approximately to 10-15 different product categories (may vary based on the agreed length of product category code and total amount)

Info

Example

(based on previously defined product categories)

  • contact purchases 2 pepsi (€2.50 each), 1 coca cola (€2.00) and 5 chocolate bars (€1.50 each)

  • the front-end system (ECR) should

    • group these products under their respective category and calculate their total amounts

      • sodas of quantity 1 and total amount €7.00

      • candy of quantity 1 and total amount €7.50

    • create the agreed sequence of characters

<length><Category>|<Quantity>|<Total Amount>|<Category>|<Quantity>|<Total Amount> will be

<027><000010>|<1>|<7.00>|<000012>|<1>|<7.50> and then 027000010|1|7.00|000012|1|7.50

STEP 2

On receiving a purchase from a terminal. JCC (gateway) parses the sequence of characters and identifies each product category with their respective information (quantity and total amount) and submits a purchase over to myLoyalty platform.

STEP 3

myLoyalty awards and processes any (automatic) spends real-time based on the provided purchased products and notifies the contact.

In the event where any spends were made,myLoyalty will return such amount of money back to the contact’s preferred payment method (e.g. credit card).

Table of Contents
minLevel1
maxLevel7