This page documents the expected user experience when RBI guests are placing orders using the POS. Part of In-Store Loyalty & Offers Customer Journey

Contents

1. Redeem offers

1.1. While signed out

In this scenario, guests do not sign in to the RBI app and they want to use open offers. They scan two different offers in the same order.

Note: this scenario is only available if the market has made open offers available to their guests.

Note: this scenario does not require an integration with the Loyalty API.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens the RBI app without signing in, and selects an offer that is not available when users are signed out (known as a “closed offer”)	N/A	Offer page is displayed:
Guest taps “Use at restaurant”	N/A	Offer is closed so guest is prompted to Sign In
Guest is worried about his privacy and decides not to use this offer. Guest opens an offer that is available when users are signed out (known as an “open offer”) Note: markets that don’t use scanners do not show a QR code in the RBI app, only the alphanumerical code	No action	Guest sees QR code and Offer Static code
Cashier is prompted to add a loyalty code	Cashier asked if guest is a loyalty member: Cashier select “Cancel”, since the guest is not signed in	No action
Guest either scans the (static) offer code, or tells the alphanumerical code to the cashier	If guest does not scan the QR code, cashier can enter the static alphanumerical code Offer is added to the POS basket This offer is incrementally added to the cart and does not replace any of the existing cart items	No action
Guest opens a second offer that is available when users are signed out (known as an “open offer”)	No action	Guest sees QR code and Offer Static code
Guest either scans the (static) offer code, or tells the alphanumerical code to the cashier	If guest does not scan the QR code, cashier can enter the static alphanumerical code Offer is added to the POS basket This offer is incrementally added to the cart and does not replace any of the existing cart items	No action
Cashier finalizes the order and guest pays at POS	POS prints receipt with order information	N/A

1.2. Authenticating with Loyalty Code

In this scenario, guests do not pre-select any offers and instead start their journey by scanning their Loyalty code at the POS. The guest in this scenario does a second scan to add an offer after the initial identification.

Steps	Expected results (POS)	Expected results (RBI app)	Loyalty API usage
Guest opens the Loyalty code page on the RBI app	N/A	Loyalty code page is displayed:	Not applicable
Cashier is prompted to add a loyalty code	Cashier asked if guest is a loyalty member:	No action	Not applicable
Guest either scans the loyalty code, or tells the 6 digit code to the cashier	If guest does not scan the QR code, cashier can enter the 6 digit Loyalty code: Either by scanning or entering the code, POS confirms successful identification:	Guest receives a successful confirmation modal	Not applicable
Guest opens an offer on the RBI app, chooses to redeem in restaurant	No action	Offer is added to the guest’s pre-selection A unique offer code is generated	Not applicable
Guest either scans the offer’s QR code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification: These offer(s) are incrementally added to the cart and do not replace any of the existing cart items	Modal is shown to guest confirming that the offer has been added to cart Loyalty points balance is not updated, since the guest is scanning an offer Offer pre-selection is cleared	Call the Identify endpoint, which will return the Loyalty User ID, loyalty points balance and details about the selected offer
Cashier finalizes the order and guest pays at POS	POS prints receipt with points earned & points balance	Guest sees updated points balance	Not applicable
			Call the Identify endpoint again. It will return the same information as before Add the offer details returned by this endpoint to the guest’s basket
			Call the Transaction Update endpoint with a `status` of `CLAIMED`

1.3. Using offer pre-selection

In this scenario, guests pre-select offers on the RBI app and continue their journey in the POS by scanning the generated code. Then they add more offers to their basket by choosing those offers in the app and scanning them.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens an offer on the RBI app	N/A	Offer page is displayed:
Guest taps “Use at restaurant”	N/A	Offer is added to the guest’s pre-selection A unique offer code is generated
Cashier is prompted whether the Guest has loyalty, and confirms	Cashier asked if guest is a loyalty member and clicks on “Ok”	No action
Guest either scans the offer code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification (since the offer code also identifies the Loyalty user): Offer is added to POS cart	Guest receives a successful confirmation modal Offer pre-selection is cleared
Guest opens a second offer on the RBI app, chooses to redeem in restaurant Note: the flow is exactly the same if the guest pre-selects multiple offers.	No action	Only the second offer is added to the guest’s pre-selection A unique offer code is generated
Guest either scans the offer’s QR code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification: These offer(s) are incrementally added to the cart and do not replace any of the existing cart items	Modal is shown to guest confirming that the offer has been added to cart Loyalty points balance is not updated, since the guest is scanning an offer Offer pre-selection is cleared
Cashier finalizes the order and guest pays at POS	POS prints receipt with points earned & points balance	Guest sees updated points balance

