> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Abo-Mahnverfahren

> Senden Sie automatisch E-Mail-Sequenzen, um abgelaufene oder gekündigte Abonnements wiederherzustellen, indem Sie Kunden dazu auffordern, ihre Zahlungsmethode zu aktualisieren.

<Info>
  Das Abo-Mahnverfahren sendet automatisch E-Mail-Sequenzen an Kunden, deren Abonnements aufgrund von Zahlungsfehlern oder Kundenkündigung abgelaufen sind, und fordert sie auf, ihre Zahlungsmethode zu aktualisieren und zu reaktivieren.
</Info>

## Was ist das Abo-Mahnverfahren?

Das Mahnverfahren erkennt automatisch, wenn ein Abonnement in einen wiederherstellbaren Zustand übergeht, und sendet eine Sequenz von E-Mails, die den Kunden zur Handlung auffordern:

* **Angehaltene Abonnements**: Erneuerungszahlung fehlgeschlagen (unzureichende Mittel, abgelaufene Karte usw.)
* **Gekündigte Abonnements**: Kunde hat über das Kundenportal gekündigt

## Wie funktioniert das Mahnverfahren

<Steps>
  <Step title="Trigger">
    Das Mahnverfahren wird ausgelöst, wenn ein Abonnement einen der beiden Zustände erreicht:

    * **Angehalten**: Eine Erneuerungszahlung ist fehlgeschlagen (unzureichende Mittel, abgelaufene Karte usw.)
    * **Gekündigt**: Der Kunde hat sein Abonnement über das Kundenportal gekündigt
  </Step>

  <Step title="Email Sequence">
    Abhängig vom Auslösezustand sendet das System bis zu 4 Mahn-E-Mails in konfigurierten Abständen. Jede E-Mail enthält einen Link zum Kundenportal, wo der Kunde seine Zahlungsmethode aktualisieren oder das Abonnement erneut kaufen kann.
  </Step>

  <Step title="Recovery">
    Wenn der Kunde seine Zahlungsmethode über das Kundenportal aktualisiert, wird automatisch eine Belastung für verbleibende offene Beträge erstellt. Wenn die Zahlung erfolgreich ist, wird das Abonnement reaktiviert und der Mahnversuch als wiederhergestellt markiert.
  </Step>
</Steps>

## Status-Lebenszyklus

| Status       | Beschreibung                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------ |
| `recovering` | Mahnversuch ist aktiv; E-Mails werden gesendet                                                   |
| `recovered`  | Kunde hat Zahlungsmethode aktualisiert und Zahlung war erfolgreich                               |
| `exhausted`  | Alle E-Mails gesendet ohne Wiederherstellung oder Abonnementzustand hat sich unerwartet geändert |

<Info>
  Wenn ein Mahnversuch als `exhausted` markiert wird, wird der Abonnementzustand nicht geändert. Das Abonnement bleibt in seinem aktuellen Zustand (angehalten oder gekündigt).
</Info>

## Konfiguration des Mahnverfahrens

Aktivieren und konfigurieren Sie das Mahnverfahren über **Einstellungen** in Ihrem Dashboard.

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="Mahnverfahrenseinstellungen-Seite mit Aktivierungsschalter, vier on-hold E-Mails im Intervall von 1, 3, 5 und 7 Tagen und vier gekündigte E-Mails im selben Intervall" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### E-Mail-Sequenzen

Das Mahnverfahren unterstützt zwei E-Mail-Sequenzen — **Angehalten** und **Gekündigt** — jede mit bis zu 4 konfigurierbaren E-Mails.

Jede E-Mail hat folgende konfigurierbare Felder:

| Einstellung     | Beschreibung                                                    |
| --------------- | --------------------------------------------------------------- |
| **Aktiviert**   | Schalten Sie einzelne E-Mails ein oder aus, ohne sie zu löschen |
| **Verzögerung** | Wann die E-Mail nach dem Auslöseereignis gesendet wird          |
| **Betreff**     | Betreffzeile der E-Mail mit variablen Platzhaltern              |
| **Inhalt**      | HTML-E-Mail-Inhalt mit variablen Platzhaltern                   |
| **Antwort an**  | E-Mail-Adresse für Kundenantworten                              |

**Standardzeitplan der E-Mails:**

| Sequenz    | E-Mail Nr. | Standardverzögerung |
| ---------- | ---------- | ------------------- |
| Angehalten | 1          | 1 Tag               |
| Angehalten | 2          | 3 Tage              |
| Angehalten | 3          | 5 Tage              |
| Angehalten | 4          | 7 Tage              |
| Gekündigt  | 1          | 1 Tag               |
| Gekündigt  | 2          | 3 Tage              |
| Gekündigt  | 3          | 5 Tage              |
| Gekündigt  | 4          | 7 Tage              |

### Beispiel-Mahn-E-Mails

