# Engagement

> Loyalty, rewards, and customer engagement on VINR.

VINR Engagement turns transactions into relationships. Run a loyalty program, award and redeem points, build status tiers and a rewards catalog, and drive repeat purchases with campaigns and offers — all reacting automatically to events from [Payments](/docs/payments) and [Billing](/docs/billing).

## What Engagement includes

[Loyalty accounts](/docs/engagement/loyalty-accounts) — Enroll members and track their balances and tier.

[Points & currency](/docs/engagement/points-and-currency) — Issue, adjust, and expire your loyalty currency.

[Tiers & status](/docs/engagement/tiers-and-status) — Reward your best customers with escalating benefits.

[Earning rules](/docs/engagement/earning-rules) — Map events to the points members earn.

[Rewards & redemption](/docs/engagement/rewards-catalog) — Define what members can redeem points for.

[Campaigns & offers](/docs/engagement/campaigns) — Run targeted, time-boxed initiatives.

## How it relates to Payments & Billing

Engagement is **event-driven**: it listens to what happens in Payments and Billing and reacts. A completed payment can award points; reaching a spend threshold can promote a member's tier; a redemption can apply a discount at [checkout](/docs/integration/checkout). The [Linking payments & loyalty](/docs/engagement/linking-payments-and-loyalty) guide is the heart of the product.

> Engagement reuses the same `customer` object as Payments and Billing. A loyalty account links to a customer, so one identity carries a buyer's payment methods, subscriptions, and points.

## Key objects

| Object             | Prefix  | Purpose                                             |
| ------------------ | ------- | --------------------------------------------------- |
| Program            | `prog_` | A loyalty program with its own currency and rules.  |
| Loyalty account    | `loy_`  | An enrolled member — links a customer to a program. |
| Points transaction | `ptx_`  | An award, deduction, or expiry of points.           |
| Reward             | `rwd_`  | A catalog item members can redeem points for.       |
| Redemption         | `rdm_`  | A member spending points on a reward.               |

## Designing a program

### Decide your currency and earn rate

Choose what members earn (points, stars, miles) and how — e.g. **1 point per €1 spent**. See [Points & currency](/docs/engagement/points-and-currency).

### Define earning rules

Map events to points: purchases, sign-ups, referrals, birthdays. Add multipliers and caps. See [Earning rules](/docs/engagement/earning-rules).

### Build a rewards catalog

Decide what points buy — discounts, free items, or [store credit](/docs/engagement/store-credit-and-wallet). See [Rewards catalog](/docs/engagement/rewards-catalog).

### Connect it to checkout

Identify the member on each payment so purchases earn and redemptions discount. See [Linking payments & loyalty](/docs/engagement/linking-payments-and-loyalty).

## Next steps

[How engagement works](/docs/engagement/how-engagement-works) — The objects and event flow in detail.

[Launch a loyalty program](/docs/guides/launch-a-loyalty-program) — A runnable end-to-end walkthrough.

[Engagement API reference](/docs/api-reference/loyalty-accounts) — Endpoints, parameters, and responses.
