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

# Points system

> Reward purchases and sign-ups with points redeemable for discounts.

The points system rewards your customers for buying and signing up, and encourages
them to come back by redeeming points for discounts at checkout.

## How customers earn points

<AccordionGroup>
  <Accordion title="Points per purchase" icon="cart-shopping">
    Every paid order grants points based on the amount spent. You configure how many
    points each currency unit is worth (e.g., 1 point per \$1).
  </Accordion>

  <Accordion title="Welcome points" icon="gift">
    Points granted when signing up for the program. The welcome strategy
    **requires at least 1 point** to be activated; if you enable it with 0 points
    it is automatically paused.
  </Accordion>
</AccordionGroup>

## Redeem for a discount

The customer redeems their points for a discount that is applied at checkout.

<Steps>
  <Step title="Choose the redemption">
    From the store widget, the customer selects how many points to use.
  </Step>

  <Step title="The discount is generated">
    Livy reserves the points and applies the corresponding discount to the cart.
  </Step>

  <Step title="It's confirmed or reverted">
    If they complete the purchase, the points are consumed. If they cancel the discount from
    the drawer, the points are automatically restored.
  </Step>
</Steps>

<Info>
  Points redemption **stacks** with cart recovery discount codes. If for some
  reason the points discount doesn't end up being applied, the
  points are refunded so they aren't lost.
</Info>

## Points expiration

Points can have a configurable expiration.

<Warning>
  Changing the expiration period is applied **retroactively** to active points
  batches. The expiration date is recalculated with a minimum floor of 30
  days from the time of the change, so points don't expire all at once.
</Warning>

## Related metrics

* Points granted and redeemed per period
* Discounts generated from redemptions
* Impact on repurchase (customers who return using points)