Table of Contents

OUT OF SCOPE:

• Currently, the promo code at checkout will only support the following types of “In-App Benefits” configured: Combo; Picker; Discount.

The Item; Offer Activation; Swap are legacy options that came from the US legacy code and will not work now. We received this information from the Loyalty Team.

 

• Even if Sanity shows a list of “In-App Benefits” the legacy code for this will only support only one item independently of the type

Business requirements

• The user should not be redirected to the menu page when applying a promotional code directly through the checkout page (for Offer Combo/Picker)

• Add the offer item with the default selections for the Combo/Picker

• Show the “edit” button on the cart offer item. The edit button should send the user to the menu page for the edited item

• The behavior must be closely related to the legacy flow /offer page:

  • The item added to the cart should be exactly as we are adding it through the legacy flow (sub-items, price, etc)

  • The item should be correct at Recent Orders or Email Receipt (like the legacy /offers flow). As this is an extension of the loyalty offers feature, we didn’t need to implement anything regarding this (I added a demonstration showing the receipt when adding a Combo/Picker)

  • The offer item should not be available to add again to a new order after being used (blocked by the application by default)

• Only one offer item can be added by default. If the user tries to add another offer (Combo, Picker/Offer Discount), a modal will ask if the user wants to replace the current added offer with the new one

• If the user tries to apply the same code twice, the application should block this showing an error about “promo code already applied”

• The feature should respect the rules from Sanity or the campaign platform. For example, if the user already finishes an order for a promo code that only has one available, they should not be able to reuse that promo code

• The application should show the same errors that we already have for promotional codes (the old deprecated/removed CBA flow):

  • Unknown exception error

  • Code expired

  • Invalid code

  • Code already redeemed

  • Invalid Offer ID

  • Promo code already applied

Whitelabel solution

General behavior demonstration

How will the look and feel for Combo/Picker be after it is added to the cart

PS: What can be different between Combo/Picker is the sub-items shown in the card. Sometimes the Picker will be converted as a single item and will not have any sub-items.

Videos demonstrations:

Adding an Offer Discount at checkout

How we’ll show the errors

• For errors that are related to the promo code when applying/redeem we’ll show the error below the promo code field

  

• For errors that are related to the Sanity rules the application can show the error in two places

  • Inside the “header” of the Offer item added into the cart

    

  • Above the “continue” checkout page button. This use case is not the most common, and we don’t have all the scenarios mapped as this is legacy code. Please disregard the message, as the idea here is only to show where the error can appear.

    

About the edit button

As the user is adding the offer directly to the checkout page, he needs the ability to edit the offer item if he wants to change some of the items. This can also be used as a “shortcut” to offer up-sells during the edit time.

Videos demonstrations:

Replace logic example

The visual is standardized and will be the same that we also have on the /offers page.

Videos demonstrations:

Relationship between /offers page and promo code at checkout and reuse

As our feature uses the loyalty offer structure in its implementation, we'll have some states and connected behaviors:

• Always, when we redeem an offer on the checkout page, this offer will also be available on the /offers page to be used later (e.g., when the user, for example, adds the offer on the checkout page but for some reason doesn't finish the order using that promo code)

• The user can reuse a promo code until he finishes the order (as a default). Of course, this can be changed based on the Sanity rules for the configured offer. If the promo code is not valid anymore, an error will alert the user about it

Videos demonstrations:

FAQ

Golden rule

For Combo/Picker what's the difference from what we have on the /offers page?

Can we replace an offer at the checkout page?

Can we edit the Combo/Picker in the cart preview?

After adding the offer to the cart, the price is wrong, or I'm receiving an error saying that the offer is not available at the selected restaurant or that the product added is invalid

Lokalize keys

For the errors:

• promoCodeOfferUnknownException: default error if the backend or campaign platform doesn't return a specific one. 

• promoCodeOfferExpiredCode: for the expired code message

• promoCodeOfferInvalidCode: for the invalid code message

• promoCodeOfferRedeemedCode: for the already redeemed code

• invalidOfferId: invalid offer id cunfigured in the offer message (for bad setup)

• promoCodeAlreadyApplied: message when a code is already applied

For the promo code button texts:

• apply: the text for the apply button. As this is a very generic key is not recommended to change because can affect other places

• enterPromoCode: the label of the input

Feature Flags

• enable-edit-offer-added-at-checkout: to show or not the edit button in the offer item (for Combo/Picker)

• enable-loyalty-offer-promo-code-at-checkout: a main flag to disable/enable the whole feature

• enablePromoCodeAtCheckout: This is legacy flag that already exists and control the promo code besides our feature. Needs to be on too if we want the feature to be working