# Gutscheine

> Rabattcodes in Prozent oder als fester Betrag, für die erste Abbuchung, für immer oder für N Monate, mit Gültigkeit, Nutzungslimit und anwendbaren Produkten. Wie der Rabatt in den Checkout und die Verlängerungen kommt, und welche Meldungen der Käufer sehen kann.

Ein **Gutschein** ist ein Code, den der Käufer beim Bezahlen eingibt, um einen Rabatt zu bekommen: **LANCAMENTO20**, **WILLKOMMEN10**, **SCHUELER2026**. Er dient für Produkteinführungen, Partnerschaften, Kampagnen und um Abspringer zurückzuholen.

## Wofür es gut ist

| Community | Gutschein | Was er bewirkt |
|---|---|---|
| Online-Schule | `LANCAMENTO20` | 20 % auf den ersten Monatsbeitrag des Plans Schüler, bis zu 100 Verwendungen |
| Coworking | `PARCEIRO30` | R$ 30 pro Monat in den ersten 3 Monaten des Plans Resident, nur für den Partner |
| SaaS | `ANUAL10` | 10 % für immer, nur bei den Jahresoptionen |
| Veranstaltung | `GRUPO15` | 15 % auf das Ticket, gültig bis zum Vortag |

## So funktioniert es

### Typen

| Typ | Rabatt | Beispiel |
|---|---|---|
| **Prozentual** | Ein Prozentsatz des Betrags | 20 % von R$ 129 = R$ 25,80 |
| **Fester Betrag** | Ein Betrag in Reais, pro Bestellung | R$ 30 Rabatt |
| **Kostenlose Testversion** | Zusätzliche Testtage | +7 Testtage |

### Dauer (für Abos)

| Dauer | Auf dem Bildschirm | Der Rabatt gilt |
|---|---|---|
| **einmalig** | *Rabatt wird nur bei der ersten Zahlung angewendet* | Nur auf die erste Abbuchung |
| **für immer** | *Rabatt wird bei allen Zahlungen angewendet* | Auf alle Abbuchungen, auch Verlängerungen |
| **wiederkehrend** | *Rabatt wird für N Monate angewendet* | Auf die ersten N Abbuchungen |

Bei einem Produkt, das einmal verkauft wird, spielt die Dauer keine Rolle: Es gibt nur eine Abbuchung.

### Grenzen

| Feld | Wozu |
|---|---|
| **Startdatum** \* | Ab wann der Code gilt |
| **Enddatum** | Bis wann. Leer gelassen, läuft er nicht ab |
| **Maximale Verwendungen** | Wie oft der Code insgesamt genutzt werden kann. Leer: unbegrenzt |
| **Maximum pro Benutzer** | Wie oft dieselbe Person ihn nutzen kann |
| **Anwendbare Produkte** | Für welche Produkte und Optionen er gilt. Leer: für alle |

Über die API kann ein Gutschein außerdem: einen Mindestbestellwert, einen Höchstrabatt, nur den ersten Kauf in der Community, nur Abos, nur Einzelprodukte, ausgeschlossene Produkte und ob er mit einem anderen Gutschein kombinierbar ist.

### Wie der Rabatt in die Zahlung kommt

1. Im Checkout klickt der Käufer auf **Ich habe einen Gutschein**, gibt den Code ein und klickt auf **Einlösen**. Der Bildschirm zeigt *„Gutschein LANCAMENTO20 eingelöst · −R$ 25,80"* und die Dauer (*„Rabatt nur auf die erste Abbuchung."*).
2. Der Rabatt wird **vor der Gebühr** berechnet: Die Plattformgebühr fällt auf den bereits rabattierten Betrag an.
3. In einer Bestellung mit Plan und Zusatzprodukten wird ein Gutschein mit **festem Betrag** **einmal von der Bestellung** abgezogen, aufgeteilt auf die Posten im Verhältnis ihres Werts; ein **prozentualer** gilt gleich für jeden Posten, auf den er anwendbar ist.
4. Kein Posten darf nach dem Rabatt unter **R$ 1,00** fallen.
5. Die Verwendung wird **bei der Bestätigung der Zahlung** registriert. Eine offene Bestellung (etwa ein noch nicht bezahlter Boleto) hält eine Verwendung bis zu 7 Tage fest.
6. Bei Verlängerungen gelten Gutscheine **für immer** und **wiederkehrend** für die vereinbarte Zeit weiter.
7. Mit einem [Downsell](/monetizacao/downsell) kommt zuerst der Rabatt des Downsells, dann der des Gutscheins.

