PPartnerDesk

11 — Provisionsmodelle (Tiers & Gruppen)

Aktualisiert am 1. Juni 2026

11 — Provisionsmodelle (Tiers & Gruppen)

PartnerDesk unterstützt drei Provisionstypen, kombinierbar mit Volumen-Staffeln und Subscription-Modi. Die Logik ist auf Level konsequent flexibel — ein Tier pro Level einer Kampagne oder Gruppe.

Drei Provisions-Typen

percentage — Prozentual

Provision = nettobetrag × rate / 100.

Beispiel: Tier hat rate=20.00 → bei 100 € netto fließen 20 € Provision.

fixed — Fester Betrag

Provision = fixedAmount, unabhängig vom Verkaufsbetrag.

Beispiel: 5 € pro Conversion, egal ob 50 € oder 500 € umgesetzt wurden.

hybrid — Prozent + Sockel

Provision = MAX(nettobetrag × rate / 100, fixedAmount).

Beispiel: 10 % oder mindestens 8 € — bei 50 € netto wird der Sockel (8 €) gezahlt, ab 80 € der prozentuale Anteil.

Volumen-Staffel

Pro Tier kann eine Staffel definiert werden: erreicht ein Partner einen monatlichen Mindestumsatz, gilt ein höherer Tarif.

Beispiel:

Monatsumsatz erreicht Rate
0 € 15 %
5.000 € 18 %
10.000 € 22 %

Die Staffel wird pro Sale neu evaluiert (aktueller Monatsumsatz des Partners). Damit wirkt ein Tarif-Sprung sofort, sobald die Schwelle überschritten wird.

Subscription-Modi

Für wiederkehrende Zahlungen (Abos):

Modus Wann zahlt der Tier eine Provision?
first_payment Nur beim ersten Zahlungsereignis (Initial-Sale).
recurring Bei jedem Folge-Zahlungsereignis (Standard).
lifetime Bei jedem Ereignis, lebenslang — Standard für lebenslange Provisionen.

Bei einer Folge-Zahlung im Abo-Modell setzt das Webhook-Subsystem isRecurring=true und recurringNumber=N. Der CommissionCalculator wählt nur Tiers, deren Subscription-Modus auf diese N-te Zahlung greift.

Tier-Auflösungs-Reihenfolge

Wenn ein Sale verarbeitet wird, sucht der CommissionCalculator für jeden MLM-Level den passenden Tier in dieser Reihenfolge:

  1. Partner-CommissionGroup: ist der Partner einer Gruppe zugeordnet → die Gruppe liefert den Tier für Level X.
  2. Campaign-Default-Group: hat die Kampagne eine Default-Gruppe → deren Tier.
  3. Partner-Tier-Override (Legacy): falls direkt am Partner ein Tier hängt.
  4. Campaign-Tier (Legacy): Tier direkt an der Kampagne, ohne Gruppe.
  5. Tenant-Default: globaler Fallback (Tier ohne Campaign, isDefault=true).

Findet sich keiner → keine Provision für dieses Level.

CommissionGroups einsetzen

CommissionGroups bündeln einen Tier-Set für eine bestimmte Partner-Klasse. Praktisches Beispiel:

Setup

  • Kampagne: „Hauptprodukt"
  • Gruppe „Premium-Partner":
    • L1: 30 %
    • L2: 8 %
    • L3: 3 %
    • Cookie-Lifetime: 90 Tage
  • Gruppe „Standard-Partner" (Default):
    • L1: 20 %
    • L2: 5 %
    • L3: 2 %
    • Cookie-Lifetime: 30 Tage
  • Gruppe „Top-Affiliate" (extern):
    • L1: 35 %
    • Cookie-Lifetime: 60 Tage

Partner-Zuweisung

  • Top-Performer werden in „Premium-Partner" verschoben.
  • Neue Anmeldungen landen automatisch in „Standard-Partner" (Default-Gruppe).
  • Strategische externe Affiliates kommen in „Top-Affiliate".

Damit haben Sie ein flexibles Modell ohne Kampagnen-Multiplikation.

Wann werden Provisionen erstellt?

Die Provision wird bei der Webhook-Verarbeitung des Sales berechnet und als Transaction mit commissionAmount persistiert. Beim Approval der TX bleibt der Wert unverändert — Admin kann aber „Recalculate" auslösen, wenn sich Tier-Werte zwischenzeitlich geändert haben.

MLM-Folge-Transaktionen

Bei einer Kampagne mit commission_levels > 1 werden mehrere Transactions pro Sale erzeugt:

  • Level 1 = Direkt-Partner.
  • Level 2 = referrer des Direkt-Partners (= sein Sponsor).
  • Level 3 = Sponsor des Sponsors.
  • … bis maximal 10 oder bis referrer = null.

Jede MLM-TX hat den externalTransactionId der Basis-TX mit Suffix _L<level> — damit ist die Verkettung sauber idempotent.

Details: 12 — MLM-Struktur.

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md (CommissionTier), ../076-pap-import-commission-groups.md (CommissionGroup), ../019-default-template-and-resync.md (Calculator-Tests)