PPartnerDesk

21 — Partner-Status & Lifecycle

Aktualisiert am 1. Juni 2026

21 — Partner-Status & Lifecycle

Jeder Partner durchläuft im System einen klar definierten Lebenszyklus. Status-Übergänge wirken sich auf Provisionsberechnung, Sichtbarkeit und Auszahlungen aus.

Die 7 Status

Status Bedeutung Berechnet Provisionen? Login möglich?
lead Auto-angelegter Lead aus Empfehlungs-Widget — noch nicht aktiviert Nein Nein
pending Selbst registriert oder von Admin angelegt, wartet auf Aktivierung Nein Nein (außer via Invite-Link)
active Voll aktiv, kann Sales generieren und Provisionen verdienen Ja Ja
suspended Vorübergehend gesperrt (z. B. wegen Compliance-Klärung) Nein — Downline-Provisionen werden in höhere Ebenen übersprungen Nein
terminated Endgültig gekündigt Nein Nein
deletion_pending Partner hat Lösch-Anfrage gestellt, 30-Tage-Wartefrist Nein Ja (zum Cancel-Klicken)
(anonymized) Nach Anonymisierung: technisch terminated + anonymized_at gesetzt Nein Nein

Übergänge

[Lead]                  ← Auto-Anlage durch Empfehlungs-Widget
   ↓ Erster Sale
[pending] → [active]    ← Klassische Anmeldung
   ↓                ↗ Cancel (innerhalb 30 Tage)
[active] ↔ [suspended]
   ↓
[terminated]            ← Endgültige Kündigung
   ↓ 30-Tage-Wartefrist
[deletion_pending] → anonymized

Übergangs-Trigger

Pending → Active

Drei Wege:

  • Self-Signup: Partner klickt den Bestätigungs-Link in der Welcome-Mail.
  • Invite: Partner klickt den Invite-Link und setzt Passwort.
  • Admin-Bestätigung: Admin setzt manuell auf active.

Active → Suspended

Admin-Aktion. Gründe (Empfehlung: im Notizfeld festhalten):

  • Compliance-Verstoß.
  • Rückerstattungs-Welle.
  • Verdacht auf Fraud.
  • Zahlungsausfall bei Auszahlung (z. B. Bankdaten falsch).

Während Suspension:

  • Existierende Sales-TX bleiben — werden aber nicht ausgezahlt (Payout kann erst nach Reactivation gemacht werden, optional).
  • Neue Webhook-Sales werden weiterhin verarbeitet, aber Downline-Provisionen (Sponsoren) überspringen diesen Partner — der nächste aktive Partner in der Kette bekommt nichts mehr (Stufe entfällt, kein „Skip-Forward").

Suspended → Active

Admin entscheidet, dass die Klärung erfolgreich war. Status wird zurückgesetzt.

Active → Terminated

Endgültiges Ende der Geschäftsbeziehung. Reine Sicherheitsmaßnahme — keine automatische Anonymisierung, weil Buchungsdaten erhalten bleiben müssen.

Deletion-Workflow (DSGVO Art. 17)

  1. Partner klickt im Portal „Konto löschen".
  2. Status wechselt auf deletion_pending.
  3. 30 Tage Wartefrist — Partner kann widerrufen.
  4. Daily-Scheduler prüft Wartefrist. Nach Ablauf: automatische Anonymisierung (siehe 93 — DSGVO).

Während der Wartefrist:

  • Login möglich (zum Cancel-Klicken).
  • Sales-TX werden weiterhin verarbeitet — der Partner ist nicht „suspended", sondern signalisiert nur seinen Lösch-Wunsch.

Effekt auf MLM

Der CommissionCalculator überspringt inaktive Partner — ohne die nächste Ebene nachrücken zu lassen:

D (Direkt, active)  → bekommt L1-Provision
C (Sponsor, SUSPENDED) → Provision entfällt
B (Sponsor des Sponsors, active) → bekommt regulär L3-Provision

C bekommt also keine, B bekommt trotzdem L3 (nicht L2). Damit wirkt eine Suspension exakt auf den einen Level und stört die Struktur nicht.

UI-Hinweise

Admin-Portal

  • Partners-Liste zeigt einen Status-Badge pro Zeile.
  • Filter in der Header-Bar nach Status.
  • Detail-View zeigt Status-Wechsel-History (sofern Audit-Log aktiv).

Partner-Portal

Partner sehen ihren eigenen Status nur indirekt:

  • pending → kann sich nicht einloggen.
  • active → normale Bedienung.
  • suspended → Hinweis „Konto vorübergehend gesperrt — bitte kontaktieren Sie uns".
  • deletion_pending → Banner mit Countdown bis Anonymisierung.

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md (Partner-Status-Enum), ../129-partner-deletion-workflow.md, ../034-gdpr-tools.md