Einladungssystem

Uebersicht

Das Einladungssystem in TanStack Ship ermoeglicht es bestehenden Benutzern, neue Benutzer zur Plattform einzuladen und so organisches Wachstum durch Mundpropaganda zu foerdern. Jeder Benutzer erhaelt einen eindeutigen Einladungscode und einen Empfehlungslink. Wenn eine Einladung zu einer neuen Registrierung fuehrt, erhalten sowohl der Einladende als auch der neue Benutzer Guthabenbelohnungen.

Als Teil der TanStack Ship Plattform integriert sich das Einladungsmodul in das Guthabensystem fuer Belohnungsauszahlungen, das E-Mail-Marketing-System fuer Einladungszustellung und das Authentifizierungssystem fuer die Registrierung mit Einladungscodes.

Design-Ablauf

Das Einladungssystem orchestriert die gesamte Empfehlungsreise von der Codegenerierung bis zur Belohnungsauszahlung und stellt dabei in jeder Phase eine idempotente Verarbeitung sicher:

Kernfunktionen

Einladungscodes

Jeder Benutzer erhaelt bei der Registrierung automatisch einen eindeutigen Einladungscode:

• Automatisch generiert — Ein eindeutiger Code wird fuer jeden Benutzer erstellt
• Benutzersichtbar — Angezeigt in den Kontoeinstellungen (/dashboard/account/invite)
• Gutschein-kompatibel — Als Gutscheincode waehrend der Anmeldung verwendbar
• Empfehlungslink — In einen Empfehlungslink fuer einfaches Teilen einbettbar

Das Code-Format ist auf Lesbarkeit und einfache muendliche Weitergabe ausgelegt.

Beispiel — Einladungscode in einer Empfehlungs-URL:

https://yourplatform.com/signup?ref=INVITE_ABC123

Clientseitiges Einladungsteilen-Beispiel:

import { useQuery } from '@tanstack/react-query'

export function InviteCard() {
  const { data } = useQuery({
    queryKey: ['my-invite'],
    queryFn: () =>
      fetch('/api/invitations/my-code').then((r) => r.json()) as Promise<{
        code: string
        referralLink: string
        rewardAmount: number
        totalInvites: number
      }>,
  })

  return (
    <div className="rounded-lg border p-4">
      <p className="text-sm text-muted-foreground">Dein Empfehlungslink</p>
      <p className="mt-1 font-mono text-sm">{data?.referralLink ?? '—'}</p>
      <div className="mt-3 grid grid-cols-2 gap-4">
        <div>
          <p className="text-xs text-muted-foreground">Belohnung pro Einladung</p>
          <p className="text-lg font-bold">{data?.rewardAmount ?? '—'} Credits</p>
        </div>
        <div>
          <p className="text-xs text-muted-foreground">Erfolgreiche Einladungen</p>
          <p className="text-lg font-bold">{data?.totalInvites ?? 0}</p>
        </div>
      </div>
    </div>
  )
}

Empfehlungslinks

Jeder Benutzer hat einen personalisierten Empfehlungslink, der seinen Einladungscode codiert:

• Schreibt neue Registrierungen automatisch dem Einladenden zu
• Kann per E-Mail, sozialen Medien oder Messaging-Apps verteilt werden
• Verfolgt erfolgreiche Conversions und ausstehende Einladungen
• Kombiniert mit UTM-Parametern fuer Marketingattribution

Belohnungssystem

Wenn sich ein neuer Benutzer ueber eine Einladung registriert, profitieren beide Seiten:

• Einladender erhaelt — Guthabenbelohnung (konfigurierbarer Betrag, z. B. 500 Credits)
• Neuer Benutzer erhaelt — Willkommensguthabenbonus (z. B. 200 Credits)
• Belohnungen werden idempotent verarbeitet — keine doppelten Auszahlungen
• Vollstaendige Transaktionshistorie fuer Praefungen verfuegbar

Die Belohnungsbetraege sind pro Kampagne im Admin-Dashboard konfigurierbar.

Admin-Verwaltung

Administratoren koennen das Einladungssystem konfigurieren und ueberwachen von:

• /dashboard/admin/credits/invite-reward — Belohnungsbetraege und -limits konfigurieren
• /dashboard/admin/users — Einladungsstatistiken pro Benutzer anzeigen
• Einladungsmetrik-Dashboard — Gesamteinladungen, Conversion-Rate und Belohnungsauszahlungen verfolgen

Design-Philosophie

Doppelte Anreizarchitektur

