Overview
The Scan in Store page holds two advanced mobile app features - Scan to Pay and Scan for Rewards, currently exclusive to restaurant partners using Toast POS. They let registered users earn points, redeem rewards, and pay for in-store orders directly from the Lunchbox mobile app using QR codes, without handling cash or cards at the counter. Additionally, we can track loyalty progress, nested below Loyalty wallet, and have quick access to the Rewards page.
💡 In LB 2.0, these are two separate features with two separate QR codes: one is for rewards, one is for payment. Each serves a distinct purpose and cannot be used interchangeably.
Prerequisites
Before using either feature, the following must be in place:
Scan for Rewards and Scan to Pay must be enabled in the Admin Dashboard:
Display Scan for Loyalty: This setting controls whether Scan for Rewards appears in the app. Before activating, ensure the loyalty system is configured. This feature is currently only supported with Toast POS.
Display Scan to Pay: This setting controls whether Scan to Pay appears in the app. Before activating, ensure in-store loyalty is configured for the given POS.
If both are enabled, both options appear. If only one is configured, only that option is visible to the user.
The user must have a registered account with a restaurant partner that has Scan to Pay and/or Scan for Rewards enabled.
The user must be signed in to their account in the mobile app.
To use Scan to Pay, the user must have at least one payment method saved to their account.
Limitations
Scan for Rewards and Scan to Pay are only available for Toast POS partners.
These features do not work with the Toast Payment Processor.
Tipping is not supported when paying exclusively with a Gift Card via Scan to Pay.
Scan to Pay applies loyalty credits automatically, but does not apply item-level loyalty rewards. The rewards can be redeemed by cashier after scanning the Scan for Rewards QR code.
Loyalty points are not refunded on voided or refunded orders. The payment is returned, but the points are not
Orders paid with the Scan to Pay don't automatically close on Lunchbox. Scan to Pay in orders that hit Lunchbox will display a penny difference when the order first hits Lunchbox. It will then get removed and reconciled 2 minutes after the order.
Toast In-Store Loyalty on Toast Kiosks only works with the QR Code. It does not work with Phone Number lookup.
Currently, Loyalty transaction scans are unavailable as part of the re-ordering function. The reorder feature is designed to offer a quick option for orders that have been placed on the online ordering platform. Scan for Rewards transactions occur in-store, where the online menu can often differ from the dine-in menu in many instances. To support a varying menu structure while also having the ability to track the loyalty logic in-store, we tie our Scan for Rewards configuration to an 'open item.' This approach allows us to track a customer's loyalty points/redemptions in-store and support both dine-in and online menus effectively.
Do not use in-store loyalty lookup (manually entering the customer's phone or email using the POS) and Scan to pay/Tender in the same transaction. Using both scan functions in the same transaction will result in double points accrual.
Paying using Scan to Pay with a Service Charge is NOT supported.
Scan to Pay does NOT auto-apply any item-level loyalty reward. Only the customer's credits will be applied, and these are removed automatically.
If only the Scan for Rewards QR code is scanned, the user can earn points and redeem rewards but will not be able to complete payment through the app.
Scan in Store: Scan for Rewards and Scan to Pay
| Upon accessing the Scan In Store page, the user is invited to use the Scan to Pay and Scan for Rewards features and view their loyalty progress.
The info button at the top right corner holds information about the page functionality and how to use both features. |
Scan to Pay
Scan to Pay allows users to pay for an in-store order using a saved credit card or gift card directly from the app.
Once the payment card is saved under Account> Payment Methods, the user is going to be able to use the Scan to Pay feature. |
|
Scan to Pay User Experience
Here's a breakdown of all the steps required to use Scan to Pay for in-store orders.
Step 1: The starting point is in the POS, after the order has been submitted, and it needs to be paid. The server must click on the payment screen and select the Lunchbox Scan to Pay/Payment Type.
Toast Go View: The Server must navigate to the Other payment type and select Lunchbox Payments
| Step 2: The POS will now open the camera to scan the QR Code from the mobile app. The user can now go to the app and pull up the Scan to Pay QR code in the Scan section.
|
Step 3: The user can scan the QR code on the POS to tender their payment with the card on file
| Step 4: Then, if the payment is successful, we will see the payment applied to the order in the POS
|
Payment and Order processing
If the user has loyalty credits, then when using Scan to Pay, it will use the available credits before using the credit card associated with the account. When Scan to Pay is selected, the modal pops up displaying the unique QR code that will associate the order on the terminal with the user's account. |
|
Orders paid using Scan to Pay will appear in Lunchbox with the Payment Status: Partially Paid for up to two minutes. This brief delay allows the order to remain open for any additional charges, such as tips. After two minutes, the order automatically reconciles and the status is updated.
Scan for Rewards
When scanning a Scan for Rewards QR code at the register in-store, the user links their loyalty account with the current order at the terminal. The POS recognizes it as an identity scan, not a tender scan. It fetches the user's loyalty profile (points balance, available rewards, credit-based rewards) into the current transaction. No payment tokenization is included. It allows staff to apply eligible rewards, coupons, or loyalty credits, and accrues points for the transaction.
On the Scan in Store page we see the Loyalty Wallet holding the information about available rewards and credits, as well as the Scan for Rewards access button. Upon selecting the button, user is presented with the QR code which they scan at the register, prior to putting the order in or after, but always before making a payment. |
|
Scan for Rewards User Experience
Here's a breakdown of the steps required to use the Scan for Rewards (formerly Scan for Loyalty) feature for in-store orders.
Step 1: In the Toast POS, navigate to the menu and select the Rewards tab. There, find and select Lookup Customer
| Step 2: A reward modal will pop up, select the Scan button
|
Step 3: In the mobile app, the registered user must present the Scan for Rewards QR code in the Scan in Store Page
|
Step 4: After selecting the Scan button on the POS, the camera will open, allowing the user to scan the Scan for Rewards QR code displayed in the app.
|
Step 5: Once the scan is complete, the user profile will appear on the POS. If the user has available rewards, they can be redeemed at this stage, or the staff can select Next to proceed and accrue points for the order.
|
Step 6: Once the user is associated with the order, the staff will be able to see the user's information on the header of the ordering screen.
|
Using Both Features Together
When a restaurant partner has both features enabled, the order of action is:
Scan for Rewards first (to link the loyalty account and apply rewards)
Scan to Pay second (to complete payment).
Both scans must be done separately. The Scan for Rewards QR code cannot be used for payment. The Scan to Pay QR code cannot be used for loyalty lookup.
💡 INVALID ACCOUNT ERROR happens for various reasons on the POS. The most common reason is when there is no guest record in the system, OR their menu configuration has a disabled item that Lunchbox does not recognize to apply the reward to. (Example: The restaurant allows substitution modifiers in the POS but NOT when ordering via Lunchbox platforms)
Rewards Progress
The Rewards Progress section appears at the bottom of the Scan in Store page. It gives users a real-time snapshot of their loyalty status, including:
|
|

















