> For the complete documentation index, see [llms.txt](https://village-labs.gitbook.io/coworker-product-and-developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://village-labs.gitbook.io/coworker-product-and-developer-docs/legacy-knowledge-base/awards/monetary-cash-awards.md).

# Monetary (Cash) Awards

## **Overview** 

Cash awards are intended to be 1:1 representations of cash currency, that is distributed to users through Village's native payment rails or via third-party payment providers like Stripe or PayPal.

Cash awards accumulate in a user's wallet as they are distributed. Users cash out these awards manually through their 'Cash Out' button on the dashboard. In future, we'll be adding the ability to cash out automatically on a schedule. 

You can select the denomination of the cash award, which can be in a currency other than USD. The selected currency will be visible to the end-user.

Before distributing cash awards, any third-party payment providers must be configured in the 'Treasury' section of the Network Manager.

{% hint style="info" %}
[**Connecting Village Cash Outs to your 3rd Party Payout Provider ->** ](/coworker-product-and-developer-docs/legacy-developer-docs/3rd-party-payments-integrations.md)
{% endhint %}

## Creating a Cash Award

To create a cash award type, follow these steps:

1. In the Awards section, click 'New Cash Award' (the purple button on the right of the screen).
2. This opens the 'Award Creation' page.
3. Input the following details:

| Input               | Description                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name of the Award   | A simple name like 'Dollars', 'Euros', or 'Australian Dollars'.                                                                                                                                                                                                                                                                                                             |
| Redemption Currency | The denomination of the currency you're awarding. For example, if you’re awarding USD, put 'USD' here.                                                                                                                                                                                                                                                                      |
| Award Short ID      | A unique identifier for the award. If setting up a payouts with Stripe, consider naming this 'USD-S'. For PayPal, consider 'USD-P'.                                                                                                                                                                                                                                         |
| Payout Initiation   | Choose if the payout is initiated by the user or the network. User initiated means the user must click 'Cash Out' for funds to be distributed. Network initiated means that payouts automatically occur on a set schedule. We recommend that you default to users manually cashing out their awards. This ensures there is visibility into why a user earned a given award. |
| Payout Provider     | Either Village (for USD-V) or your third-party payment provider like Stripe or PayPal.                                                                                                                                                                                                                                                                                      |

{% hint style="info" %}
When you chose a 3rd-party payout provider like Stripe or Paypal, any KYC must be performed by your third-party payment provider, or your platform. Village or its payment partners does not perform KYC for 3rd-party payouts. 
{% endhint %}

<br>

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://village-labs.gitbook.io/coworker-product-and-developer-docs/legacy-knowledge-base/awards/monetary-cash-awards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.