K42 Documentation

Appearance

Loyalty Programs ​

What Are Loyalty Programs? ​

Loyalty programs are stamp-card-style reward schemes. A member enrolls in a program and collects "stamps" by making qualifying purchases at the target merchant. Once they reach the program's threshold, they earn a reward (a free item via refund, or a fixed cashback amount). The counter then resets and they can begin earning again.

How It Works ​

Program Configuration ​

Loyalty programs are configured by advertisers on the K42 Platform and synced to the Publisher software automatically. Key properties include:

  • Target brand and items - which brand and optionally which specific items count as qualifying purchases
  • Qualifying threshold - how many stamps are needed to earn a reward (e.g. "Buy 5, get 1 free")
  • Reward type - either a refund (the qualifying purchase amount is returned) or a fixed cashback amount
  • Display content - title, description, imagery, terms and conditions for the program
  • Duration - how long the program runs

The publisher does not configure loyalty programs - they are delivered and managed by the Platform.

User Experience ​

From the end-user's perspective:

  1. Discovery - The member sees available loyalty programs in your app. Each program shows its creative content: the brand, the threshold ("Buy 5, get 1 free"), and the reward.

  2. Enrollment - The member taps "Join" to enroll. A stamp collection is created, starting at zero.

  3. Progress - As the member makes qualifying purchases at the target brand, stamps accumulate. Your app shows their progress (e.g. "3 of 5 stamps collected").

  4. Redemption - When the threshold is met, the reward is triggered automatically. The member receives a notification that they've earned their reward. The stamp counter resets and they can begin collecting again.

  5. Ongoing - The cycle repeats. Members can stay enrolled indefinitely and earn multiple rewards over time.

Publisher Responsibilities ​

As a publisher, your role in the loyalty programs product is:

  • Display available programs - List loyalty programs and render their creative content (title, image, description, reward info, terms).
  • Implement enrollment - When a member taps "Join", create a stamp collection. Show confirmation and initial progress state.
  • Show stamp progress - Query the stamp collection to display current progress (e.g. a visual stamp card with filled/empty slots).
  • Ingest transactions - Feed card transaction data into the Publisher software so qualifying purchases can be detected.
  • Handle qualifying purchase webhooks - When a stamp is earned, the Platform delivers a qualifying_purchase.created event. Use this to update the member's progress UI and optionally notify them.
  • Handle reward webhooks - When the threshold is met and a reward is triggered, the Platform delivers a cashback.created event with a source of "loyalty-program-redemption". Notify the member and track the reward in your own systems.

For API implementation details, see: