Punchh Platform Release Notes - 28 May 2025 Deployment

The updates described in these release notes and the affected/linked documentation will not be available in the Punchh platform until the target deployment date.

Campaigns

Campaign Split Testing

Split testing is now available for mass offer campaigns using redeemable! (CAM-5795, PDOC-3063)

• Supports all channel marketing (Email, text, push, rich)
• Includes a control group feature
• Updates to campaign home page and side panels
• Campaign performance comparison of all KPI's and channel marketing
• Supports integration with other channel marketing software via campaign ID
• Supports existing data export functionality

See the following article(s) for more details:

• Campaign Split Testing (Support Portal)

Consumer Experience

Password Reset Confirmation

The Password Reset Confirmation landing page has been updated to include a sign-up and login button for users to take the next steps after resetting their password. This page is now also available to update using CSS. (CX-2699) 

Segments

Updated Smart Segment Templates

To improve usability and make the feature’s purpose more immediately clear to users, the customization button in Smart Segment templates has been renamed from Customize Segment to Build from This. This change helps better communicate that users can tailor the segment to their specific marketing needs by starting from a pre-defined template. (SB-3490, PDOC-3023)

See the following article(s) for more details:

• Smart Segments (Support Portal)

Reporting and Analytics

Changes to the Redemption Data Export

As previously announced on March 13, we are making some enhancements to our Redemption Data Export field labels for improved clarity and alignment with receipt terminology:

• The original Discount Amount field will be removed.
• The Amount field will be called Discount Amount.
• The Receipt Payable field will be called Amount.

Please note, the removal of a column will shift the remaining columns to the left in the CSV export file. To ensure a smooth transition, you will need to adjust your data-ingestion processes accordingly. (DP1-1584, PDOC-2925)

See the following article(s) for more details:

• Database Schema and Data Field Change Announcements (Support Portal)
• Data Export (Support Portal)

Database Schema - New Columns

A new column 'additional_details' has been added to the 'accounts' table. (LPE-1164, PDOC-3052) 

See the following article(s) for more details:

• Database Schema and Data Field Change Announcements (Support Portal)

Developers Corner

Redemptions 2.0 Discount Basket Locking

If reward locking is enabled for a business on multiple redemptions:

• The business can select the functionality of auto-unlocking the order after the lock is applied. This auto-unlock period, which previously had a default timing of minimum 10 minutes, is now configurable, allowing the business to set this to a minimum of 1 minute. (OMM-1257)
• In the ordering journey, a lock on the discount basket will be applied at the check-out stage using the Discount Look-up API or the Batch Redemption Process API with query = true, instead of at the offer-selection stage. This will allow the guest to modify the order until the check-out stage from any channel (transaction-initiated channel or other channel), thus improving the guest ordering experience. The external_uid parameter will be made optional for the Select, Unselect, Active, and Auto-select APIs; therefore, even if an external_uid is sent no lock will be applied on the discount basket. (OMM-1256, PDOC-3065, PDOC-3057)
• The POS and Online Ordering Redemption 2.0 APIs will return the locked parameter in the response for Select, Unselect, Active, and Auto-select to indicate if the basket is in a locked state or not. Integrations can use this information for customizing the guest experience.  (OMM-1239, PDOC-3054)
• A lock on the discount basket is applied from the transaction-initiated channel. If a simultaneous transaction is initiated from another channel, then the error message returned in this scenario is updated to make it more informative, indicating the reason for the locked state with error code 422.
  Previous error message: "Unable to find valid discount basket"
  Updated error message: " Unable to access the user’s Discount Basket, the Basket is currently locked." 
  The error message has been updated for Redemptions 2.0 APIs across POS (Select, Unselect, Active, Auto-select, Look-up, Batch Redemption Process), Online Ordering (Select, Unselect, Active, Auto-select, Batch Redemption Process), and Mobile (Select, Unselect, Active). (OMM-1237, PDOC-3064)

See the following article(s) for more details:

• POS - Redemptions 2.0 (Developer Portal)
• Online Ordering - Redemptions 2.0 (Developer Portal)
• Mobile - Redemptions 2.0 (Developer Portal)
• Redemptions 2.0 - Discount Basket Locking (Developer Portal)