1.4. Limit one offer per purchase

This scenario only happens if the market has decided to limit redemption of one offer per purchase. This is currently the case in BK UK for example.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens an offer on the RBI app	N/A	Offer page is displayed:
Guest taps “Use at restaurant”	N/A	Offer is added to the guest’s pre-selection A unique offer code is generated
Cashier is prompted whether the Guest has loyalty, and confirms	Cashier asked if guest is a loyalty member and clicks on “Ok”	No action
Guest either scans the offer code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification (since the offer code also identifies the Loyalty user): Offer is added to POS cart	Guest receives a successful confirmation modal Offer pre-selection is cleared
Guest opens a second offer on the RBI app, chooses to redeem in restaurant	No action	User will see modal in the app letting user know, use can only add 1 offer per order and prompting user to replace
Guest taps Replace	No action	New offer is added to the guest’s pre-selection and old offer is removed from pre-selection cart
Guest either scans the offer’s QR code, or tells the 6 digit code to the cashier	New offer replaces the previous selected offer in the POS basket Other items in the POS basket are not removed or replaced	Modal is shown to guest confirming that the offer has been added to the POS basket Loyalty points balance is not updated, since the guest is scanning an offer Offer pre-selection is cleared
Cashier finalizes the order and guest pays at POS	POS prints receipt with points earned & points balance	Guest sees updated points balance

2. Redeem rewards

2.1. While signed out

This is not possible. Rewards are only available to guests who have an account and have enrolled in the Loyalty program.

2.2. Authenticating with Loyalty Code

In this scenario, guests do not pre-select any rewards and instead start their journey by scanning their Loyalty code at the POS. The guest in this scenario does a second scan to add a reward after the initial identification.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens the Loyalty code page on the RBI app	N/A	Loyalty code page is displayed:
Cashier is prompted to add a loyalty code	Cashier asked if guest is a loyalty member:	No action
Guest either scans the loyalty code, or tells the 6 digit code to the cashier	If guest does not scan the QR code, cashier can enter the 6 digit Loyalty code: Either by scanning or entering the code, POS confirms successful identification:	Guest receives a successful confirmation modal
Guest opens an reward on the RBI app, chooses to redeem in restaurant	No action	Reward is added to the guest’s pre-selection A unique reward code is generated
Guest either scans the reward’s QR code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification: These reward(s) are incrementally added to the cart and do not replace any of the existing cart items	Modal is shown to guest confirming that the offer has been added to cart The reward’s loyalty points cost is temporarily subtracted from the guest’s loyalty points balance Loyalty points that will be accrued after the order will not be added to the guest’s loyalty points balance at this stage Reward pre-selection is cleared
Cashier finalizes the order and guest pays at POS	POS prints receipt with points earned & points balance	Guest sees updated points balance

2.3. Using reward pre-selection

In this scenario, guests pre-select rewards on the RBI app and continue their journey in the POS by scanning the generated code. Then they add more rewards to their basket by choosing those rewards in the app and scanning them, and finally they ask the cashier to remove one of the rewards.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens a reward on the RBI app	No action	Reward page is displayed:
Guest taps “Redeem in Restaurant”	No action	Reward is added to the guest’s pre-selection A unique reward code is generated
Cashier is prompted whether the Guest has loyalty, and confirms	Cashier asked if guest is a loyalty member and clicks on “Ok”	No action
Guest either scans the reward code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification (since the reward code also identifies the Loyalty user): Reward is added to POS cart	Guest receives a successful confirmation modal The reward’s loyalty points cost is temporarily subtracted from the guest’s loyalty points balance Loyalty points that will be accrued after the order will not be added to the guest’s loyalty points balance at this stage Reward pre-selection is cleared
Guest opens a second reward on the RBI app, chooses to redeem in restaurant Note: the flow is exactly the same if the guest pre-selects multiple rewards.	No action	Only the second reward is added to the guest’s pre-selection A unique reward code is generated
Guest either scans the reward’s QR code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification: These reward(s) are incrementally added to the cart and do not replace any of the existing cart items	Modal is shown to guest confirming that the offer has been added to cart The second reward’s loyalty points cost is temporarily subtracted from the guest’s loyalty points balance At this point, the guest’s loyalty points balance has been deducted for two rewards Loyalty points that will be accrued after the order will not be added to the guest’s loyalty points balance at this stage Reward pre-selection is cleared
Guest requests to remove first reward from order	Cashier removes the first reward from the open order Basket is updated accordingly	Guest sees the first reward’s loyalty points returned to their loyalty points balance
Cashier finalizes the order and guest pays at POS	POS prints receipt with points earned & points balance	Guest sees updated points balance

