Obtain POS API credentials from the PAR Punchh developer portal at developers.partech.com and review the Getting Started with POS API Integrations guide
At the time of purchase, prompt the guest for their phone number or loyalty identifier; call the Punchh API to look up the account or enroll a new member if no account exists
Create a check-in for the identified loyalty user by POSTing to the Punchh check-in endpoint, including the purchase details such as total amount, location identifier, and POS transaction reference
Parse the check-in response to retrieve the points awarded and any triggered offers or rewards, then display the updated balance or reward status to the guest on the POS terminal
If the guest has an available redemption offer, present it before finalizing the check and call the Punchh redemption endpoint to apply the discount, then pass the discount amount back to the POS tender screen
Void check-ins and redemptions when a transaction is voided or refunded by calling the corresponding Punchh reversal endpoints to keep the loyalty ledger accurate
Known gotchas
Check-in and redemption are separate API calls; a check-in alone does not apply a discount — a separate redemption call is required if the guest has offers to redeem
Punchh's POS API supports over 45 POS systems but the integration setup and configuration steps differ per POS; consult the POS-specific integration guide in the developer portal
Reversals must reference the original check-in or redemption transaction ID; without the correct reference, the loyalty ledger will show erroneous balances
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp