Skip to main content
Das Customer Portal ist eine gehostete Website, auf der Ihre Kunden ihre Abonnements verwalten, Rechnungen anzeigen und herunterladen sowie Lizenzschlüssel abrufen können, ohne den Support zu kontaktieren.

Create Portal Session (API)

Erstellen Sie einen Portal-Link für einen Kunden, der 24 Stunden gültig ist.

Subscriptions

Wiederkehrende Pläne, Upgrades, Downgrades und Add-ons.
Überarbeitetes Customer Portal mit aktiven Abonnements, Zahlungsmethoden und Abrechnungshistorie

Was ist das Customer Portal?

Das Portal ist eine Self-Service-Website mit dem Namen Ihres Unternehmens, auf der Kunden Folgendes tun können:
  • Abrechnungshistorie aufrufen: Frühere Zahlungen anzeigen und Rechnungen herunterladen.
  • Abonnements verwalten: Abonnementdetails anzeigen, pausieren und fortsetzen sowie sofort oder zum nächsten Abrechnungstermin kündigen, je nach Ihren Einstellungen.
  • Zahlungsmethoden aktualisieren: Die Zahlungsmethode eines Abonnements ändern oder ein pausiertes Abonnement reaktivieren.
  • Lizenzschlüssel abrufen: Die mit ihren Käufen verknüpften Lizenzschlüssel anzeigen.
  • Zurück zu Ihrer App: Wenn Sie einen return_url übergeben, zeigt das Portal einen Zurück-Link zu Ihrem Unternehmen. Auf Mobilgeräten führt ein Zurück-Pfeil in der Kopfzeile zur Portalübersicht zurück.
Wenn Sie einen Kunden blockieren, wird sein Portal schreibgeschützt. Er kann sich weiterhin anmelden und Rechnungen, Abonnements und Lizenzschlüssel anzeigen, aber kein Abonnement kündigen, pausieren oder fortsetzen, keine Pläne ändern und keine Zahlungsmethode aktualisieren. Das Portalprofil gibt read_only: true zurück, sodass eine benutzerdefinierte Integration ihre eigenen Steuerelemente deaktivieren kann.

Wichtige Vorteile

  • Geringeres Supportaufkommen: Kunden erledigen häufige Abrechnungsanfragen selbst.
  • Schnellerer Zugriff: Kunden erhalten Rechnungen und Lizenzschlüssel direkt nach der Anmeldung.
  • Geringeres Abwanderungsrisiko: Kunden sehen Verlängerungsdaten und Plandetails, bevor sie belastet werden.
  • Signierte Links mit Ablaufdatum: Jeder Anmeldelink ist signiert und läuft nach 24 Stunden ab.
  • Lokalisierte Nutzung: Das Portal ist in 21 Sprachen verfügbar und wählt eine Sprache anhand der Browsereinstellungen des Kunden aus.

Zugriffsmethoden

Kunden erreichen das Portal über einen statischen oder dynamischen Link. Der statische Link läuft nie ab. Ein Kunde öffnet ihn, gibt seine E-Mail-Adresse ein und erhält einen Anmeldelink per E-Mail. Der statische Link hängt von der Umgebung ab: Test Mode (für Tests und Entwicklung):
Live Mode (für die Produktion mit echten Transaktionen):
Ersetzen Sie {business_id} durch Ihre Unternehmens-ID und teilen Sie den Link anschließend mit Ihren Kunden. Der statische Link im Dialog Einladung teilen enthält sie bereits.
Anmeldeseite mit E-Mail-Zugriff
1

Merchant Flow

  1. Gehen Sie zu Sales → Customers und öffnen Sie einen Kunden oder verwenden Sie die Spalte Invite in der Liste.
  2. Klicken Sie auf Share Invite.
  3. Kopieren Sie den Static Link und teilen Sie ihn mit Ihrem Kunden.
2

Customer Flow

  1. Öffnen Sie den statischen Link.
  2. Geben Sie die beim Kauf verwendete E-Mail-Adresse ein und klicken Sie auf Get Access Link.
  3. Öffnen Sie den per E-Mail gesendeten Anmeldelink. Er ist 24 Stunden gültig.
