Versions Compared

Old Version 3

changes.mady.by.user Milheiro da Costa, Carolina

Saved on

compared with

New Version Current

changes.mady.by.user Milheiro da Costa, Carolina

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Contents

Table of Contents
Note

Scanner must always be on, allowing guests to sign in and scan more offers at any time. All offers must be incrementally added to the cart and not replace any of the existing cart items.

1. While signed out

In this scenario, guests do not sign in to the RBI app or the Kiosk, and they use an open offer. This scenario includes markets that have decided to allow showing offers on the Kiosk UI and markets that have decided not to show offer on the Kiosk UI.

...

.

Info

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

Steps

Expected results (Kiosk)

Expected results (RBI app)

Loyalty API usage (Kiosk)

Guest looks at the Kiosk screen

  • A page shows up inviting the guest to start an order

image-20240207-094204.png

  • N/A

  • No action

Guest touches the screen to start a new order

  • Guest is prompted to sign in

image-20240207-094240.png

  • No action

  • No action

Guest decides to continue without signing in

  • Kiosk order screen show up. This screen does not show either offers or rewards tabs

image-20240207-094305.png

  • Guest can sign in at any time by using the scanner or touching a sign in button

  • No action

  • No action

Guest taps on the Coupons tab

  • Guest is prompted to sign in.

image-20240216-122141.png

  • No action

  • No action

If, instead of signing in, the guest clicks in “I have a code”, the guest will be able to input a short code for open offers.

(Example: campaigns that do not involve loyalty but offer a coupon)

image-20240216-122236.png

  • No action

  • No action

After signing in, the guest will see a page with all offers available for him displayed

Info

Note: this step is only available in markets that have decided to show offers on the Kiosk UI.

Note

Related to multiscanning.

Scanner must always be on, allowing guests to choose between:

  • Selecting offers on coupon page in the Kiosk or

  • Scanning offers through the app All offers must be incrementally added to the cart and not replace any of the existing cart items.

Offers are displayed:

image-20240207-095754.png

  • No action

Guest selects an offer

  • Details displayed

image-20240207-100053.png

  • No action

  • No action

Guest adds offer to basket

  • Added incrementally

Info

Note: If an offer can’t be redeemed because the offer rules are not met, the Kiosk displays a modal to the guest explaining why the offer can’t be added to cart

  • No action

  • Call the Transaction Validate endpoint to verify that the current basket selection is valid

  • Note that the call above may return errors. Please refer to Loyalty API - Error List for details.

Guest checks out and pays

  • Order number shows up on the screen

  • Receipt is printed (ideally the receipt would include the points earned and/or burned + the updated loyalty points balance)

  • Guest sees updated points balance

 

  • Call the Transaction Update endpoint with a status of CLAIMED to complete the order

  • After this call it is not possible to modify the loyalty transaction anymore

...

Related to multiscanning.

Scanner must always be on, allowing guests to scan more offers. All offers must be incrementally added to the cart and not replace any of the existing cart items.

Steps

Expected results (Kiosk)

Expected results (RBI app)

Loyalty API usage (Kiosk)

Guest opens the Loyalty code page on the RBI app

  • N/A

  • Loyalty code page is displayed:

  • Not applicable

Guest taps on the Kiosk screen to start a new order

  • Loyalty sign in page shows up on the Kiosk and scanner becomes active

  • N/A

  • Not applicable

Guest scans the loyalty code or inputs 6 digit code in Kiosk

Note

Related to multiscanning.

Scanner must always be on, allowing for scanning of offers or rewards. All offers or rewards must be incrementally added to the cart and not replace any of the existing cart items.

  • Kiosk authenticates the guest and shows the home page

  • Scanner remains active

image-20240207-094305.png

  • Guest receives a successful confirmation modal

image-20240207-095349.png

  • Call the Identify endpoint, which will return the Loyalty User ID, loyalty points balance and a transaction ID

Guest opens an offer on the RBI app, chooses to redeem in restaurant

Note

  • No action

  • Offer is added to the guest’s pre-selection

  • A unique offer code is generated

  • No action

Guest either scans the offer’s QR code or inputs 6 digit code into Kiosk

Info

Note: if a user pre-selects more offers in the app, all pre-selected offers will show in the Kiosk screen after scanning with an option for the user to customize each offer

  • Offer(s) are shown on the Kiosk and guest has an option to customize

  • Modal is shown to guest confirming that the offer has been added to the basket

  • Loyalty points balance is not updated, since the guest is scanning an offer

  • Offer pre-selection is cleared

image-20240207-095349.png

  • Keep track of the current basket contents including offers

  • Void the previous transaction (keeping basket information)

  • Call the Identify endpoint again, which will create a new transaction ID and selected offers

  • Update the basket with the offers returned

Guest customizes offer(s) at will and adds to basket

Note

Related to multiscanning.

Scanner must always be on, allowing guests to scan more offersfor scanning of offers or rewards. All offers or rewards must be incrementally added to the cart and not replace any of the existing cart items.

  • These offer(s) are incrementally added to the cart and do not replace any of the existing cart items

image-20240207-094305.png
Info

Note: If an offer can’t be redeemed because the offer rules are not met, the Kiosk displays a modal to the guest explaining why the offer can’t be added to cart

  • No action

  • Call the Transaction Validate endpoint to verify that the current basket selection is valid

  • If Transaction Validate was called above when rewards were added to the basket, there is less probability of errors but they could still happen due to issues with regular menu items.

  • Note that the call above may return errors. Please refer to Loyalty API - Error List for details.

On the Kiosk UI, guest navigates to the Coupons page

Info

Note: this step is only available in markets that have decided to show offers on the Kiosk UI.

Note

