Geschenkgutscheine

Usetix-Gutscheine sind accountweites Guthaben. Ein Gutschein kann Tickets für mehrere Events bezahlen, nach einem Teilkauf Restguthaben behalten und mit weiteren Gutscheinen sowie Stripe oder PayPal kombiniert werden.

Anders als ein Rabattcode senkt ein Gutschein nicht nur den Preis: Er trägt einen Geldwert, der verkauft, importiert oder vom Veranstalter gutgeschrieben wurde.

Gutscheinprodukte

Unter Gutscheine → Produkte legst Du fest, was Käufer bestellen können:

Fester Wert, zum Beispiel 25 oder 50 EUR.
Flexibler Wert mit eigenem Minimum und Maximum.
Bonusguthaben, zum Beispiel 50 EUR zahlen und 75 EUR erhalten.
Öffentlich im Gutschein-Shop oder geheim nur über den direkten Link.
Gültigkeit in Monaten ab Ausstellung.

Für einen Bonusgutschein trägst Du einen festen Gutscheinwert und einen niedrigeren Kaufpreis ein. Usetix hält die 75 EUR Guthaben, die tatsächlich gezahlten 50 EUR und die 25 EUR Bonus getrennt in Ledger und Reporting. Der Kaufpreis muss positiv und kleiner als das Guthaben sein; flexible Produkte haben keinen separaten Kaufpreis.

Die Reihenfolge im Shop änderst Du per Drag-and-drop in der Produktliste. Produkte lassen sich archivieren und reaktivieren, ohne bereits ausgestellte Gutscheine zu verändern. Beschreibung, Bild und Account-Branding erscheinen im Shop, in der E-Mail, auf dem PDF und im Apple-Wallet-Pass.

Verkaufen und zustellen

Der öffentliche Katalog liegt unter /vouchers auf Deinem Shop-Host. Käufer wählen Produkt, bei flexiblen Produkten den Betrag und danach eine Zustellung:

Selbst übergeben sendet den Gutschein an den Käufer.
Jetzt mailen sendet ihn nach bestätigter Zahlung an den Empfänger.
Mail planen stellt ihn zu einem zukünftigen Zeitpunkt vor Ablauf zu.

Ein Warenkorb darf Tickets aus mehreren Events und mehrere Gutscheine für unterschiedliche Empfänger enthalten. Bezahlt wird über Deinen verbundenen Stripe- oder PayPal-Account. Usetix stellt den Gutschein erst nach der verbindlichen Provider-Bestätigung aus; wiederholte Callbacks erzeugen weder einen zweiten Gutschein noch eine zweite Erstzustellung.

Der Käufer behält auf seiner Bestellseite Zugriff auf Gutschein, PDF, Wallet-Pass und den ausdrücklich markierten Weitergabe-Link. Der private Gutschein-Link zeigt Code, aktuelles Guthaben, Zustand, Gültigkeit, Nachricht und QR-Code. Blockierte, leere oder abgelaufene Wallet-Pässe werden ungültig.

Beim Ticketkauf einlösen

Bis zu zehn Gutscheine können eine Bestellung gemeinsam bezahlen.
Teil-Einlösungen lassen das Restguthaben bestehen.
Stripe oder PayPal kassiert nur einen verbleibenden Restbetrag.
Bei vollständiger Gutscheinzahlung ist kein Provider nötig.
Gutscheinguthaben kann keinen weiteren Gutschein kaufen.

Während eines offenen Checkouts wird der Betrag reserviert. Abbruch oder Ablauf gibt ihn frei; eine bezahlte Bestellung verbraucht ihn genau einmal.

Erstattungen

Eine Ticket-Erstattung stellt den gutscheinfinanzierten Anteil direkt auf den ursprünglichen Gutscheinen wieder her. Mehrere Gutscheine werden proportional behandelt, und derselbe Provider-Callback kann das Guthaben nicht doppelt erhöhen. Ist der Gutschein inzwischen abgelaufen, wird seine Gültigkeit für den wiederhergestellten Betrag erneuert.

Wird der Kauf eines Gutscheins vollständig bei Stripe oder PayPal erstattet, blockiert Usetix den Gutschein, löst Reservierungen und bucht sein verbleibendes Guthaben über das unveränderliche Ledger aus. Teil-Erstattungen eines Gutscheinkaufs bleiben bewusst eine manuelle Prüfung.

Ausstellen, importieren und prüfen

Manuell ausgestellte Gutscheine erhalten immer einen kryptografisch zufälligen Code. Du kannst Produkt, Betrag, Ablauf und interne Notiz wählen, aber keinen eigenen Code eingeben. Ausstellung und manuelle Guthabenänderungen sind Account-Inhabern vorbehalten und benötigen eine ausdrückliche Bestätigung.

CSV-Imports erlauben optional bestehende Kampagnen-Codes. Leere Codes werden sicher generiert; angegebene Codes müssen nach Normalisierung aus 12–64 Buchstaben oder Ziffern bestehen. Die Vorschau validiert jede Zeile, bevor ein sauberer Import asynchron und atomar angewendet wird.

Die Übersicht trennt ausgestellten Wert, offenes Guthaben, Einlösungen, bezahlten Shop-Umsatz, Bonusguthaben und blockierte Gutscheine. Jeder Guthabenschritt erzeugt einen unveränderlichen Ledger-Eintrag. Fehlgeschlagene Zustellungen lassen sich sofort erneut anstoßen; noch nie gestartete Jobs werden nach fünf Minuten, bereits versuchte oder aktive Worker-Claims nach einer Stunde wieder freigegeben.

Steuerlicher Hinweis

Usetix modelliert die Gutscheine als Mehrzweckgutscheine: Beim Verkauf entsteht Guthaben, die Steuer wird beim späteren Ticketkauf bestimmt. Bezahlter Betrag und Bonusguthaben bleiben getrennt. Kläre vor dem Produktivstart insbesondere Kulanz- und Bonusgutschriften, Buchungsgebühren, Rechnungswortlaut, Ablauf und nicht eingelöste Guthaben mit Deinem Steuerberater.

Automation

KI-Assistent und MCP verwalten Produkte, stellen Gutscheine aus, prüfen Zustellungen und Ledger, ändern Guthaben nach Bestätigung und erstellen Reports.
Die Admin-API EN bietet Produkte, Pagination, Zustellungen, Ledger, Exporte und CSV-Imports.
Die CLI stellt dieselben häufigen Workflows als typisierte Befehle bereit.
Webhooks melden Käufe, Ausstellungen, Einlösungen, Erstattungen, Änderungen und Sperren.