2.4. Limit one reward per purchase

This scenario only happens if the market has decided to limit redemption of one reward per purchase. This is currently the case in PLK ES and BK ES for example.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens a reward on the RBI app	No action	Reward page is displayed:
Guest taps “Redeem in Restaurant”	No action	Reward is added to the guest’s pre-selection A unique reward code is generated
Cashier is prompted whether the Guest has loyalty, and confirms	Cashier asked if guest is a loyalty member and clicks on “Ok”	No action
Guest either scans the reward code, or tells the 6 digit code to the cashier	Either by scanning or entering the code, POS confirms successful identification (since the reward code also identifies the Loyalty user): Reward is added to POS cart	Guest receives a successful confirmation modal The reward’s loyalty points cost is temporarily subtracted from the guest’s loyalty points balance Loyalty points that will be accrued after the order will not be added to the guest’s loyalty points balance at this stage Reward pre-selection is cleared
Guest opens a second Reward on the RBI app, chooses to redeem in restaurant	No action	User will see modal in the app letting user know, use can only add 1 offer per order and prompting user to replace
Guest taps Replace	No action	New Reward is added to the guest’s pre-selection and the old reward is removed from pre-selection cart
Guest either scans the reward’s QR code, or tells the 6 digit code to the cashier	New reward replaces the previous selected reward in the POS basket Other items in the POS basket are not removed or replaced	Modal is shown to guest confirming that the reward has been added to the POS basket The reward’s loyalty points cost is temporarily subtracted from the guest’s loyalty points balance Loyalty points that will be accrued after the order will not be added to the guest’s loyalty points balance at this stage Reward pre-selection is cleared
Cashier finalizes the order and guest pays at POS	POS prints receipt with points earned & points balance	Guest sees updated points balance

3. Edge cases

3.1. Switch users

This is a potential fraud use, where a guest authenticates themselves using one loyalty code, and then attempts to redeem rewards using a different loyalty code.

This scenario is the same whether guests are redeeming offers or rewards.

Steps	Expected results (POS)	Expected results (RBI app)
Guest opens the Loyalty code page on the RBI app	N/A	Loyalty code page is displayed:
Cashier is prompted to add a loyalty code	Cashier asked if guest is a loyalty member:	No action
Guest either scans the loyalty code, or tells the 6 digit code to the cashier	If guest does not scan the QR code, cashier can enter the 6 digit Loyalty code: Either by scanning or entering the code, POS confirms successful identification:	Guest receives a successful confirmation modal
Guest opens an reward on the RBI app in a different device, using a different user, and chooses to redeem in restaurant	No action	Reward of is added to the guest’s pre-selection (on the second device) A unique reward code is generated
Guest (on their second device) either scans the reward’s QR code, or tells the 6 digit code to the cashier	Error modal shows in the POS, letting the cashier know that the last scan was made using a different user account Contents of the second scan are not added to the guest’s basket (so the current basket remains unchanged) The second scan is cancelled/voided Initial order can continue normally	Modal is shown to the second user confirming that the offer has been added to cart The reward’s loyalty points cost is temporarily subtracted from the guest’s loyalty points balance Loyalty points that will be accrued after the order will not be added to the guest’s loyalty points balance at this stage Reward pre-selection is cleared A few seconds later, the loyalty points are returned to the second user

3.2. Payment Failure

This can be caused if users do not have enough funds to be able to complete the transaction.