Redemptions 2.0 - Discount Basket Locking

Overview

In a Redemptions 2.0 implementation with Punchh, discount basket locking is required to allow vendors to maintain control of the discount basket while processing transactions.

Discount basket locking prevents multiple ordering channels (e.g., POS/in-store vs. mobile app) from simultaneously accessing the discount basket during transaction processing.
Discount basket locking prevents errors due to discount basket modification during processing, ensuring that the discount logic is handled correctly.

Data Flows With Discount Basket Locking

When the discount basket is in a locked state, the channel on which the order was originated (e.g., at POS) maintains the ability to edit all contents of the order. However, no other channel (e.g., web or mobile app if the order originated at POS) can edit any contents of the order while the discount basket is in the locked state.

Order modification is not allowed with locking once the discount basket is locked at check-out. However, the discount basket can be unlocked to modify the order if the user goes back to previous steps in the ordering flow.

Online Ordering Flows With Discount Basket Locking

Flows for Online Ordering include both web and mobile app.

For more information about API endpoints and their use cases, see:

Data Sequence Diagram - Online Ordering With Discount Basket Locking

Online Ordering Flow With Discount Basket Locking

Order Placement Flow - Web With Discount Basket Locking

web-flow-recommended-redemptions-2-0-basket-locking.png

Order Placement Flow - Mobile App With Discount Basket Locking

mobile-flow-recommended-redemptions-2-0-basket-locking.png

POS Flows With Discount Basket Locking

For more information about API endpoints and their use cases, see:

Data Sequence Diagram - POS With Discount Basket Locking

Point-of-Sale Flow With Discount Basket Locking

Order Placement Flow - POS With Discount Basket Locking

pos-flow-recommended-redemptions-2-0-basket-locking.png

Using API Endpoints to Lock the Discount Basket

For more information, see the following Redemptions 2.0 API endpoints:

Using API Endpoints to Unlock the Discount Basket

For more information, see the following Redemptions 2.0 API endpoints:

Optional API Endpoints to Modify a Locked Discount Basket

For more information, see the following Redemptions 2.0 API endpoints:

NOTE - Mobile APIs cannot be used to manipulate a locked discount basket.

Data Flows Without Discount Basket Locking

IMPORTANT - Punchh does not certify implementations of Redemptions 2.0 that do not include discount basket locking. Without usage of discount basket locking, multiple ordering channels (POS, mobile app, web, kiosk, etc.) can access and edit the discount basket simultaneously during an order, enabling exploited usage of offers where an offer can be committed to an order by one channel while being removed from the discount basket by another channel, resulting in the offer applying a discount but not being removed from a guest's loyalty account when the order is processed. If discount basket locking is omitted, this exploit can be prevented via proper management of how multiple ordering channels interact when simultaneously editing an open order.