---
title: "DiscountSourceLoyalty"
description: "Discount applied when redeeming a reward from the merchant's loyalty scheme."
image: "https://developer.sumup.com/og/index.png"
---

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

Path: SumUp REST API

Discount applied when redeeming a reward from the merchant's loyalty scheme.

## Fields

- `id` (`DiscountSourceLoyalty.id`; string, required) — The unique identifier of the promotion or reward.
  - format `uuid`; example `"075b0b5c-a1f4-46da-9aca-92fb6dd5905d"`
- `loyalty_type` (`DiscountSourceLoyalty.loyalty_type`; string, required) — The type of loyalty discount, either a promotion (e.g. new customer discount) or a reward (free coffee after completing stamp card).
  - one of `"PROMOTION"`, `"REWARD"`; example `"REWARD"`
- `scheme_type` (`DiscountSourceLoyalty.scheme_type`; string, required) — The scheme type of the loyalty program.
  - one of `"STAMPS"`, `"POINTS"`; example `"POINTS"`
- `name` (`DiscountSourceLoyalty.name`; string, required) — The name of the loyalty discount.
  - maxLength 100; example `"Free coffee"`
- `application_mode` (`DiscountSourceLoyalty.application_mode`; string, required) — Method of applying the discount to the items or cart.
  - one of `"MANUAL"`, `"AUTOMATIC"`; example `"MANUAL"`
- `points` (`DiscountSourceLoyalty.points`; integer, optional, nullable) — The number of points used for this loyalty discount. Must be a positive integer if the scheme type is POINTS. Must not be populated if the scheme type is STAMPS.
  - format `int64`; min 1; example `50`
- `description` (`DiscountSourceLoyalty.description`; string, optional, nullable) — The description of the loyalty discount.
  - maxLength 250; example `"Free coffee for 50 points"`
- `discount_class` (`DiscountSourceLoyalty.discount_class`; string, optional, nullable) — The method used to target items to discount. Must be populated for ITEM level discounts, and must be null for CART level discounts (CART level targets all items, therefore none of these categories apply).
  - one of `"ITEM"`, `"CATEGORY"`, `"BUNDLE"`, `"BUY_X_GET_Y"`, `"MEAL_DEAL"`; example `"ITEM"`


Source: https://developer.sumup.com/api/schemas/DiscountSourceLoyalty/index.md