Die Seite zeigt immer dieselbe Bestätigung an. Dodo Payments sendet nur dann einen Link, wenn die Adresse zu einem Kunden Ihres Unternehmens gehört. Daher gibt die Seite nicht preis, wer Ihre Kunden sind.
Im Test Mode werden keine Anmelde-E-Mails versendet. Um ein Portal im Test Mode zu öffnen, verwenden Sie den Dynamic Link oder erstellen Sie über die API eine Session.
Ein dynamischer Link meldet einen Kunden direkt im Portal an, ohne E-Mail-Schritt. Er läuft 24 Stunden nach seiner Erstellung ab.
Ein dynamischer Link funktioniert nach 24 Stunden nicht mehr. Nach Ablauf sieht der Kunde eine Ablaufseite. Erstellen Sie einen neuen Link und senden Sie ihn erneut.
Direkter Zugriff über Magic Link
1

Merchant Flow

  1. Gehen Sie zu Sales → Customers und öffnen Sie den Kunden.
  2. Klicken Sie auf Share Invite.
  3. Kopieren Sie den Dynamic Link und teilen Sie ihn mit Ihrem Kunden.
2

Customer Flow

  1. Öffnen Sie den dynamischen Link.
  2. Das Customer Portal wird direkt ohne Eingabe einer E-Mail-Adresse geöffnet.

Portal-Funktionen

Die Portalübersicht ist eine einzelne Seite. Auf dem Desktop beschreibt ein Bereich auf der linken Seite das Portal. Im Hauptbereich werden die Abonnements, Zahlungsmethoden und die Abrechnungshistorie des Kunden aufgelistet.

Active Subscriptions

Jedes Abonnement zeigt seinen Plannamen, Preis, Verlängerungsdatum und seine Gültigkeit. Manage subscription öffnet die Details, in denen der Kunde Abrechnungsdaten bearbeiten, den Plan ändern, pausieren oder kündigen kann.

Payment Methods

Gespeicherte Zahlungsmethoden, etwa Karten mit ihrem Netzwerk und den letzten vier Ziffern, UPI, Wallets und Bankmethoden. Die Zahlungsmethode eines Abonnements kann auf dessen Detailseite geändert werden.

Billing History

Jede Zahlung in einer Tabelle mit Date, Status, Amount, Pricing Type, Entitlements und dem Download der Invoice.

Billing Information

Name, E-Mail-Adresse, Telefonnummer und Rechnungsadresse, die auf der Abonnement-Detailseite angezeigt werden. Kunden können den Namen und die Rechnungsadresse bearbeiten.

Portalübersicht

Die Übersichtsseite zeigt aktive Abonnements, gespeicherte Zahlungsmethoden und die Abrechnungshistorie in einer scrollbaren Ansicht.
Hauptseite des Customer Portal mit aktiven Abonnements und Zahlungsmethoden

Zahlungsmethoden und Abrechnungsverlauf

Weiter unten auf der Seite befinden sich die gespeicherten Zahlungsmethoden und die Abrechnungshistorie mit einem Status für jede Zahlung und einem Download-Link für jede Rechnung.
Zahlungsmethoden und Abrechnungsverlauf mit Rechnungsdownloads

Sprachunterstützung

Das Customer Portal ist in 21 Sprachen verfügbar, sodass Kunden Abonnements, Zahlungsmethoden und Abrechnungshistorie in ihrer eigenen Sprache verwalten können.

Funktionsweise der Sprachauswahl

  • Automatische Erkennung: Beim ersten Besuch liest das Portal die bevorzugte Sprache aus dem Browser aus und lädt sie, wenn sie unterstützt wird. Andernfalls wird Englisch verwendet.
  • Manuelle Überschreibung: Kunden können die Sprache jederzeit über die Sprachauswahl unten rechts auf der Seite ändern, auf Desktop- und Mobilgeräten.
  • Gespeicherte Präferenz: Das Portal speichert die Auswahl ein Jahr lang im NEXT_LOCALE-Cookie und merkt sich die Sprache bei weiteren Besuchen.

Unterstützte Sprachen

