# Rewards and Badges

**Create reward vouchers and digital** [**badges**](#what-are-badges) **that can be assigned to a** [**Rewards Activity**](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/reward-activity) **in a** [**Pathwa**](https://app.gitbook.com/o/-LkZMh7HTpHtgrDm7Uox/s/UTpgpthx85UKIDy6CNFa/)**.**

## What are Rewards?

**If a user fulfils an action on the app, then they can receive a reward.**  Rewards are digital vouchers with a unique QR code that can be [redeemed](#redeeming-rewards) in various ways.&#x20;

## **How can users earn Rewards?**

**A reward can be earned on a** [**Pathway**](https://app.gitbook.com/o/-LkZMh7HTpHtgrDm7Uox/s/UTpgpthx85UKIDy6CNFa/) **by completing a** [**Reward Activity**](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/reward-activity)**.** Set the fulfilment requirement by deciding which activities must be completed or which milestones and targets must be reached before the reward is received.&#x20;

Rewards could be granted for:

* completing a [learning activity](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities);
* reaching a [trackable target](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/data-tracking), or&#x20;
* passing a [checkpoint](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/data-activation) on a [Pathway](https://app.gitbook.com/o/-LkZMh7HTpHtgrDm7Uox/s/UTpgpthx85UKIDy6CNFa/).

## How are Rewards redeemed?

**Rewards are created as QR Code vouchers.** Reward vouchers can be redeemed in multiple ways depending on your requirements:

1. **Peer-to-Peer.** The voucher QR code is scanned by the reward provider. Any mobile phone can be used to scan the code. A notification is sent to the reward recipient on their app. They can confirm or reject the reward redemption. If confirmed, they can show this to the provider to receive the reward.
2. **Manually.** Reward voucher states can be overridden by platform users. This is useful if you are manually distributing rewards and wish to update the reward voucher to Redeemed manually from the reward logs.
3. [**Webhook & AP**](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/api-and-webhooks)**I.** Reward vouchers can be redeemed through the available API which allows you to integrate into any physical/digital reward system and issue direct rewards through the API quite easily.

## How to Create a Reward

1. **To create a new Reward, open Pathways and then select Rewards.**
2. **Select the + icon (bottom right) and select Add Reward.**
3. **Choose a Reward Icon.**  Select and search for a suitable icon for your Reward.
4. **Reward Title.** Enter the name/title of the Reward.
5. **Instructions**. Write instructions on how to redeem the Reward (max. 255 characters)
6. **Terms.** Add a link to the Reward terms and conditions (optional).
7. **API & Web Hook Identifier (Optional).** Provide a SKU or unique identifier of your choice. A unique code will be created automatically if this is not provided.
8. **Support Contact.** Provide the contact name and email address of the person who can be contacted by the user if they have any questions about the Reward or need help to redeem it.
9. **Reward Limits.** Define how many of the Rewards are available. When the maximum is reached, the user will be notified that the reward is no longer available and they can get in touch with the Reward Support Contact.
   1. **Available Stock.** Enter a number to limit the amount of Reward redemptions.
   2. **Is the reward a limited offer?** Set a fixed expiry date (Reward must be redeemed by DD/MM/YYYY), or set a dynamic expiry date (redeem within X days after receiving the Reward).
10. **Save.**

{% hint style="info" %}
Rewards and Badges must be created before they can be added as a [Pathway Activity](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities).
{% endhint %}

## Hidden Rewards & [Badges](#what-are-badges)

Hidden rewards/badges are [reward activities](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/reward-activity) that are **not visible to the user** on the pathway. This creates a **surprise and delight** experience when a user unexpectedly earns a reward or badge.&#x20;

Hidden reward activities **auto complete** when the user reaches the part of the pathway where the activity is placed.

### How to Hide a Reward or Badge

1. [**Create**](#how-to-create-a-reward) **and add a Reward or Badge to a Pathway.**
2. **Select the + icon in a Pathway row and select** [**Reward**](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/reward-activity)**.**
3. **Choose the Reward or Badge.**  Under Activity Settings you can set Hidden/Auto to Yes if the reward must be hidden, i.e. it will only be visible to the user when they reach the reward activity.

<figure><img src="https://4086941794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTpgpthx85UKIDy6CNFa%2Fuploads%2F9pFoQLKguxzPHUDRcBov%2FScreenshot%202024-11-26%20at%2011.41.13.png?alt=media&#x26;token=49b953b3-4727-46cc-b81f-e46bed0bfcab" alt=""><figcaption><p>Hidden rewards and badges</p></figcaption></figure>

{% hint style="info" %}
**Notes on hidden rewards/badges**\
If a reward/badge is out of stock or has expired, then the hidden reward/badge will not display as an icon or metric on the pathway stats view.
{% endhint %}

## How to Update or Delete a Badge or Reward

1. **Open Pathways and then select Rewards.**
2. **Select the options icon next to the Reward or Badge.**
3. **Select Update to edit the Reward or Badge information.**
4. **Select Remove to delete the Reward or Badge.** When a reward/badge is removed, this will also remove all the badge/reward from any user that has received the badge/reward.

<figure><img src="https://4086941794-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUTpgpthx85UKIDy6CNFa%2Fuploads%2FTkT4OQ0xmtSEObXFWJai%2FScreenshot%202024-02-19%20at%2013.40.28.png?alt=media&#x26;token=a767d014-23dc-4bcd-90b0-a676c45f02d7" alt=""><figcaption></figcaption></figure>

## How to View Reward Log

1. **Open Pathways and then select Rewards.**
2. **Select the options icon next to the Reward or Badge.**
3. **Select Update to View Reward Logs.**

## How to implement Rewards: an Example

Let's say, for instance, that the reward is a cup of coffee from the company or university canteen. There is no integration required to fulfil the voucher. The only implementation step is to brief the canteen staff that employees or students are going to be presenting an app to redeem a reward, and that the QR code needs to be scanned to approve the voucher.&#x20;

**We can break it down into steps:**

1. **Concept & Setup**
   1. Rewards are conceptualised and negotiated/agreed with a reward provider, e.g. a coffee shop.
   2. A reward is set up on the platform backend along with the requirements needed to get the reward. Constraints such as expiration and quantity can be set.
2. **Voucher Redemption**
   1. The voucher QR code is scanned by the reward provider. Any mobile phone can be used to scan the code.
   2. A notification is sent to the reward recipient on their app. They can confirm or reject the reward redemption.
   3. If confirmed, they can show this to the provider to receive the reward.
   4. The voucher will be redeemed.
3. **Data Tracking**
   1. The state of the voucher is tracked on the platform.
   2. Tracked data can be reconciled with the reward provider as needed.

## Rewards API & Web Hook integration&#x20;

The platform API allows you to integrate into any physical reward system and issue direct rewards through the API.

Web hooks can also be used whereby once a user receives something, the state of that reward is sent to any endpoint that can then redeem, e.g. airtime, money, vouchers, etc.

Depending on the requirements, a deep integration and a shallow integration is possible. The [peer-to-peer redemption](#redeeming-rewards) is a more shallow and easy route, whereas the deep route involves building web hooks and applying the API.

{% hint style="info" %}
Contact your platform provider to enquire about API and Web Hook integrations.
{% endhint %}

## What are Badges?

Badges are non-redeemable digital rewards of acknowledgement and provide a way to incentivise users without physical rewards. Badges have rarity ratings, the number of users who have received the badge versus the number of registered app users, which creates an intangible value for users.

1. **Common.** Received by 80% or more of users
2. **Uncommon.** Received by 60% or more users
3. **Rare.** Received by 40% or more users
4. **Very Rare.** Received by 20% or more users
5. **Ultra Rare.** Received by 19% or less users

## How to Create a Badge

1. **To create a new Badge, open Pathways and then select Rewards.**
2. **Select the + icon (bottom right) and select Add Badge.**
3. **Choose a Badge Icon.**  Select and search for a suitable icon for your Badge.
4. **Badge Name.** Enter the name/title of the Badge.
5. **Badge Limit (Optional)**. Determine how many users can achieve this badge. The fewer the Badges, the greater the rarity.
6. **Save.**

{% content-ref url="pathway-activities/reward-activity" %}
[reward-activity](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/reward-activity)
{% endcontent-ref %}
