Apply a Punchh loyalty reward redemption to a POS transaction

Steps

1. After identifying the guest via user look-up and completing check-in, call the Possible Redemptions API to retrieve the list of active offers and rewards available to the user for the current order.
2. Present available redemptions to the cashier or surface them in a self-service flow; the guest selects the reward they wish to apply.
3. Call the Create Redemption API with the selected offer ID and current order details; Punchh validates the redemption against the order and returns the discount amount to apply.
4. Apply the discount to the POS order and confirm the transaction; then call the Finalize or Settle redemption endpoint to commit the redemption so it cannot be reused.
5. If the transaction is voided, call the corresponding redemption void or cancel API to return the reward to the guest's account.
6. Log the redemption ID and order reference for reconciliation and dispute resolution.