Tarifänderungen (Upgrade/Downgrade)

Kunden können im Portal zwischen Produkten derselben Product Collection upgraden oder downgraden.
Damit Kunden mit bestehenden Abonnements den Plan wechseln können, fügen Sie Ihre Abonnementprodukte zu einer Product Collection hinzu und aktivieren Sie Allow Subscription Updates. Kunden können dann im Portal zwischen den Plänen dieser Collection wechseln.

Verfügbare Aktionen

Funktionsweise von Tarifänderungen

  1. Der Kunde klickt auf der Abonnement-Detailseite auf Change Plan.
  2. Das Portal listet die anderen Pläne in der Product Collection auf.
  3. Der Kunde wählt einen Plan aus. Ein Bereich Confirm Plan Change zeigt den aktuellen und den aktualisierten Plan, eine Aufschlüsselung der Einzelpositionen (eine Gutschrift für den alten Plan und eine Belastung für den neuen), die Steuer und den jetzt fälligen Betrag. Der Kunde kann hier auch einen Rabattcode eingeben.
  4. Der Kunde bestätigt mit der Schaltfläche Pay, die den fälligen Betrag anzeigt.
  5. Dodo Payments berechnet die anteilige Gebühr und zieht den Betrag entweder über die gespeicherte Zahlungsmethode ein oder öffnet eine gehostete Checkout-Seite, wenn Sie Zahlungen für Planänderungen per Payment Link einziehen (siehe Zahlungen für Planänderungen per Payment Link einziehen).
  6. Das Abonnement wechselt zum neuen Plan. Ob dies sofort oder erst nach erfolgreicher Belastung geschieht, hängt von Ihrer Behandlung fehlgeschlagener Zahlungen ab. Eine per Payment Link bezahlte Planänderung wartet immer auf die Zahlung.
Seite mit Abonnementdetails und den Schaltflächen Change Plan, Pause Subscription und Cancel Subscription
Bereich Confirm Plan Change mit aktuellem und aktualisiertem Tarif, Aufschlüsselung der Einzelposten, Eingabe des Rabattcodes und Schaltfläche Pay
Planänderungen funktionieren nur zwischen Produkten derselben Collection. Das Zielprodukt muss ein Abonnement- oder nutzungsbasiertes Produkt sein. Einmalige Produkte werden abgelehnt.
Standardmäßig belastet eine sofortige Planänderung die gespeicherte Zahlungsmethode des Kunden. Wenn Collect Plan Change Payments by Payment Link aktiviert ist, öffnet das Portal stattdessen in einem neuen Tab eine gehostete Dodo Payments-Checkout-Seite, auf der der Kunde bezahlt. Dies gilt für Upgrades und Downgrades, die zu einer Belastung führen.
Seite Settings → Subscriptions mit aktivierter Option Collect Plan Change Payments by Payment Link und Tooltip mit Erläuterung des Verhaltens
Gehostete Dodo Checkout-Seite aus einem separaten Beispiel, auf der der Kunde eine Tarifänderung bezahlt
Das Abonnement bleibt auf seinem aktuellen Plan, bis die Checkout-Zahlung erfolgreich ist. Eine fehlgeschlagene oder abgebrochene Zahlung lässt das Abonnement unverändert; der Kunde kann es in derselben Checkout-Session erneut versuchen. Geplante Downgrades (effective_at: next_billing_date) durchlaufen keinen Checkout, sondern werden wie üblich am nächsten Abrechnungstermin angewendet.
Diese Einstellung gilt nur für sofortige Planänderungen. Solange ein Payment Link für eine Planänderung unbezahlt und nicht abgelaufen ist, lehnt das Portal weitere Anfragen zur Planänderung für dieses Abonnement ab.

Plan Change via Payment Link (API)

So fordern Sie mit collect_via_payment_link einen Payment Link an und verarbeiten die Antwort.

Einstellungen für Unternehmen

