> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theroyalglow.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Loyalty — Gems

> How customers earn gems on what they spend and redeem them for specific catalogue services — the rules behind earning, expiry, and redemption.

# Loyalty — Gems

Gems are Royal Glow's loyalty currency. Customers earn them automatically when
they pay for services, and spend them on specific services from a redeemable
catalogue. It is a simple "spend a little, get a little back" programme that
rewards repeat visits.

<Info>
  Gems are **not** a rupee discount. A customer redeems gems **against a specific
  service** (e.g. "70 gems for a Classic Manicure"), not as money off a bill.
</Info>

## What it is

A way to turn regular spending into free services over time. Every paid service
visit quietly adds gems to the customer's balance. Once they have enough, they
can claim a service from the gems catalogue without paying for it.

## How it works

<Steps>
  <Step title="Earn">
    When a service booking is completed and invoiced, the customer earns **1 gem for
    every ₹100 invoiced**, rounded down (floor). A ₹1,300 service invoice earns 13
    gems.
  </Step>

  <Step title="See the balance">
    The customer's gems balance, lifetime totals, and transaction history appear on
    their `/gems` page, alongside the catalogue of services they can redeem.
  </Step>

  <Step title="Redeem">
    The customer picks a catalogue service their balance covers; the gems are
    deducted and the service is theirs.
  </Step>

  <Step title="Expire">
    Gems expire 365 days after they are earned. A background job sweeps expired gems
    automatically.
  </Step>
</Steps>

### A quick example

| Action                        | Gems |
| ----------------------------- | ---- |
| Pays a ₹1,300 service invoice | +13  |
| Pays a ₹2,500 service invoice | +25  |
| Redeems a Classic Manicure    | −70  |

Earning always rounds down: a ₹1,099 invoice earns 10 gems, not 10.99.

## Rules

<Warning>
  **Gems cannot combine with offers.** Gems and an
  [offer](/docs/features/offers) cannot both be applied to the same booking — a
  customer uses one or the other, never both.
</Warning>

<AccordionGroup>
  <Accordion title="What is the earn rate?">
    1 gem per ₹100 invoiced, floored. Earning always rounds down — a ₹1,099 invoice
    earns 10 gems, not 10.99.
  </Accordion>

  <Accordion title="Which invoices earn gems?">
    Service invoices only. Gems are earned on `service` invoices. **No gems** are
    earned on membership purchases or membership sessions. See
    [SPA Memberships](/docs/features/memberships).
  </Accordion>

  <Accordion title="When do gems expire?">
    365 days after they are earned, handled by a scheduled background job.
  </Accordion>

  <Accordion title="Are gems a rupee discount?">
    No. Redemption claims a specific catalogue service (e.g. "70 gems for a Classic
    Manicure"), not a discount on the bill total.
  </Accordion>
</AccordionGroup>

<Info>
  Loyalty transactions are typed `earned`, `redeemed`, `expired`, or `adjusted`.
  A brand-new customer's loyalty account is created on first read, so they see a
  zero balance rather than an error.
</Info>

## Related links

<Columns cols={2}>
  <Card title="Loyalty & Offers API" href="/docs/api-reference/loyalty-offers">
    The gems balance, transaction history, and redeemable catalogue endpoints.
  </Card>

  <Card title="Offers & Combos" href="/docs/features/offers">
    Why gems and offers cannot be combined on one booking.
  </Card>

  <Card title="Billing & Invoicing" href="/docs/features/billing-invoicing">
    Service invoices are what earn gems.
  </Card>

  <Card title="Data Model" href="/docs/data-model">
    The loyalty\_account and loyalty\_transaction tables.
  </Card>
</Columns>


## Related topics

- [Customer Guide](/content/docs/product/customer-guide.md)
- [SPA Memberships](/content/docs/features/memberships.md)
- [Offers & Combos](/content/docs/features/offers.md)
- [Booking System](/content/docs/features/booking.md)
- [Data Model](/content/docs/data-model.md)