Secret Menus

A secret menu is a menu, or a product inside one, that only some customers can see. Brands use it for VIP items, birthday specials or loyalty-tier exclusives: the item exists on the store's menu, but it is hidden from everyone who does not qualify.

How eligibility is decided

Eligibility comes from Punchh segments. A segment is a group of customers defined in Punchh by loyalty data — tier, visit frequency, spend, location and so on. Brand staff attach a segment to a menu or a product in the Management Center, optionally together with a tag such as VIPExclusive, and from then on the item is visible only to customers in that segment.

Secret menus therefore need two things: a brand integrated with Punchh, and a signed-in customer. A guest never sees secret items.

What your app has to do

Less than you might expect. The menu endpoints already apply the rules.

  1. Send the customer's token. Include the Authorization header on Get Categories and the other Menu v2 calls whenever a customer is signed in. The response then includes the secret menus and products that customer qualifies for, and omits the ones they do not. Without the token you get the public menu.

  2. Label unlocked items, if you want to. The menu response does not say why an item is visible. To show a "VIP" or "members only" badge, read the tags with Get Secret Identifier Tags for products, or Get Secret Identifier Tags for Menus for whole menus. Both return the tags that apply to this customer, keyed by product or menu id.

Call the tag endpoints after the category list or menu list. The segments a customer matched are worked out while that list is built and cached from there; called on their own, the tag endpoints return an empty array.

Eligibility can change

A customer can fall out of a segment — a tier expires, a birthday passes. Get Customer Favorite Items already handles this for saved favorites: items the customer is no longer eligible to see are left out rather than returned with an error. For anything you cache on your side, treat the menu response as the source of truth and re-read it when the customer signs in.