This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Kiosk workflow

This section describes the user interface workflow for loyalty transactions in Toast Kiosk.

  1. On the Kiosk device, the guest taps the START button.

  2. The guest adds items to their order. For more information, see the Toast Central article about placing an order using Toast Kiosk.


    The guest can add rewards to their order at any point before checkout.

  3. On the bottom right of the screen, the guest taps the + Add rewards button.

  4. On the Loyalty + Rewards screen, the guest can do one of the following:

    • Tap the SCAN CODE button and scan the QR code on a loyalty card or app.

    • Swipe a loyalty card.

    • Swipe the credit card linked to the loyalty account.

    Your integration will receive a LOYALTY_INQUIRE request.

  5. Next to the discount they want to apply, the guest taps Redeem. Offers that are not eligible for redemption on the current check are disabled and the Redeem button is shaded gray.


    Partners are responsible for confirming which offers are eligible for redemption, using the applicable boolean in the Offer object.

    The reward is added to the check as a discount.

  6. The guest continues adding items to their order, or checkout. When the payment process starts, your integration will receive a LOYALTY_REDEEM request. Once the payment is completed, your integration will receive a LOYALTY_ACCRUE request.