Einleitung
Für Händler mit Abonnementprodukten entscheidet die saubere Abbildung wiederkehrender Provisionen über Transparenz, Auszahlungen und Partnervertrauen. Affilentra Pro verbindet self‑hosted Affiliate‑Software mit Händlerprogrammen und bietet Rollen, Tracking sowie Provisions‑ und Abrechnungsfunktionen. Diese Anleitung zeigt praktisch, wie Sie in Affilentra Abo‑Events tracken, wiederkehrende Provisionsregeln einrichten, Proration bei Tarifwechsel korrekt behandeln und Churn‑ bzw. Retention‑Boni abrechnen.
1. Grundlage schaffen: Rollen, Produkt und Tracking‑IDs
Bevor Sie Regeln anlegen, prüfen Sie diese Basispunkte:
- Rollen anlegen: Softwarebetreiber (Admin), Händler (Merchant) und Partner (Affiliate). Stellen Sie sicher, dass Händler Zugriff auf ihre Programm‑Einstellungen haben.
- Produkt als Abo anlegen: Legen Sie in Affilentra für jedes Abo‑Produkt eine eindeutige Produkt‑/Subscription‑ID fest. Diese ID muss in den Tracking‑Events auftauchen, damit wiederkehrende Zahlungen dem richtigen Produkt/Partner zugeordnet werden können.
- Subscription‑ID im Payment‑Stack: Sorgen Sie dafür, dass Ihr Payment‑Provider bei jedem Charge‑Event die Subscription‑ID, Invoice‑ID und Transaktions‑ID mitsendet.
2. Recurring‑Events tracken: Welche Events brauchen Sie?
Mindestens diese Ereignisse sollten in Affilentra verarbeitet werden:
- initial_sale (erste Zahlung/Trial‑Conversion)
- subscription_payment (monatliche/jährliche wiederkehrende Zahlung)
- subscription_proration (Tarifwechsel/Teilgutschrift)
- subscription_cancelled / subscription_expired
- payment_failed / chargeback / refund
Praktisch setzen Sie das so um: Ihr Payment‑Provider sendet Webhooks an den Tracking‑Endpunkt der Plattform. Achten Sie auf folgende Felder im Payload: subscription_id, transaction_id, amount, currency, event_type, timestamp, invoice_id, customer_id und bei Tarifwechsel zusätzlich previous_plan / new_plan sowie prorated_amount oder proration_days.
3. Wiederkehrende Provisionsregeln konfigurieren
Gliedern Sie Provisionen nach drei Ebenen: Erstzahlung, Folgezahlungen, Sonderboni.
- Erstzahlung: Regel definieren für initial_sale (z. B. 30 % oder fester Betrag). Auszahlung erfolgt bei Validierung der Conversion.
- Monatliche/Jährliche Provisionen: Legen Sie eine wiederkehrende Regel fest, die bei jedem subscription_payment auslöst. Die Regel kann prozentual (z. B. 10 % pro Charge) oder als fester Betrag (z. B. 5 €/Monat) sein.
- Abhängigkeiten steuern: Unterschiedliche Raten für Trial→Paid‑Konversionen, Upgrades oder Downgrades ermöglichen. Nutzen Sie Produkt‑ und Tarif‑Metadaten, um Regeln granular zuzuweisen.
Technische Hinweise: Verwenden Sie die Subscription‑ID als Primary Key für die Zuordnung von Partnern. Speichern Sie bei Erstsale die Partnerzuordnung (z. B. via Trackinglink oder Coupon) in den Subscription‑Metadaten, damit Folgezahlungen automatisch dem richtigen Partner zugewiesen werden.
4. Proration bei Tarifwechsel korrekt behandeln
Tarifwechsel erzeugen oft Teilbeträge. Es gibt zwei praktikable Ansätze zur Berechnung der Provision:
- Amount‑basiert (empfohlen): Die Provision berechnet sich aus dem tatsächlich berechneten Betrag. Wenn der Zahlungsanbieter einen prorated_amount liefert, wird die Provisionshöhe = prorated_amount × commission_rate.
- Time‑basiert: Wenn Sie Provisionen strikt nach Nutzungszeit berechnen wollen, benötigen Sie proration_days oder period_lengths. Beispiel: Pro rata Commission = (days_active / total_days) × period_commission.
Um Proration sicher abzubilden, gehen Sie so vor:
- Der Payment‑Webhook für Tarifwechsel muss prorated_amount und Angaben zu previous_plan/new_plan enthalten.
- In Affilentra legen Sie eine Verarbeitungsregel an, die bei event_type = subscription_proration ausgelöst wird und die Provision basierend auf prorated_amount berechnet.
- Konfigurieren Sie Idempotenz: Prüfen Sie transaction_id und invoice_id, um doppelte Abrechnungen zu vermeiden.
Beispielrechnung: Kommissionssatz 10 %, prorated_amount = 15,00 € → Provision = 1,50 €. Dokumentieren Sie in der Transaktionshistorie die Basis (prorated_amount, previous_period, new_period) für Nachvollziehbarkeit.
5. Churn handling: Rückforderungen & Retention‑Boni
Ein sauberes Churn‑Management umfasst zwei Aspekte: Clawbacks (Rückforderungen) bei Storno/Refund und positive Anreize für Retention.
Clawbacks und Adjustments
- Bei refund, chargeback oder subscription_cancelled muss Affilentra eine Korrekturbuchung erzeugen: negative Provision oder Stornokennzeichnung.
- Richtlinie: Entscheiden Sie, ob beim Refund nur die letzte Provision storniert wird oder anteilig für mehrere Perioden. Implementieren Sie die Regel als automatisierte Adjustment‑Logik, die auf refund‑Events reagiert.
Retention‑Boni
- Retention‑Boni zahlen Sie, wenn ein Partner aktiv zur Kundenbindung beiträgt (z. B. Reaktivierung nach Kündigungswunsch, Upsell, erfolgreicher Support‑Intervention).
- Technische Umsetzung: Definieren Sie ein Auslöse‑Event retention_success (manuell oder automatisiert durch Ihr CRM/Support), das eine Bonuszahlung anstößt. Bonus kann fixer Betrag oder prozentual zur nächsten Charge sein.
- Staffeln: Zahlen Sie gestaffelte Boni, z. B. kleiner Bonus bei Verbleib >30 Tage, größerer Bonus bei >90 Tage.
6. Reconciliation, Reporting und Payouts
Richten Sie regelmäßige Abstimmungsprozesse ein:
- Exportieren Sie Transaktionslisten mit Subscription‑ID, Partner, Event‑Typ, Betrag, Provision und Status (paid/adjusted/pending).
- Prüfen Sie offene Items: fehlgeschlagene Zahlungen und ausstehende Rückforderungen müssen vor Auszahlung bereinigt werden.
- Nutzen Sie die Abrechnungsfunktion von Affilentra zur Erstellung von Auszahlungsposten. Legen Sie Auszahlungszyklen (monatlich, wöchentlich) fest und definieren Sie Mindestauszahlungsgrenzen.
7. Testing und Best Practices
- Testumgebung: Simulieren Sie alle relevanten Webhook‑Events (initial_sale, subscription_payment, proration, refund, cancel) und prüfen Sie die Resultate in der Partner‑Historie.
- Idempotenz: Prüfen Sie Transaktions‑IDs vor Buchung, um Duplikate zu vermeiden.
- Dokumentation: Speichern Sie Metadaten (z. B. original_invoice_id, coupon, Werbemittel) für spätere Prüfungen.
- Transparenz: Stellen Sie Partnern eine nachvollziehbare Auszahlungshistorie bereit (Trackinglinks, Perioden, Abzüge durch Refunds).
- Datenschutz & Compliance: Achten Sie auf Speicherung von Kundendaten gem. DSGVO und pseudonymisieren Sie, wenn möglich.
Fazit und Umsetzungsschritte
Affilentra Pro liefert die notwendige Infrastruktur, um Abonnements, Proration und Churn‑Logik self‑hosted abzubilden. Kurz zusammengefasst die nächsten Schritte:
- Produkt/Subscription‑IDs in Affilentra anlegen und Partnerzuordnung bei Erstkauf speichern.
- Webhook‑Integration mit dem Payment‑Provider implementieren und alle relevanten Felder senden (insb. subscription_id, transaction_id, prorated_amount).
- Provisionsregeln für Erstzahlung und wiederkehrende Zahlungen konfigurieren; Proration‑Events so verarbeiten, dass Provisionen auf prorated_amount basieren.
- Churn‑Adjustments und Retention‑Boni als ausgelöste Events einführen und automatisieren.
- Umfangreiche Tests durchführen und Reporting/Abstimmung für Auszahlungen einrichten.
Wenn Sie bereit sind, Ihr Affiliate‑Programm für Abonnements sicher und transparent zu betreiben, wählen Sie Ihren Einstieg: Einstieg wählen.
Nächster Schritt
Affilentra selbst ausprobieren
Einheitliche Plattform, die Produktbereitstellung, Tracking, Conversion-Validierung, Provisionsberechnung und Auszahlung entlang klar getrennter Rollen transparent zusammenführt; Option zur self-hosted Installation mit Dauerlizenz ohne Umsatzbeteiligung; Händler behalten Kontrolle über Produkte, Konditionen und Werbemittel; Partner erhalten persönliche Trackinglinks und nachvollziehbare Auszahlungshistorie.