Konfigurieren Sie unter Settings → Subscriptions, was Kunden mit ihren Abonnements tun können:
  • Allow Subscription Updates: Ermöglicht Kunden Upgrades und Downgrades. Standardmäßig deaktiviert.
  • Allow Immediate Cancellation: Ermöglicht Kunden, ihr Abonnement zu beenden und den Zugriff sofort zu verlieren. Standardmäßig aktiviert.
  • Allow Cancellation at Next Billing Date: Ermöglicht Kunden, am Ende des bezahlten Zeitraums zu kündigen. Standardmäßig aktiviert.
  • Allow Subscription Pause: Ermöglicht Kunden, ihre eigenen Abonnements zu pausieren und fortzusetzen. Standardmäßig deaktiviert.
  • Collect Plan Change Payments by Payment Link: Leitet Kunden auf eine Checkout-Seite weiter, um eine sofortige Planänderung zu bezahlen, statt die gespeicherte Zahlungsmethode zu belasten. Standardmäßig deaktiviert.

Product Collections

Richten Sie Product Collections ein und konfigurieren Sie Upgrade- und Downgrade-Pfade.

Abonnementdetails

Manage subscription bei einem aktiven Abonnement öffnet dessen Detailseite mit folgenden Informationen:
  • Plandetails: Name, Preis, Verlängerungsdatum und Gültigkeitszeitraum des Abonnements.
  • Zahlungsmethode: Die Zahlungsmethode des Abonnements mit einer Schaltfläche Edit.
  • Abrechnungsinformationen: Name, E-Mail-Adresse, Telefonnummer und Rechnungsadresse mit einer Schaltfläche Edit für Name und Rechnungsadresse.
  • Abrechnungshistorie: Eine Tabelle aller Zahlungen für dieses Abonnement.
  • Pause Subscription: Wird angezeigt, wenn Sie die Self-Service-Pause erlauben.
  • Cancel Subscription: Öffnet den Kündigungsdialog.
Seite mit Abonnementdetails, Tarifinformationen, Zahlungsmethode, Abrechnungsinformationen und Kündigungsoption

Kündigen eines Abonnements

Kunden kündigen auf der Abonnement-Detailseite. Cancel Subscription öffnet einen Dialog mit zwei Optionen:
  • Cancel at next billing date: Das Abonnement bleibt bis zum Ende des aktuellen Abrechnungszeitraums aktiv und wird dann gekündigt.
  • Cancel now: Das Abonnement wird sofort gekündigt.
Zwei Einstellungen unter Settings → Subscriptions steuern diese Optionen getrennt: Allow Immediate Cancellation und Allow Cancellation at Next Billing Date. Beide sind standardmäßig aktiviert. Wenn Sie eine Einstellung deaktivieren, wird nur die jeweilige Option entfernt, sodass Sie eine Option ohne die andere anbieten können. Wenn beide deaktiviert sind, ist Cancel Subscription deaktiviert und der Tooltip fordert den Kunden auf, Sie zu kontaktieren. Ein Kunde mit einer bereits geplanten Kündigung sieht Revoke Cancellation, um das Abonnement fortzusetzen, sowie Cancel immediately, was dieselbe Aktion wie Cancel now ausführt. Diese Einstellungen wirken sich nicht auf Kündigungen aus, die Sie selbst vornehmen.
Dialog zum Kündigen eines Abonnements mit Optionen zur Kündigung am nächsten Abrechnungsdatum oder zur sofortigen Kündigung

Kündigungsgründe

Vor der Bestätigung muss der Kunde Why are you cancelling? beantworten, indem er einen Grund aus einer festgelegten Liste auswählt. Unter Additional comments kann er außerdem einen optionalen Kommentar mit bis zu 500 Zeichen hinzufügen. Dodo Payments speichert beides im Abonnement und gibt die Angaben in Webhook-Payloads und über die API zurück, sodass Sie analysieren können, warum Kunden kündigen, und gezielte Rückgewinnungsnachrichten erstellen können.
Kündigungsdialog mit dem Dropdown 'Why are you cancelling?' und Gründen wie Zu teuer, Fehlende Funktionen und Andere
Der Grund wird im Feld cancellation_feedback des Abonnements gespeichert, der Kommentar im Feld cancellation_comment.
Beide Felder befinden sich auch in der subscription.cancelled-Webhook-Payload. Um sie selbst festzulegen, übergeben Sie sie an PATCH /subscriptions/{subscription_id}, wenn Sie über die API kündigen oder eine Kündigung planen.
Verwenden Sie cancellation_feedback zusammen mit Subscription Dunning, um Rückgewinnungs-E-Mails gezielt anzupassen. Senden Sie beispielsweise einen Rabattcode an Kunden, die too_expensive ausgewählt haben, und eine Feedback-Umfrage an Kunden, die missing_features ausgewählt haben.

