> For the complete documentation index, see [llms.txt](https://docs.rmhpos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rmhpos.com/loyalty-manager/loyalty-concepts/loyalty-programs.md).

# Loyalty programs

Loyalty Manager allows retailers to create one or more loyalty programs. There may be multiple loyalty programs active at the same time and applying to different item categories, customers, etc. A customer may be collecting and redeeming the loyalty value on multiple programs simultaneously. For example, in a pet supply store the customer is participating in three separate loyalty programs: collecting quantity points for two separate buy 10 get 1 free loyalty programs, and a price points loyalty for accessories.

A loyalty program always consists of a mandatory collection schedule and redemption schedule, which define how to collect and redeem the loyalty value. It also has two optional rules, effective date and require confirmation.

Mandatory parameters:

* One or more **collection schedules**: A set of collection rules that determines how the loyalty values are collected.
* A **redemption schedule**: A set of rules determining how the collected loyalty value may be redeemed.

Optional parameters:

* **Effective date**: Determines a time period during which the loyalty program is in effect. If not provided, the loyalty program is always in effect.
* **Require confirmation**: A flag that prompts the cashier to request explicit consent from the customer for participating in the loyalty program. Appears only once when a customer is first eligible for a loyalty value collection.

Loyalty programs use a concept of the loyalty batch. Loyalty batch is associated with a customer. The customer always has one open batch per loyalty program the participate in. The batch opens every time a new loyalty program starts for a customer. When the customer receives a redemption, the current loyalty batch is closed and a new batch is opened with transfer of the remaining points balance.


---

# 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://docs.rmhpos.com/loyalty-manager/loyalty-concepts/loyalty-programs.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.