Das Einladungssystem basiert auf einem dualen Anreizmodell, bei dem sowohl der Einladende als auch der neue Benutzer aus einer erfolgreichen Empfehlung einen Mehrwert erhalten. Dies erzeugt eine leistungsstarke virale Schleife: Bestehende Benutzer werden motiviert, ihre Einladungscodes zu teilen, weil sie Guthabenbelohnungen erhalten, waehrend neue Benutzer durch den Willkommensbonus dazu angeregt werden, einen Einladungscode zu verwenden. Das Belohnungsverhaeltnis ist konfigurierbar, sodass Plattformbetreiber die Wachstumsmechanik an ihre Einheitsoekonomie anpassen koennen. Im Gegensatz zu eigenstaendigen Empfehlungsplattformen wie Friendbuy — die als externe SaaS mit separaten Belohnungsdatenbanken und Webhook-basierten Auszahlungsintegrationen arbeiten — verarbeitet unser Einladungssystem Belohnungen direkt innerhalb Ihrer eigenen Guthabeninfrastruktur, ohne Drittanbieter-API-Aufrufe waehrend des Belohnungsablaufs.

Idempotente Belohnungsverarbeitung

Jede Belohnungsauszahlung ist durch Idempotenzgarantien geschuetzt — jeder Einladungscode kann nur einmal fuer eine Registrierung verwendet werden, erzwungen durch einzigartige Constraints auf Datenbankebene. Dies verhindert die haeufigste Klasse von Auszahlungsfehlern: doppelte Belohnungen durch Wiederholungen, gleichzeitige Registrierungen oder Wettlaufbedingungen. Das System protokolliert jeden Belohnungsversuch, erfolgreich oder abgelehnt, und bietet eine vollstaendige Pruefspur fuer die Fehlerbehebung.

Reibungsloses Onboarding

Einladungscodes erfuellen einen doppelten Zweck: Sie identifizieren den Empfehlungsgeber und koennen als Gutscheincode waehrend der Anmeldung verwendet werden. Dieses Dual-Use-Design reduziert den Registrierungsaufwand — ein Benutzer mit einem Einladungscode gibt ihn einfach zusammen mit anderen Registrierungsfeldern ein, ohne dass ein separater Empfehlungsablauf erforderlich ist. Das System unterstuetzt auch die offene Registrierung ohne Einladungscode, sodass der Einladungsmechanismus das Wachstum foerdert, ohne Eintrittsbarrieren zu schaffen.

Best Practices

Beide Seiten incentivieren

Ein doppeltes Belohnungssystem (Belohnung von Einladendem und Eingeladenem) erhoeht die Conversion-Raten erheblich. Konfigurieren Sie Belohnungen so, dass beide Seiten einen klaren Wert sehen.

Social-Sharing-Integration

Ermutigen Sie Benutzer, ihren Empfehlungslink in sozialen Medien zu teilen, indem Sie vorformatierte Beitraege mit Tracking-Links und UTM-Parametern bereitstellen.

Belohnungsmissbrauch ueberwachen

Legen Sie angemessene Belohnungslimits fest und ueberwachen Sie auf verdaedchtige Muster (z. B. ein einzelner Benutzer, der viele Einladungen von derselben IP generiert). Das System protokolliert alle Einladungsaktivitaeten fuer Praefungen.

Haeufig gestellte Fragen

Wie erhalten Benutzer ihren Einladungscode? Der Einladungscode wird automatisch fuer jeden Benutzer bei der Registrierung generiert und in den Kontoeinstellungen unter /dashboard/account/invite angezeigt.

Koennen sich neue Benutzer ohne Einladungscode registrieren? Ja, die Registrierung ist fuer alle Benutzer offen. Einladungscodes bieten optionale Empfehlungsattribution und Belohnungen.

Wie werden Belohnungen ausgezahlt? Belohnungen werden als Guthabenpunkte auf die Konten des Einladenden und des neuen Benutzers gutgeschrieben. Credits koennen fuer Abonnementkaeufe oder andere Plattformfunktionen verwendet werden.

Was verhindert doppelte Belohnungen aus derselben Empfehlung? Das System verwendet idempotente Operationen — jeder Einladungscode kann nur einmal fuer eine Registrierung verwendet werden, was doppelte Auszahlungen verhindert.

Konfiguration

Belohnungsbetraege koennen im Admin-Dashboard unter /dashboard/admin/credits/invite-reward konfiguriert werden. Das Einladungssystem erfordert:

• Benutzerauthentifizierung (Einladende muessen angemeldet sein)
• E-Mail-Dienst fuer Einladungszustellung (optional, ueber das E-Mail-Marketing-Modul)
• Guthabensystem fuer Belohnungsauszahlungen

Es werden keine zusaetzlichen Umgebungsvariablen ueber die Standard-Plattformkonfiguration hinaus benoetigt.

Integrationspunkte

• Guthabensystem — Belohnungen werden als Guthabenpunkte mit idempotenter Verarbeitung ausgezahlt
• Authentifizierung — Neue Benutzer koennen waehrend der Registrierung mit automatischer Attribution eingeladen werden
• E-Mail-Marketing — Einladungs-E-Mails koennen ueber das E-Mail-Kampagnensystem gesendet werden
• Benutzerverwaltung — Verfolgen Sie Einladungskennzahlen pro Benutzer ueber das Admin-Dashboard
• Abrechnung — Eingeladene Benutzer koennen fuer spezielle Erste-Kauf-Rabatte qualifiziert sein