Das Mahnverfahren sendet unterschiedliche E-Mails je nach Abonnementstatus. Unten sind Beispiele für jeden Typ, wie sie vom Kunden gesehen werden.

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="Mahn-E-Mail für ein angehaltenes Abonnement mit Geschäftsname, Nachricht über fehlgeschlagene Zahlung, Abonnementdetails mit Plan und Betrag und einem Button zum Aktualisieren der Zahlungsmethode" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="Mahn-E-Mail für ein gekündigtes Abonnement mit Geschäftsname, Nachricht über die Kündigung, Abonnementdetails mit Plan und Betrag und einem Button zum erneuten Kauf des Abonnements" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## Kundenerfahrung der Wiederherstellung

Wenn ein Kunde auf den Link in einer Mahn-E-Mail klickt, wird er zum Kundenportal geleitet, wo er den Status seines Abonnements sehen und seine Zahlungsmethode aktualisieren kann.

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="Kundenportal, das ein angehaltenes Abonnement für Pro Plan zu $95,00/Jahr mit einem Button zum Aktualisieren der Zahlungsmethode und einem Warnhinweis über die fehlgeschlagene Zahlung anzeigt" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

Nachdem der Kunde seine Zahlungsmethode aktualisiert hat, wird automatisch eine Belastung für eventuell offene Beträge erstellt. Wenn die Zahlung erfolgreich ist, wird das Abonnement sofort reaktiviert.

Für ein gekündigtes Abonnement wird der Kunde auf eine Checkout-Seite geleitet, die das Abonnement bereits als Produkt hinzugefügt hat.

## Analysen

Verfolgen Sie die Leistung des Mahnverfahrens über den **Wiederherstellungs**-Tab im **Analysen**-Bereich Ihres Dashboards.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="Wiederherstellungsanalysen-Dashboard, das die Anzahl der Mahnverfahren, Erfolgsraten, wiedererlangte Einnahmen und eine Leistungsübersicht nach E-Mails anzeigt" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| Metrik                             | Beschreibung                                                                    |
| ---------------------------------- | ------------------------------------------------------------------------------- |
| **Mahn-Eintragungen**              | Gesamtanzahl der erstellten Mahnversuche                                        |
| **Erfolgsrate**                    | Prozentsatz der Mahnversuche, die zur Wiederherstellung führten                 |
| **Wiedererlangte Einnahmen**       | Gesamte Einnahmen, die durch das Mahnverfahren wiederhergestellt wurden         |
| **Wiederherstellung nach Versuch** | Aufschlüsselung, welche E-Mail in der Sequenz zur Wiederherstellung geführt hat |

## Webhook-Ereignisse

| Ereignis            | Beschreibung                                                   |
| ------------------- | -------------------------------------------------------------- |
| `dunning.started`   | Ein Mahnversuch wurde für ein Abonnement gestartet             |
| `dunning.recovered` | Ein Abonnement wurde durch das Mahnverfahren wiederhergestellt |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  Die vollständigen Webhook-Payload-Schemata für Mahn-Ereignisse anzeigen.
</Card>

## Sonderfälle

| Szenario                                                            | Verhalten                                                                       |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Kunde aktualisiert Zahlungsmethode, bevor eine E-Mail gesendet wird | Wiederherstellung wird erkannt; Mahnversuch wird als wiederhergestellt markiert |
| Kunde kauft ein weiteres Abonnement vom selben Unternehmen          | Mahnversuch wird als erschöpft markiert                                         |
| Alle Mahn-E-Mails erschöpft                                         | Mahnversuch wird als erschöpft markiert; Abonnementzustand wird nicht geändert  |

## Beste Praktiken

* **Mit Standards beginnen**: Der Standardzeitplan der E-Mails ist mit angemessenen Abständen (1, 3, 5 und 7 Tage) gestaltet, um Kunden nicht zu überfordern und zugleich Dringlichkeit zu bewahren.
* **Erfolgsraten überwachen**: Verfolgen Sie, welche E-Mail in der Sequenz die meisten Wiederherstellungen bewirkt. Wenn spätere E-Mails nahezu keine Konversion aufweisen, erwägen Sie, diese zu deaktivieren.
* **Mit dem Support koordinieren**: Stellen Sie sicher, dass Ihr Support-Team darüber informiert ist, dass Mahn-E-Mails gesendet werden, damit sie Kunden, die sich melden, unterstützen können.
* **Abonnementzustände überprüfen**: Kombinieren Sie das Mahnverfahren mit `subscription.on_hold` und `subscription.cancelled` Webhooks für umfassendes Lebenszyklus-Tracking.

<Info>
  Das Mahnverfahren funktioniert neben den bestehenden Prozessen zur Pausierung und Reaktivierung von Abonnements im Kundenportal. Einmal aktiviert, läuft es automatisch ohne zusätzliche Integration.
</Info>

## Verwandtes

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    Reagieren Sie auf `dunning.started` und `dunning.recovered` Ereignisse.
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    Unvollständige oder fehlgeschlagene einmalige Checkouts mit gezielten E-Mails wiederherstellen.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    Kunden aktualisieren Zahlungsmethoden über das Kundenportal.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Abonnementzustände verstehen, die Mahn-Workflows auslösen.
  </Card>
</CardGroup>
