Empfehlungs-Programm — Konfiguration
Zuletzt aktualisiert: 14. Mai 2026
Tab Konfiguration auf /admin/referrals — sechs Blöcke mit Save-
Button. Jede Änderung schreibt einen referral.config_updated Audit-
Eintrag mit Diff (referral.program_toggled für den Master-Schalter).
Block: Programm-Status
| Feld | Bedeutung |
|---|---|
| Programm aktiviert | Master-Schalter; aus = neue Redemptions blockiert |
| Marketing-Banner zeigen | Steuert die /referral-Landingpage + den Header-Banner auf der Marketing-Site |
| AGB-Link | Pflichtfeld — das Programm kann nicht aktiviert werden ohne URL |
Block: Werber-Reward
| Feld | Bedeutung |
|---|---|
| Reward-Typ | credit (Stripe-Guthaben), coupon (Stripe-Coupon), trial_extension (Trial-Tage) |
| Wert (Cent) | Bei credit — wird auf Stripe als negative balance_transaction gebucht |
| Currency | ISO-Code, bei credit |
| Coupon-ID | Bei coupon — muss in Stripe existieren |
| Tage | Bei trial_extension — nur wirksam wenn Werber noch trialing |
Block: Geworbenen-Reward (Double-Sided)
Eigener Toggle. Wenn an, bekommt der Geworbene bei der Registrierung denselben Reward — entweder Stripe-Credit (sofort) oder Coupon. Trial-Extension auf den Geworbenen ist möglich aber selten sinnvoll (neuer Tenant hat eh den vollen Trial).
Block: Qualifying & Lifecycle
| Feld | Bedeutung |
|---|---|
| Qualifying-Trigger | first_paid_invoice (Standard), trial_converted, n_days_paid |
| Tage | Bei n_days_paid — Werbung qualifiziert wenn die erste Zahlung mindestens N Tage zurückliegt |
| Expiration (Tage) | Wenn Geworbener nicht innerhalb dieser Frist qualifiziert → Status Abgelaufen |
| Clawback-Fenster (Tage) | Wenn Geworbener innerhalb der Frist nach Belohnung kündigt → Credit-Rückbuchung |
Block: Eligibility & Limits
| Feld | Bedeutung |
|---|---|
| Ausgeschlossene Pläne | CSV-Liste von Plan-Slugs — Werber auf diesen Plänen verdienen nicht (Standard: trial) |
| Max. pro Periode | Pro Werber × 30 Tage; weitere Redemptions kommen in die nächste Periode |
| Lifetime-Cap (Cent) | Summe aller Rewards pro Werber; danach Admin-Approval |
| Monats-Cap (Cent) | Pro Werber × Monat |
| Plattform-Monatsbudget (Cent) | Globales Reward-Budget; danach Pause |
| Manual-Review-Schwelle (Cent) | Einzel-Rewards über diesem Wert brauchen Admin-Approval |
Block: Benachrichtigungen
Acht Toggles steuern die E-Mails + In-App-Benachrichtigungen. Die
zugrundeliegenden Templates lassen sich unter /admin/emails/templates
editieren (Subject + Body + Variables):
referral_redeemed— an Werber wenn jemand seinen Code einlöst.referral_qualified— an Werber wenn Werbung qualifiziert.referral_rewarded— an Werber wenn Reward auf Stripe gebucht.referral_clawback— an Werber wenn Reward zurückgenommen wird.referral_expired— informativ, Default aus.referee_welcome_with_reward— an Geworbenen bei double-sided.referral_grant_failed_admin— interner Alert wenn Stripe fehlschlägt.- In-App-Benachrichtigungen — Bell-Icon-Toast im Werber-Dashboard.
Best Practices
- Aktivierung: setze AGB-Link, lege den Stripe-Coupon (wenn
coupon-Reward) zuerst an, dann schalte das Programm scharf. - Test: vor Roll-out für alle Tenants — Test-Coupon-ID eintragen, einen Test-Account werben, prüfen dass Cron + Stripe die volle Pipeline durchlaufen.
- Budget-Schutz: Plattform-Monatsbudget setzen, bevor die Kampagne öffentlich beworben wird.