Pausieren eines Abonnements

Eine Pause bietet Kunden eine Möglichkeit zwischen dem Beibehalten und dem Kündigen eines Abonnements. Ein pausiertes Abonnement stoppt die Abrechnung, behält aber seinen Plan und seine Historie, sodass der Kunde es später fortsetzen kann, statt erneut zu kaufen. Kunden öffnen den Dialog Pause your subscription auf der Abonnement-Detailseite. Der Dialog zeigt den aktuellen Plan, weist darauf hin, dass der Zugriff sofort endet, und erklärt, wie sich die Abrechnungstermine verschieben. Der Kunde bestätigt mit Pause subscription.
Dialog zum Pausieren des Abonnements mit aktuellem Tarif, Warnung über den sofortigen Entzug des Zugriffs und Schaltfläche zum Bestätigen der Pause
Der Dialog informiert den Kunden über die Auswirkungen; das System verhält sich wie folgt:
  • Der Zugriff endet sofort. Funktionen, Downloads und im Abonnement enthaltene Lizenzschlüssel funktionieren erst wieder, wenn das Abonnement fortgesetzt wird.
  • Die Pause hat kein Enddatum. Das Abonnement bleibt pausiert, bis der Kunde es fortsetzt.
  • Keine bezahlte Zeit geht verloren. Der nächste Abrechnungstermin und das Verlängerungsdatum verschieben sich jeweils um die Dauer der Pause.
Das Fortsetzen erfolgt auf dieselbe Weise und wird mit Resume subscription bestätigt. Das Abonnement kehrt zu active zurück und der Zugriff wird wiederhergestellt.
Die Einstellung Allow Subscription Pause unter Settings → Subscriptions steuert die Self-Service-Pause und ist standardmäßig deaktiviert. Solange sie deaktiviert ist, können Kunden keine neue Pause beginnen, aber eine selbst gestartete Pause weiterhin fortsetzen. Von Ihnen im Dashboard gestartete Pausen sind davon nicht betroffen.

How Pausing Works

Vollständiges Verhalten beim Pausieren, einschließlich Auswirkungen auf die Abrechnung, Abrechnung der Nutzung und Webhooks.

Aktualisieren von Zahlungsmethoden

Kunden ändern die Zahlungsmethode eines Abonnements über Edit neben der Zahlungsmethode auf der Abonnement-Detailseite. Auf diese Weise kann ein Kunde auch ein nach einer fehlgeschlagenen Zahlung pausiertes Abonnement reaktivieren.

Reaktivieren zurückgehaltener Abonnements

Ein Abonnement wechselt zu on_hold, wenn eine Zahlung fehlschlägt. Das Portal zeigt Your subscription is currently on hold an und fordert den Kunden auf, seine Zahlungsmethode zu aktualisieren. Wenn er dies tut, führt Dodo Payments Folgendes aus:
  1. Erstellt eine Belastung für die noch offenen Beträge
  2. Erstellt eine Rechnung für die Belastung
  3. Zieht die Zahlung ein mit der neuen Zahlungsmethode
  4. Reaktiviert das Abonnement zu active, sobald die Zahlung erfolgreich ist
Ein Abonnement im Status on_hold wird nicht verlängert. Der Kunde muss seine Zahlungsmethode aktualisieren, um die offenen Beträge zu begleichen und das Abonnement zu reaktivieren.
Wenn die Beiträge für ein on_hold-Abonnement bezahlt sind, wird das Abonnement wieder active.

Reaktivieren von Abonnements in einer Kulanzfrist

