Previous Topic	Next Topic
POS Module 5: Show Offers and Rewards After Look-up	POS Module 7: Check-in

POS API Certification Tutorial - Module 6: Redemptions Overview

When implementing redemptions for your business, you need to determine whether to use Redemptions 1.0 (legacy Punchh redemptions framework) or Redemptions 2.0 (new Punchh redemptions framework). Any new integration work involving redemptions should use Redemptions 2.0 unless there is a dependency integration (such as an existing POS integration) that does not currently support Redemptions 2.0. If such a dependency exists, you should use Redemptions 1.0.

Redemptions 2.0 enables several Punchh features, such as multiple redemptions, single-scan flow, auto-redemption, proportional discounting, stacked discounting, item qualifier recycling, and enhanced flexibility to redemption processing orders. The key differentiator with Redemptions 2.0 is support for multiple redemptions, enabling guests to apply multiple discounts on a single transaction. This enhanced flexibility for businesses to design and implement unique discounting structures provides guests with greater savings and a more personalized redemption journey.

The Redemptions 2.0 APIs use the concept of a discount basket, which is a persisted object for selecting available rewards to redeem in the next transaction. The Redemptions 2.0 API that enables “batched” processing of redemptions is used for determining possible redemptions and for processing multiple redemptions based on the items in the discount basket.

The following tables list the tutorial modules for Redemptions 2.0 (new) and Redemptions 1.0 (legacy).

Note: The Redemptions 2.0 protocol is not backward compatible with the existing Redemptions 1.0 endpoints. Configurations within the Punchh platform are required, so please contact your Punchh representative for help before starting development.

Redemptions 2.0 API (New) Tutorial Modules - Sequence and Goals

Tutorial Modules - Redemptions 2.0	Goal
Module 6a: Find a User (Redemptions 2.0)	Look up a guest account.
Module 6b: Process an Auto-Redemption (Redemptions 2.0)	Add a discount to the discount basket automatically.
Module 6c: Look up Discounts (Redemptions 2.0)	Look up a guest's available discount(s) in the loyalty account.
Module 6d: Manage Items in the Discount Basket (Redemptions 2.0)	Add items to or remove items from a guest’s discount basket.
Module 6e: Process/Create a Batch Redemption (Redemptions 2.0)	Process a batch redemption with the appropriate discount type(s).
Module 6f: Void the Discount Basket (Redemptions 2.0)	Void the complete discount basket.

Redemptions 1.0 API (Legacy) Tutorial Modules - Sequence and Goals

Tutorial Modules - Redemptions 1.0	Goal
Module 6a: Show Applicable Offers (Redemptions 1.0)	Display available offers based on current check details.
Module 6b: Process/Create Redemption (Redemptions 1.0)	Process redemptions with the appropriate reward type.
Module 6c: Voiding Redemptions (Redemptions 1.0)	Void processed redemptions.