Punchh Platform Release Notes - 9 January 2024 Deployment
Loyalty
Segments: Most Visited Location
A new attribute is available for the Profile Details segment. Most Visited Location allows you to filter for guests based on their most visited location. This segment can be used to identify guests for their loyalty towards a single location. (SB-2542)
See the following article(s) for more details:
- Segment Types, Attributes, and Timeframe Definitions (Support Portal)
Segment Attribute Organization
The attribute lists for the Profile Details and Checkins segments have been grouped to make it easier for you to find the attribute you need. (SB-2575, SB-2576)

See the following article(s) for more details:
- Segment Types, Attributes, and Timeframe Definitions (Support Portal)
Segment: Checkin at Every Location
We have made updates to the Checkins segment, attribute Checkin at Every Location. You now can choose to filter your segment by Guest Type: Loyalty/eClub or Loyalty only. (SB-2504)
See the following article(s) for more details:
- Segment Types, Attributes, and Timeframe Definitions (Support Portal)
Segments Audit Log
Enhanced logging has been activated for custom file uploads, providing administrators with detailed insights into the upload status (e.g., scheduled, loading, completed, failed with reason for failure). (SB-2682)
Campaigns
Coupon & Promo Campaigns
Coupon campaigns and promo campaigns can now be configured with a start time and end time, in addition to a start date and end date. (CAM-4559)
See the following article(s) for more details:
- Coupon Campaign (Support Portal)
- Promo Campaign (Support Portal)
Reporting & Analytics
Payments Report
You now can receive the Payments Report via email or FTP periodically by creating a schedule under Data Exports. There is no change to the existing Payments Report under the Reports section; it will be available to view and immediately download payment stats. (DP1-1086)
Action Required: If you previously had a schedule created for the Payments Report, you will need to create a new schedule. Navigate to Reports > Data Export and select the Payments Report Data Fields.
See the following article(s) for more details:
- Data Export (Support Portal)
- Payments Report (Support Portal)
Subscriptions
Single Use Subscriptions
We have introduced the ability to create non-renewing/single-use subscription plans. Subscriptions issued with the Single Use setting enabled will not be renewed. This type of plan can be used to issue seasonal passes during holidays, etc., to provide discounts to guests who pay upfront. (LS-417)
Try It Out! Toggle Make this a Single Use Subscription? under Plan Details when making your subscription plan. Note: This cannot be changed after the plan is active.
Search Subscriptions
You can now search for subscription plans by name within the subscription listing section, allowing you to look for any subscription plan easily, especially if there is a large number of subscription plans configured in the business. (LS-457)
See the following article(s) for more details:
- Subscription Plans (Support Portal)
Offers
New Item Exclusion for Receipt Totals
Now, you can exclude specific items from the receipt total when defining minimum purchase thresholds for eligibility of discounts. For example, with "10% off a burger with a minimum purchase of $20” the burger will be excluded from the minimum purchase amount. Within the Item Qualifier section, you can now select Net Amount Excluding Max or Min Priced Item Equal to. (OMM-842)
Try It Out! Take advantage of this new feature by navigating to Qualification Criteria > Item Qualifier > Net Amount Excluding Max/Min Unit Price > = Minimum Purchase Amount & Item to be Excluded. (For example, $20 and a burger.)
See the following article(s) for more details:
- Qualification Criteria (Support Portal)
Developers Corner
Create Loyalty Check-in API
The new POST /api2/dashboard/checkins API endpoint creates a loyalty check-in for an order against a receipt when the user’s access token or authentication token is not available at the time of creating the check-in in the Punchh system, for example, in the case of future dated orders. (INT2-1082)
See the following article(s) for more details:
- Create Loyalty Check-in API (Platform Functions) (Developer Portal)
Create Feedback API
The new POST /api2/dashboard/feedbacks API endpoint creates feedback in the system based on the message and/or rating provided by a user. (INT2-1061)
See the following article(s) for more details:
- Create Feedback API (Platform Functions) (Developer Portal)
Update Feedback API
The new PATCH /api2/dashboard/feedbacks/{feedback_id} API endpoint enables updating feedback in the system based on the message and/or rating provided by a user. (INT2-1062)
See the following article(s) for more details:
- Update Feedback API (Platform Functions) (Developer Portal)
Purchase Subscription API
We have introduced new validations on subscription purchase requests. If a subscription plan is single-use (non-renewing) and a purchase request comes in with auto_renewal = true, then in this case the purchase request not completed throws an error. (LS-416)
See the following article(s) for more details:
- Purchase Subscription API (Mobile) (Developer Portal)
- Purchase Subscription API (Online Ordering) (Developer Portal)
- Purchase Subscription API (Platform Functions) (Developer Portal)
Events Framework
Added new transactional notification webhook events for Gift Card Auto Reload Enabled and Gift Card Auto Reload Disabled. (INT-2027)
See the following article(s) for more details:
- Gift Card Auto Reload Enabled (Developer Portal)
- Gift Card Auto Reload Disabled (Developer Portal)