PPartnerDesk

40 — Auszahlungs-Workflow

Aktualisiert am 1. Juni 2026

40 — Auszahlungs-Workflow

PartnerDesk strukturiert Provisions-Auszahlungen in einem klaren vierstufigen Workflow. Jede Stufe ist nachvollziehbar im Audit-Log dokumentiert.

Die vier Status

draft ──approve──► approved ──pay──► paid
   │                  │              
   └─cancel──► cancelled
Status Bedeutung
draft Payout wurde gebildet (z. B. monatlich automatisch), Admin hat ihn aber noch nicht freigegeben. PDF wird mit „ENTWURF"-Wasserzeichen angezeigt.
approved Admin hat freigegeben. Final-PDF (ohne Wasserzeichen) wird generiert. Externe Gutschrift (easybill/lexoffice) wird angelegt. Partner bekommt eine Notification.
paid Auszahlung wurde durchgeführt (Banküberweisung, PayPal, Stripe-Connect-Transfer). Bankreferenz wird gespeichert.
cancelled Payout wurde storniert (selten — z. B. bei nachträglichem Refund einer enthaltenen TX).

Payouts erzeugen

Manuell (Einzel-Partner)

Admin → Partner-Detail → „Auszahlung erstellen". Wählen Sie:

  • Zeitraum (Periodenstart/-ende).
  • Mindestbetrag (optional).
  • „Auch 0-EUR-TX einbeziehen" (falls reine Lead-Boni ohne Sale enthalten sind).

Das System sammelt alle approved-Transactions des Partners im Zeitraum und legt einen Payout an.

Batch (alle aktiven Partner)

Admin → „Auszahlungen" → „Batch erstellen". Erzeugt für jeden aktiven Partner mit qualifizierten TX einen separaten Payout.

Über CLI

Für Automatisierung:

app:payouts:create-batch <tenant-slug> --period-start=YYYY-MM-DD --period-end=YYYY-MM-DD --min-amount=10.00

Kann via Cron monatlich aufgerufen werden.

Approval

Im Admin → „Auszahlungen" → Liste der draft-Payouts. Klick → Detail-Ansicht mit:

  • Gutschrift-PDF-Vorschau (mit ENTWURF-Wasserzeichen).
  • Klickbare TX-Liste (zur Verifikation).
  • „Freigeben"-Button → wechselt Status auf approved.

Nach Freigabe:

  1. Status draft → approved.
  2. Alle enthaltenen Transactions wechseln ebenfalls auf approved (falls noch nicht).
  3. Final-PDF wird generiert und im Storage abgelegt.
  4. Externe Gutschrift wird automatisch in der konfigurierten Buchhaltungs-Software (lexoffice/easybill) angelegt — falls konfiguriert. Läuft asynchron mit Retry. Status-Badge in der UI zeigt den Sync-Status.
  5. Partner-Notification wird ausgelöst („Gutschrift erstellt").

Details PDF: 41 — Gutschriften. Details externe Sync: 44 — Buchhaltung-Sync.

Auszahlung durchführen

Drei Methoden:

A) Banküberweisung manuell (SEPA-XML)

  1. Admin sammelt alle approved-Payouts.
  2. „SEPA-XML exportieren" → erzeugt eine pain.001.001.03-Datei.
  3. Datei in das Online-Banking hochladen → Banküberweisung.
  4. Nach Bestätigung: jeden Payout im Admin manuell als „bezahlt" markieren (Bankreferenz als Notiz).

B) PayPal manuell

Bei Partnern mit preferredPayoutMethod=paypal:

  1. Adresse aus Partner-Detail kopieren.
  2. PayPal-Überweisung manuell ausführen.
  3. „Als bezahlt markieren" mit PayPal-Transaktions-ID als Referenz.

C) Stripe Connect (automatisch)

Bei Partnern mit verbundenem Stripe-Connect-Account:

  1. Admin klickt „Per Stripe auszahlen".
  2. System ruft Stripe Transfer API mit der Idempotency-Key payout_<id>.
  3. Geld wandert vom Plattform-Account zum Partner-Stripe-Account.
  4. Stripe sendet später Webhook payout.paid → System markiert lokalen Payout als paid.

Details: 43 — Stripe Connect.

Mindestbeträge

Pro Partner kann ein Min-Payout-Amount konfiguriert werden (überschreibt Tenant-Default). Erreicht der Partner den Mindestbetrag in einer Periode nicht, wird kein Payout erzeugt — sein Saldo wird in den nächsten Lauf vorgetragen.

Storno

Wenn nach Approval ein Refund/Chargeback in einer enthaltenen Transaktion auftritt:

  • Die Transaktion wechselt automatisch auf refunded.
  • Der Payout bleibt formal approved — Admin entscheidet, ob er ihn manuell stornieren möchte.
  • Beim Storno wird die externe Gutschrift in lexoffice/easybill ebenfalls storniert (Credit-Note auf cancelled).

Partner-Sicht

Partner sehen unter „Auszahlungen":

  • Eigene Payouts mit Status-Badge.
  • PDF-Download der Gutschrift.
  • Liste der enthaltenen Transactions.

Auszahlungs-Statistiken

Im Admin-Portal:

  • Wieviel wurde insgesamt ausgezahlt.
  • Pro-Partner-Top-Liste.
  • Monatsverlauf.

Details: 101 — Erweiterte Statistiken.

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md (PayoutService), ../016-auto-external-credit-on-approval.md, ../018-async-accounting-sync.md