Wenn Sie eine Kulanzfrist festlegen, wechselt eine fehlgeschlagene Verlängerung zu past_due statt zu on_hold. Der Kunde behält bis zum Ablaufdatum Zugriff. Die Wiederherstellung funktioniert auf dieselbe Weise: Der Kunde aktualisiert die Zahlungsmethode und das Abonnement kehrt zu active zurück. Wenn er nichts unternimmt, wechselt das Abonnement zum Ablaufdatum zu on_hold oder cancelled, wie von Ihnen konfiguriert, und der Zugriff endet.

Ablauf zur Aktualisierung der Zahlungsmethode

1

Access Subscription Details

Klicken Sie in der Portalübersicht beim Abonnement auf Manage subscription.
2

Click Edit on Payment Method

Klicken Sie neben der Zahlungsmethode auf Edit.
3

Select or Add Payment Method

Wählen Sie eine gespeicherte Zahlungsmethode aus oder klicken Sie auf Add Payment Method und geben Sie die neuen Daten ein.
4

Confirm Changes

Bestätigen Sie die Aktualisierung. Bei einem Abonnement im Status on_hold wird dadurch eine Belastung für die offenen Beträge erstellt.
5

Complete Payment (If On Hold)

Wenn das Abonnement pausiert ist, wird der Kunde zur Zahlung der offenen Beträge weitergeleitet. Sobald die Zahlung erfolgreich ist, wird das Abonnement reaktiviert.
6

Confirmation

Das Portal bestätigt, dass die Zahlungsmethode aktualisiert wurde und dass ein pausiertes Abonnement wieder aktiv ist.

Integrationsbeispiele

Um einen Kunden aus Ihrer App zum Portal zu senden, erstellen Sie auf Ihrem Server eine Portal-Session und leiten Sie den Kunden zum zurückgegebenen link weiter. Der Link ist 24 Stunden gültig.
Damit Dodo Payments den Link zusätzlich per E-Mail an den Kunden sendet, übergeben Sie send_email: true.

Unified Customer Portal

Neben dem Portal Ihres Unternehmens betreibt Dodo Payments ein Unified Customer Portal unter customer.dodopayments.com. Dort sehen und verwalten Kunden ihre Käufe und Abonnements bei allen Unternehmen, die über Dodo Payments verkaufen.
Unified Customer Portal

Funktionen des Unified Portals

  • Unternehmensübergreifende Übersicht: Käufe und Abonnements jedes Dodo Payments-Händlers an einem Ort anzeigen.
  • Zentrale Verwaltung: Abonnements bei verschiedenen Unternehmen über eine Website verwalten.
  • Einheitliche Abrechnungshistorie: Rechnungen und Zahlungshistorien aller Käufe aufrufen.
  • Einmalige Anmeldung: Sich einmal mit einer E-Mail-Adresse anmelden, um auf Käufe aller Dodo Payments-Händler zuzugreifen.
Das Unified Customer Portal funktioniert neben dem Portal Ihres Unternehmens. Kunden können beide verwenden.

Fehlerbehebung

  • Link abgelaufen: Erstellen Sie einen neuen dynamischen Link und senden Sie ihn an den Kunden.
  • E-Mail nicht erkannt: Bitten Sie den Kunden, die E-Mail-Adresse aus seinem Kauf zu verwenden. Für eine Adresse, die keinem Kunden Ihres Unternehmens gehört, wird keine Anmelde-E-Mail versendet.
  • Abonnement pausiert: Der Kunde aktualisiert seine Zahlungsmethode im Portal. Dodo Payments zieht die offenen Beträge ein und reaktiviert das Abonnement, sobald die Zahlung erfolgreich ist.
  • Aktualisierung der Zahlungsmethode fehlgeschlagen: Wenn die Zahlung beim Aktualisieren eines Abonnements im Status on_hold fehlschlägt, bleibt das Abonnement pausiert. Der Kunde kann es mit einer anderen Zahlungsmethode erneut versuchen.

Design & Theme Customization

Passen Sie das Portal über die Design-Seite mit vorgefertigten Themes, Typografie und Farben sowie einer Live-Vorschau an.
Zuletzt geändert am 26. September 2026