> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/reach-participants/set-up-rewards.md).

# Set up rewards

Add a reward to a study, approve payouts in Reward approvals, and retry failed payments safely.

This page shows how to put a reward on a study, how participants receive it, and how to approve, track and retry payouts. Read [Incentives overview](https://docs.askyazi.com/reach-participants/incentives-overview.md) first if you have not chosen a reward type yet.

{% hint style="info" %}
**In short:** set the reward in **Build > Study configuration > Completion & follow-up > Advanced options**, under **Give a reward**. Approve payouts in **Reward approvals** on the **Share** tab. Approving sends the claim link. Failed payments sit on a **Failed** tab with a **Reprocess** button that cannot pay anyone twice.
{% endhint %}

## Before you start

* Your organisation needs incentive credits. See [Incentive credits](https://docs.askyazi.com/reach-participants/incentives-overview.md#incentive-credits).
* If participants may finish more than 24 hours after their last message (common on diaries), the reward message has to go as a template. Yazi creates the template in the participant's language if you do not have one.

## Add a reward to a study

{% stepper %}
{% step %}

### Open Completion & follow-up

In the study's **Build** tab, open **Study configuration > Settings > Completion & follow-up** and expand **Advanced options**. It offers three endings that replace the plain completion message, and you switch one on: **Closing broadcast**, **Redirect to another survey** and **Give a reward** ("Voucher / code on completion"). Switch on **Give a reward**.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FgPXgc2bxb3VzW2eGcK4B%2Ffs-advanced-options-reward.webp?alt=media&amp;token=37e8a955-a407-4a33-a071-20cc31d5a2ca" alt="Completion &#x26; follow-up > Advanced options, with the Give a reward switch"><figcaption></figcaption></figure>

On a multi-activity study, set the reward on the activity that should trigger it, usually the last one.
{% endstep %}

{% step %}

### Choose the provider and country

Pick the reward provider (for example gift cards, Direct to Bank or airtime). Type to find the reward country. For airtime, choose one country only; the currency is set for you.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F8IafqCM6kmT44GZuwKFn%2Ffs-reward-provider-list.webp?alt=media&amp;token=2621d61c-9f7b-4e32-baa0-1179a0a2bece" alt="The Reward Provider list: Tremendous, Virtual Incentives, Reloadly and Ding"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Set the amount

Enter the amount in the reward currency. For airtime, the amount is checked against the mobile network's allowed range before sending, so an out-of-range amount fails with a clear reason rather than silently.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FZSD7ODgvLcogyTAi32Bx%2Ffs-reward-options-chosen.webp?alt=media&amp;token=dad5e6db-23bd-494a-b042-b301aa50c3a1" alt="A reward set up: amount, country and the reward options participants choose from, with your available credits below"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose approval and wording

Leave approval required on (the default) to check each payout before it goes. Edit the reward message if you want your own wording. Some reward types let you cap the number of rewards, for example the first 100 completes.
{% endstep %}

{% step %}

### Publish

Publish the study.
{% endstep %}
{% endstepper %}

The bottom row of the question list in **Build** always shows how the study ends, so you can see at a glance that it ends with a reward.

## Approve rewards

When a study has a reward on any activity, the **Share** tab shows **Reward approvals**, with a badge for how many are waiting. On a multi-activity study with rewards on more than one activity, pick the activity first; the drawer header names the activity you are in.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FwzlqVr8wrLfd5u7CuXl5%2Ffs-reward-approvals.webp?alt=media&amp;token=4a55f62f-2695-4117-b916-2efcb0f14673" alt="Share > Reward approvals: rewards waiting for review, with Pending, Approved, Failed and Declined tabs"><figcaption></figcaption></figure>

In the drawer, each row shows:

* the participant
* the reward and the amount the participant receives
* the delivery status: Processing, Delivered or Failed
* a **Trust score** tag from [Response Trust](https://docs.askyazi.com/monitor-fieldwork/response-trust.md), so you can hold back payouts on flagged responses

Tick one or many people and use the bar at the top of the list to approve or decline. You can search by participant ID and export the visible list as CSV.

When you approve, Yazi sends the participant their claim link (or the airtime) with a WhatsApp message saying what they got.

## What the participant receives

* **Inside the 24-hour window** (they messaged in the last 24 hours, which is usual right after finishing): a normal message with the reward or claim link, using your reward wording.
* **After the window has closed:** an approved template in their language, with the link. Missing language versions are created automatically.
* **If the reward cap is reached or delivery fails:** a thank-you message, so nobody is left wondering whether their answers arrived.

## Failed payments

Open the **Failed** tab in Reward approvals. Each row shows why the payment failed and how many times it was tried.

* Some failures fix themselves: airtime payouts are retried automatically after an hour, and stop as failed after five attempts.
* Click **Reprocess** to give a payment a fresh set of attempts, for example after a provider issue clears.
* Reprocess is safe: before paying again, Yazi checks with the provider whether the earlier attempt actually went through, and if it did, it records that instead of paying twice.

Payouts that failed because you ran out of credits do not need Reprocess. They wait and send themselves when you top up.

## Reconciling incentive spend

Use the Reward approvals CSV export and the participant statuses on the **Share** tab. The amount shown is what the participant received, in the reward currency. For who completed, see [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md).

## Limits and things to know

* Airtime is one country per study, and the currency cannot be overridden.
* Panel recruits from Prolific or PureSpectrum are paid by the panel, not by this reward.
* Simulated participants in the Test Simulator do not receive rewards. If you share the test link with other people while rewards are on, check **Reward approvals** before you approve anything.
* Once a reward is delivered it cannot be taken back. Review flagged responses before approving.

## Related

* [Incentives overview](https://docs.askyazi.com/reach-participants/incentives-overview.md)
* [Response Trust](https://docs.askyazi.com/monitor-fieldwork/response-trust.md)
* [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md)
* [WhatsApp costs and the 24-hour window](https://docs.askyazi.com/reach-participants/whatsapp-costs-and-the-24-hour-window.md)