Der Typ **Kostenlose Testversion** wird beim Bezahlen nicht akzeptiert (*„Diese Art von Gutschein kann beim Bezahlen nicht verwendet werden"*).

### Status

Die Liste zeigt jeden Gutschein mit Verwendungen, Gültigkeit und Status:

| Status | Bedeutung |
|---|---|
| **Aktiv** | Gilt |
| **Inaktiv** | Von dir pausiert |
| **Abgelaufen** | Das Enddatum ist überschritten |
| **Aufgebraucht** | Die maximalen Verwendungen sind erreicht |

### Wer darf

Anlegen, bearbeiten, pausieren und löschen: **Eigentümer** und **Administrator**. **Finanzen** sieht die Gutscheine und den Verwendungsverlauf.

## Schritt für Schritt: einen Gutschein anlegen

*Rolle: Eigentümer oder Administrator.*

1. **Monetarisierung › Gutscheine › Gutschein erstellen**.
2. **Code** \*: was der Kunde eingibt (z. B. `LANCAMENTO20`). Eindeutig in der Community.
3. **Name** \*: für das Team (z. B. *Einführung im März — 20 %*).
4. **Typ** \* und **Rabattwert** \*.
5. **Dauer** \*: einmalig, für immer oder wiederkehrend (mit den **Monaten**).
6. **Startdatum** \* und, wenn du willst, **Enddatum**.
7. **Maximale Verwendungen** und **Maximum pro Benutzer**, wenn du begrenzen willst.
8. Markiere unter **Anwendbare Produkte**, wo er gilt, oder lass es leer, damit er überall gilt.
9. **Erstellen**.

![Gutschein erstellen](/screens/cupom-novo.png "Code, Name, Typ, Wert, Dauer, Gültigkeit, Grenzen und anwendbare Produkte (Oberfläche auf Portugiesisch).")

Zum Pausieren stell den Status auf **Inaktiv**. Einen schon verwendeten Gutschein zu löschen wirkt sich auf die Berichte aus: Der Bildschirm sagt dir, wie oft er verwendet wurde.

## Beispiele mit Zahlen

Die Plattformgebühr beträgt 6,99 % + R$ 2,49 auf den abgebuchten Betrag, bereits mit Rabatt.

**`LANCAMENTO20`: 20 % einmalig, auf Growth Monatlich (R$ 129).**
Erster Monatsbeitrag: R$ 129,00 − R$ 25,80 = **R$ 103,20**. Gebühr: R$ 7,21 + R$ 2,49 = R$ 9,70. Es bleiben R$ 93,50. Ab dem zweiten: R$ 129,00.

**`ANUAL10`: 10 % für immer, auf Schüler Monatlich (R$ 49).**
Jeden Monat: **R$ 44,10**. Gebühr: R$ 3,08 + R$ 2,49 = R$ 5,57. Es bleiben R$ 38,53 pro Monat, solange das Abo läuft.

**`PARCEIRO30`: R$ 30 wiederkehrend für 3 Monate, auf Resident (R$ 890).**
Monate 1 bis 3: **R$ 860,00**. Ab dem vierten: R$ 890,00.

**R$ 50 fester Betrag auf eine Bestellung aus Plan + Zusatzprodukt (R$ 129 + R$ 450 = R$ 579).**
Der Rabatt beträgt R$ 50 auf die Bestellung, im Verhältnis aufgeteilt: R$ 11,14 auf den Plan und R$ 38,86 auf das Zusatzprodukt. Summe: **R$ 529,00**.

**R$ 100 fester Betrag auf einen Plan für R$ 49.**
Abgelehnt: Der Posten würde unter R$ 1,00 fallen.

## Bewährte Praxis

- **Ein Code pro Kampagne.** `INSTAGRAM20` und `NEWSLETTER20` mit demselben Rabatt zeigen über die Spalte **Verwendungen**, woher jeder Verkauf kam.
- **Bei Kampagnen immer mit Enddatum**: Ein vergessener Gutschein wird zum Dauerrabatt.
- **Maximale Verwendungen** bei Partnerschaften, damit ein durchgesickerter Code nicht zur Regel wird.
- **Nimm lieber „einmalig" oder „wiederkehrend"** als „für immer": „für immer" senkt jede Verlängerung, solange die Person bleibt.
- **Teste vor dem Bewerben**: Löse den Code mit einem Mitgliedskonto im Checkout ein und prüf die Summe.

## Meldungen, die der Käufer sehen kann

| Meldung | Warum |
|---|---|
| *Ungültiger Gutscheincode* | Den Code gibt es nicht |
| *Gutschein ist abgelaufen* | Das Enddatum ist überschritten |
| *Gutschein ist noch nicht gültig* | Vor dem Startdatum |
| *Dieser Gutschein ist nicht aktiv* | Er ist pausiert |
| *Nutzungslimit des Gutscheins wurde erreicht* | Aufgebraucht |
| *Du hast diesen Gutschein bereits so oft wie erlaubt verwendet* | Maximum pro Benutzer |
| *Dieser Gutschein gilt nicht für dieses Produkt* | Das Produkt ist nicht unter den anwendbaren |
| *Dieser Gutschein gilt für Bestellungen ab R$ X* | Mindestbestellwert |
| *Dieser Gutschein gilt nur für den ersten Kauf in dieser Community* | Einschränkung auf den ersten Kauf |
| *Mit diesem Gutschein würde ein Artikel weniger als R$ 1,00 kosten, den Mindestbetrag* | Rabatt höher als der Preis |
| *Zu viele ungültige Gutscheincodes. Versuche es in ein paar Minuten erneut.* | 10 abgelehnte Codes in 15 Minuten |
| *Der Gutschein ist nicht mehr gültig und wurde entfernt. Es wurde nichts abgebucht; prüfen Sie den neuen Gesamtbetrag und versuchen Sie es erneut.* | Der Gutschein ist zwischen Einlösen und Bezahlen abgelaufen oder aufgebraucht |

## Häufige Fehler beim Anlegen

| Meldung | Was du tust |
|---|---|
| *In dieser Community gibt es bereits einen Gutschein mit diesem Code* | Nimm einen anderen Code |
| *Gib an, wie viele Monate der wiederkehrende Gutschein gilt* | Füll bei **wiederkehrend** die **Monate** aus |
| *Zusätzliche Testtage gelten nur für Gratis-Test-Gutscheine* | Entferne die zusätzlichen Tage oder ändere den Typ |

## Häufige Fragen

**Gilt der Gutschein bei der Verlängerung?**
Gutscheine **für immer** und **wiederkehrend** ja, für die vereinbarte Zeit. **Einmalig** nur auf die erste Abbuchung.

**Kann man zwei Gutscheine nutzen?**
Nur wenn beide kombinierbar sind. Standardmäßig ein Gutschein pro Bestellung.

**Senkt der Gutschein die Plattformgebühr?**
Die Gebühr wird auf den rabattierten Betrag berechnet: Ein niedrigerer Preis bedeutet auch eine niedrigere Gebühr in Reais.

**Kann das Mitglied einen Gutschein nutzen, wenn es später über die Abrechnung eine Erweiterung hinzufügt?**
Vorerst nicht; der Gutschein gilt beim Kauf des Plans und beim Last-Chance-Angebot.

**Wie sehe ich, wie oft ein Gutschein verwendet wurde?**
In der Spalte **Verwendungen** der Liste und im Verwendungsverlauf des Gutscheins.

## In der API

`POST /api/coupons`, `PUT .../coupons/{id}`, `PATCH .../coupons/{id}/status`, `GET .../coupons/{id}/usage` und `POST .../coupons/validate` (`code`, `productId`, `amount`). Im Checkout `couponCode` in `POST /api/checkout/calculate-price` und in `POST /api/checkout`. Siehe [Coupons](/api/referencia/coupons).

## Verwandte Artikel

- [Downsell](/monetizacao/downsell)
- [Checkout](/pagamentos/checkout)
- [Plattformgebühr](/pagamentos/taxa-da-plataforma)