Related to multiscanning.

Scanner must always be on, allowing guests to scan more offersfor scanning of offers or rewards. All offers or rewards must be incrementally added to the cart and not replace any of the existing cart items.

Offers are displayed:

As the user is already signed in, there is no prompt to sign in on the locked offers.

image-20240207-095754.png

  • No action

Guest selects an offer

  • Details displayed

image-20240207-100053.png

  • No action

  • No action

Guest adds offer to basket

Note

Related to multiscanning.

Scanner must always be on, allowing guests to choose between:

  • Selecting offers on coupon page in the Kiosk or

  • Scanning offers through the app All offers must be incrementally added to the cart and not replace any of the existing cart items.

  • Added incrementally

Info

Note: If an offer can’t be redeemed because the offer rules are not met, the Kiosk displays a modal to the guest explaining why the offer can’t be added to cart

  • No action

  • Call the Transaction Validate endpoint to verify that the current basket selection is valid

  • Note that the call above may return errors. Please refer to Loyalty API - Error List for details.

Guest checks out and pays

  • Order number shows up on the screen

  • Receipt is printed (ideally the receipt would include the points earned and/or burned + the updated loyalty points balance)

  • Guest sees updated points balance

 

  • Call the Transaction Update endpoint with a status of CLAIMED to complete the order

  • After this call it is not possible to modify the loyalty transaction anymore

...

Steps

Expected results (Kiosk)

Expected results (RBI app)

Loyalty API usage (Kiosk)

Guest opens an offer on the RBI app

  • N/A

  • Offer page is displayed:

image-20240207-100154.png

  • No action

Guest taps “Use at restaurant”

  • N/A

  • Offer is added to the guest’s pre-selection

image-20240207-100249.png

  • A unique offer code is generated

  • No action

Guest taps on the Kiosk screen to start a new order

  • Loyalty sign in page shows up on the Kiosk and scanner becomes active

  • N/A

  • No action

Guest either scans the offer’s QR code or inputs 6 digit code into Kiosk

Info

Note: if a user pre-selects more offers in the app, all pre-selected offers will show in the Kiosk screen after scanning with an option for the user to customize each offer

  • Offer(s) are shown on the Kiosk and guest has an option to customize

  • Modal is shown to guest confirming that the offer has been added to cart

image-20240207-095349.png

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, a list of offer(s) pre-selected, loyalty points balance and a transaction ID

Guest customizes offer(s) at will and adds to basket

Note

Related to multiscanning.

Scanner must always be on, allowing guests to scan more offersfor scanning of offers or rewards. All offers or rewards must be incrementally added to the cart and not replace any of the existing cart items.

  • These offer(s) are incrementally added to the cart and do not replace any of the existing cart items

image-20240207-094305.png
Info

Note: If an offer can’t be redeemed because the offer rules are not met, the Kiosk displays a modal to the guest explaining why the offer can’t be added to cart

  • No action

  • Call the Transaction Validate endpoint to verify that the current basket selection is valid

  • Note that the call above may return errors. Please refer to Loyalty API - Error List for details.

Guest opens a second offer on the RBI app, chooses to redeem in restaurant

Info

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

  • image-20240207-100607.png

    A unique offer code is generated

  • No action

Guest either scans the offer’s QR code or inputs 6 digit code into Kiosk

Info

Note: if a user pre-selects more offers in the app, all pre-selected offers will show in the Kiosk screen after scanning with an option for the user to customize each offer

  • Offer(s) are shown on the Kiosk and guest has an option to customize

  • Modal is shown to guest confirming that the offer has been added to cart

image-20240207-095349.png

  • Loyalty points balance is not updated, since the guest is scanning an offer

  • Offer pre-selection is cleared

  • Keep track of the current basket contents including offers

  • Void the previous transaction

  • Call the Identify endpoint again, which will create a new transaction ID and selected offers

  • Update the basket with the offers returned

Guest customizes offers at will and adds to basket

Note

Related to multiscanning.

Scanner must always be on, allowing for scanning of offers or rewards. All offers or rewards must be incrementally added to the cart and not replace any of the existing cart items.

  • These offer(s) are incrementally added to the cart and do not replace any of the existing cart items

image-20240207-094305.png
Info

Note: If an offer can’t be redeemed because the offer rules are not met, the Kiosk displays a modal to the guest explaining why the offer can’t be added to cart

  • No action

  • Call the Transaction Validate endpoint to verify that the current basket selection is valid

  • Note that the call above may return errors. Please refer to Loyalty API - Error List for details.

On the Kiosk UI, navigates to the coupons page

Info

Note: this step is only available in markets that have decided to show offers on the Kiosk UI.

Note

Related to multiscanning.

Scanner must always be on, allowing guests to scan more offersfor scanning of offers or rewards. All offers or rewards must be incrementally added to the cart and not replace any of the existing cart items.

Coupons are displayed:

image-20240207-095754.png

  • No action

Guest selects an offer

  • Details displayed

image-20240207-100053.png

  • No action

  • No action

Guest adds offer to basket

  • Added incrementally

Info

Note: If an offer can’t be redeemed because the offer rules are not met, the Kiosk displays a modal to the guest explaining why the offer can’t be added to cart

  • No action

  • Call the Transaction Validate endpoint to verify that the current basket selection is valid

  • Note that the call above may return errors. Please refer to Loyalty API - Error List for details.

Guest checks out and pays

  • Order number shows up on the screen

  • Receipt is printed (ideally the receipt would include the points earned and/or burned + the updated loyalty points balance)

  • Guest sees updated points balance

 

  • Call the Transaction Update endpoint with a status of CLAIMED to complete the order

  • After this call it is not possible to modify the loyalty transaction anymor

...