--- title: Gutscheine description: Guthaben-Codes ausstellen: Boni, reines Serviceguthaben und prozentuale Rabatte mit Limit und Mindestbestellwert — erstellen, verteilen und nachverfolgen. url: https://nexcmp.com/de/docs/billing/promotions/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Gutscheine {#promotions} > **Im Adminbereich:** Finance › Billing › Vouchers (`/billing/vouchers`). **Im Portal:** Billing › Redeem code (auch im Einzahlungs-Drawer). ## Funktion {#what-it-does} Ein **Gutscheincode** (Voucher) ist ein einmal verwendbarer Code, den Sie an Kunden weitergeben. Je nach Erstellung kann er Folgendes bewirken: | Typ | Was der Kunde erhält | Wohin der Wert fließt | |---|---|---| | **Bonus credit** für alle Services | Dem Guthabenkonto hinzugefügtes Geld | Guthabens saldo. Für alles verwendbar. | | **Bonus credit** für ausgewählte Services | Ein Dienstguthaben | Ein separates Guthaben, das nur für diese Dienste verwendet werden kann. | | **Discount %** | Ein Prozentsatz Rabatt auf die erste Bestellung ausgewählter Dienste | Es wird kein Guthaben gutgeschrieben; der Rabatt wird beim Checkout angewendet. | Verwenden Sie sie für Kampagnen, Entschädigungsguthaben, Partnerangebote oder Erstbestellungsrabatte. ## Anforderungen {#requirements} | Komponente | Anforderung | |---|---| | Rolle | Ein Administrator. | | Kunden | Kunden lösen Codes im angemeldeten Zustand im Portal ein (nicht als Gast). Standardmäßig muss der Kunde eine verifizierte E-Mail-Adresse haben. | | VND-Codes | Ein in VND erstellter Code wird zum Einlösungszeitpunkt anhand des gespeicherten Wechselkurses in USD umgerechnet (siehe [Currency and exchange rates](https://nexcmp.com/de/docs/catalog/currency-and-exchange-rates/)). | ## Batch erstellen {#create-a-batch} 1. Öffnen Sie **Finance › Billing › Vouchers** und klicken Sie auf **Create vouchers**. 2. Füllen Sie das Formular aus. Beispielwerte stehen in Klammern. | Feld | Hinweise | |---|---| | Batch-Name | 1–80 Zeichen (`Spring welcome`). | | Ziel | **Main site clients**, **Single reseller's customers** (benötigt eine Kundenliste) oder **Reseller wallet**. | | Berechtigte Benutzer | **All in target audience** oder **Specified** — eine E-Mail oder Kunden-ID pro Zeile, bis zu 1,000. Für Kunden eines Resellers muss es auf *Specified* stehen. | | 1 Code pro Ziel | Bei *Specified* wird ein Code pro aufgelistetem Kunden erstellt. | | Codetyp | **Bonus credit** oder **Discount %**. | | Gültig für | Wählen Sie einen oder mehrere Dienste aus; leer = **All services**. | | Währung, Nennwert | USD ab $1.00 oder VND ab 10,000 in Vielfachen von 1,000 (nur Bonusguthaben). | | Rabatt (%) | 1 bis 100 (nur Rabatt %). | | Maximaler Rabattbetrag (USD) | Erforderlich für Rabatt %, ab $1.00. Dies ist zudem der maximal mögliche Verlust pro Einlösung. | | Mindestbestellwert (USD) | `0` = keiner. Die erste Bestellung muss mindestens diesen Betrag erreichen. | | Anzahl der Codes | 1 bis 1,000 zufällige Codes. | | Verwendungen pro Code | 1 bis 100,000. `1` bedeutet eine Person pro Code; erhöhen Sie den Wert für einen geteilten Code. | | Max. Verwendungen pro Konto | Mindestens 1. Für Rabatt % muss es `1` sein. | | Startzeit (optional), Läuft ab | Das Ablaufdatum muss nach dem heutigen Tag und nach dem Start liegen, maximal 2 Jahre in der Zukunft. | | Code-Präfix (0–6 Zeichen) | Nur Buchstaben; wenn leer, wird das Präfix der Website verwendet. | | Benutzerdefinierter Code (nur wenn Anzahl = 1) | 6 bis 32 Zeichen A–Z und 0–9. Leicht zu teilen, aber leicht zu erraten: Halten Sie die Verwendungen niedrig. | | Verifizierte E-Mail erforderlich | Standardmäßig aktiv. | | Interne Notiz, Grund | Der Grund ist obligatorisch und wird im Audit-Log protokolliert. | 3. Das Formular zeigt das **Maximale Risiko** (Nennwert x Codes x Verwendungen), damit Sie den Worst Case kennen. Klicken Sie auf **Generate codes**. 4. **Kopieren Sie die Codes jetzt.** Sie werden nur einmal angezeigt: NexCMP speichert nur einen Hash und die letzten 4 Zeichen. Verwenden Sie **Copy all** oder **Download CSV**, haken Sie die Bestätigung ab und schließen Sie das Fenster. ## Verhalten der einzelnen Typen {#how-each-type-behaves} ### Wallet-Bonus (kein Dienst ausgewählt) {#wallet-bonus-no-service-selected} Das Wallet wird mit einer **Anpassungsbuchung** (Referenz `vch:...`) gutgeschrieben. Sie ist nicht auf eine Karte auszahlbar, bringt keine Affiliate-Provision, erzeugt keine Rechnung und zählt als Guthaben für Quotas. VND-Codes verwenden den Wechselkurs zum Zeitpunkt der Einlösung. ### Dienstgutschrift (Dienste ausgewählt) {#service-credit-services-selected} - Das Guthaben liegt in einem **separaten Topf**, kann nur Gebühren der gewählten Dienste bezahlen (neue Bestellungen, Verlängerungen, stündliche oder tägliche Gebühren, Upgrades) und wird **vor** dem Wallet ausgegeben. - Es kann nicht ausgezahlt, übertragen oder in Geld umgewandelt werden und verfällt mit dem Code. - Das Hauptbuch zeigt die volle Gebühr plus eine entsprechende Gutschriftzeile, sodass der Umsatz pro Dienst korrekt bleibt, während sich das Wallet nur um den Betrag verringert, den der Kunde tatsächlich bezahlt hat. - Es erhöht **keine** [quota](https://nexcmp.com/de/docs/billing/quotas/)-Stufe und wird bei der [auto top-up](https://nexcmp.com/de/docs/billing/auto-top-up/) ignoriert. - Wenn eine mit Guthaben oder Rabatt bezahlte Gebühr erstattet wird, wird der durch den Code bezahlte Teil von der Wallet-Erstattung abgezogen und in den Guthabentopf zurückgelegt. ### Rabatt % {#discount} 1. Der Kunde gibt den Code ein: er wird **aktiviert**. Ein prozentualer Code kann nur einmal pro Konto verwendet werden. 2. Die **erste Belastung** eines ausgewählten Dienstes, bei der es sich nicht um eine stündliche Gebühr handelt, wird um den Prozentsatz rabattiert, jedoch niemals um mehr als den **Maximum discount cap** und mindestens in Höhe der **Minimum order**. 3. Der Rabatt wird zum Abrechnungszeitpunkt vom Server neu berechnet; der Betrag im Browser wird ignoriert. Der Einlösungseintrag wird bei tatsächlicher Nutzung des Codes mit dem realen Rabatt geschrieben. 4. Stündliche Nutzungsgebühren verwenden den Code niemals. ## Was der Kunde tut {#what-the-customer-does} 1. Öffnen Sie **Billing** im Portal und klicken Sie auf **Redeem code** oder verwenden Sie **Have a top-up code?** im Einzahlungsfenster. 2. Geben Sie den Code ein (Groß-/Kleinschreibung wird nicht beachtet; Bindestriche optional) und klicken Sie auf **Check**. Das Portal zeigt an, was er gewährt, zum Beispiel *Valid code: +$5.00*, *$5.00 credit for VPN* oder *20% off voucher for Virtual Machines (up to $5.00)* sowie *Valid for orders from $10.00*. 3. Klicken Sie auf **Redeem** und bestätigen Sie. Jeder Code kann einmal pro Konto verwendet werden. Codes sind an die Website gebunden: Ein Code von einer Website ist auf einer anderen „ungültig“, ohne Hinweis darauf, dass er anderswo existiert. Falsche Eingaben werden gedrosselt, und nach mehreren Versuchen wird das Konto für einige Minuten gesperrt („N attempts left before a temporary lock“). ## Verfolgen und stoppen {#track-and-stop} - **Batches** listet jeden Batch mit seinem Status auf (*active*, *disabled*, *expired*, *used up*), zusammen mit der Anzahl der Einlösungen und dem Risiko. Öffnen Sie einen Batch für die Registerkarten **Codes** (maskiert) und **Redemptions** sowie **Export CSV**. - **Redemptions** listet jede Einlösung über alle Batches hinweg auf; **Reseller quotas** zeigt, wie viel vom monatlichen Ausgabelimit jedes Resellers verbraucht ist; **Settings** schaltet Reseller-Codes ein oder aus und legt das standardmäßige monatliche Limit fest. - **Disable batch** stoppt alle ungenutzten Codes; bereits vorgenommene Einlösungen bleiben erhalten. Ein einzelner Code kann ebenfalls deaktiviert werden. ## Verifizierung {#verify} 1. Erstellen Sie einen Batch mit 1 Code: Discount % 20, Cap $5, Mindestbestellwert $10, Dienst Virtual Machines. 2. Lösen Sie ihn als Testkunde ein. Das Portal meldet, dass er aktiviert ist. 3. Bestellen Sie eine VM, die mindestens $10 kostet (monatlicher Zyklus): Die Rechnung weist den Rabatt aus (maximal $5). 4. Im Batch zeigt der Code 1 Einlösung mit dem realen Rabatt. ## Limits & Hinweise {#limits-notes} - Codes sind bei der Erstellung an die **audience** und die **site** gebunden; sie können später nicht verschoben werden. - Reseller können Codes innerhalb eines monatlichen Ausgabelimits an ihre eigenen Kunden ausgeben; siehe [Resellers](https://nexcmp.com/de/docs/customers/resellers/). - Die Promo-Folien in der Seitenleiste für Kunden (**Marketing › Promo slides**) sind eine separate Funktion und gewähren keinen Rabatt. - Da der Code im Klartext niemals gespeichert wird, kann ein verlorener Batch nicht wiederhergestellt werden: Deaktivieren Sie ihn und erstellen Sie einen neuen. ## Fehlerbehebung {#troubleshooting} | Symptom | Ursache | Behebung | |---|---|---| | „Percent codes: one use per account“ (`percent_one_per_account`) | Max uses per account größer als 1 für Discount % | Setzen Sie diesen Wert auf `1`. | | Das Formular meldet, dass das Cap erforderlich ist | Discount % ohne Maximum discount cap | Geben Sie mindestens $1.00 ein. | | Kunden nicht gefunden | Eine E-Mail oder ID in der Liste ist nicht vorhanden | Korrigieren Sie die Liste (der Fehler benennt die unbekannten Einträge). | | Kunde meldet „invalid code“ | Falsche Website, abgelaufen, deaktiviert, aufgebraucht, nicht der Zielkunde oder E-Mail nicht verifiziert | Überprüfen Sie den Batch und den Kunden. | | Guthaben wurde nicht verwendet | Die Gebühr gehört zu einem anderen Dienst | Guthaben begleicht nur die im Batch ausgewählten Dienste. | | Rabatt nicht angewendet | Bestellung unter dem Minimum, stündliche Gebühr oder der Code wurde für einen anderen Dienst aktiviert | Geben Sie eine qualifizierende Erstbestellung auf. | | Kunde kann nichts mehr einlösen | Zu viele falsche Versuche | Warten Sie, bis die Sperre ablauft. |