# Points Economy

Configurating a Points Economy is the easiest first step in creating a points based rewards program with the following features:

* Awards customers a points (n) for each unit of currency spent.
* Expire Points
* Establish Membership Status Levels (e.g. VIP, Silver, Gold)

To create a Points Economy click "Add Economy" in the Navigation of the TallyMarks Console.

<div align="left"><img src="https://527556519-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnbdMPh8vQZwG2bYg6f%2F-M1n_2RS2CdsA8sLB5H3%2F-M1n_M7EoV2ISFBZgXkP%2Fimage.png?alt=media&#x26;token=13c3419d-9437-474f-8d9c-ef29e1d18383" alt=""></div>

### Core

<div align="left"><img src="https://527556519-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnbdMPh8vQZwG2bYg6f%2F-M1n_2RS2CdsA8sLB5H3%2F-M1na4zhqkzBxZZ9oBDM%2Fimage.png?alt=media&#x26;token=6946859e-64a7-44dd-86a9-d6050c4f045d" alt=""></div>

#### Name and Description

Esablished the Name and Description of the Program.

#### Status

Configured with one of the following status values:

| Status    | Description                                                                                                            |
| --------- | ---------------------------------------------------------------------------------------------------------------------- |
| Configure | An Economy that is in the process of being initially configured.                                                       |
| Test      | An Economy that is configured, available for testing but is not Active                                                 |
| Active    | An active Economy.  Once a Economy has been made Active it cannot be edited and can only be made Inactive or Archived. |
| Inactive  | An Inactive Economy. Once an Economy has been made in active is cannot be made Active again.                           |
| Archived  | An Archived Economy that is in a read only state.                                                                      |

### Effective From Date

The date that the Points Economy is effective from.

{% hint style="info" %}
If more than one Points Economy is active, the Points Economy with the most recent "Effective From Date" is used.
{% endhint %}

### Points Earning and Expiry

<div align="left"><img src="https://527556519-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnbdMPh8vQZwG2bYg6f%2F-M1n_2RS2CdsA8sLB5H3%2F-M1naGvYx8dR7j4CUmB8%2Fimage.png?alt=media&#x26;token=2e5b7f17-2d89-41df-a95d-40e002ff133d" alt=""></div>

#### Base Points Earning

Established the rate of base points earning that customers are awarded as points per unit of currency spent.  This is based on Order.Total, Transaction.Total.

#### Points Expiry Mode

Set the Points Expiry Mode, see [Points Expiry](https://docs.tallymarks.io/key-concepts/points-expiry)

### Levels

<div align="left"><img src="https://527556519-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LnbdMPh8vQZwG2bYg6f%2F-M1n_2RS2CdsA8sLB5H3%2F-M1naYkGXFz1SGmd6hS_%2Fimage.png?alt=media&#x26;token=81371ab0-6e9f-438d-9cf2-790a0a01b281" alt=""></div>

Points Economy supports the establishment of Membership Levels based on spend thresholds.

Spend thresholds are based on:

* Spend since the customers anniversary date ( Order.Total, Transaction.Total) for Levels where the Level Expiry Mode is Anniversary Date based (Until Anniversary Date, One Year Until Anniversary Date).
* Spend since the last expiry where the Level Expiry Mode is based on Inactivity (Points/Spend).

#### Expiry Mode

The Level expiry mode defines how long a customer remains on a level:

**Until Anniversary Date:** Membership of the attained level expires at the Customer's anniversary date. For example, if a customer's join date is 31 May 2020 (making their anniversary date 31 May) and they are added to the level on 23 December 2020, they will remain a member of this level until 31 May 2021.

**One Year Until Anniversary Date:** Membership of the attained level expires at the Customer's anniversary date plus 1 year. For example, if a customer's join date is 31 May 2020 (making their anniversary date 31 May) and they are added to the level on 23 December 2020, they will remain a member of this level until 31 May 2022.

**Inactivity (Points):** Membership of the attained level expires as a result of no points activity after t days. Spend thresholds are reset and accumulate from 0 if a customer recommences activity.

**Inactivity (Spend):** Membership of the attained level expires as a result of no spend activity after t days. Spend thresholds are reset and accumulate from 0 if a customer recommences activity.

### Sending Events

Order and Transaction Events sent (see [Sending Events](https://docs.tallymarks.io/getting-started/sending-events)) to the TallyMarks platform will respond to the configured Economy creating transactions as required.

For more complex rewards scenarios [rules ](https://docs.tallymarks.io/getting-started/creating-your-first-rule)should be created.
