Zum Hauptinhalt springen

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.

Das Kundenportal ist ein sicherer, gehosteter Bereich, in dem Ihre Kunden Abonnements verwalten, Rechnungen einsehen und Lizenzschlüssel-Details abrufen können — ohne den Support kontaktieren zu müssen.

Create Portal Session (API)

Erstellen Sie programmatisch sichere, zeitlich begrenzte Portalsitzungen.

Subscriptions

Verwalten Sie wiederkehrende Pläne, Upgrades, Downgrades und Add-ons.

Neues Kundenportal mit aktiven Abonnements, Zahlungsmethoden und Rechnungshistorie

​
Was ist das Kundenportal?

Das Portal bietet eine vertrauenswürdige, markenbasierte Selbstbedienungserfahrung für Kunden, um:
  • Zugriff auf Abrechnungsverlauf: Rechnungen ansehen und Quittungen herunterladen.
  • Abonnements verwalten: Abonnementdetails anzeigen, Abonnements sofort oder zum nächsten Abrechnungsdatum kündigen.
  • Zahlungsmethoden aktualisieren: Zahlungsmethoden für aktive Abonnements ändern oder pausierte Abonnements reaktivieren.
  • Lizenzschlüssel abrufen: Zugriff auf alle Schlüssel, die an Einkäufe gebunden sind.
  • Leicht navigieren: Verwenden Sie die Zurück-Taste, um zwischen Portalabschnitten zu wechseln, ohne den Kontext zu verlieren.

​
Wichtige Vorteile

  • Weniger Supportanfragen: Kunden lösen häufige Abrechnungsanfragen selbst
  • Schnellere Wertschöpfung: Sofortiger Zugang zu Rechnungen und Schlüsseln
  • Reduziertes Abwanderungsrisiko: Klarer Einblick in Verlängerungen und Plandetails
  • Sicher nach Design: Tokenisierter Zugang mit ablaufenden Links
  • Lokalisierte Erfahrung: Portal ist in 21 Sprachen verfügbar, mit automatischer Erkennung basierend auf den Browser-Einstellungen des Kunden

​
Zugriffsarten

Kunden können das Portal entweder über einen statischen Link oder einen einmaligen dynamischen Link erreichen. Kunden können den Zugriff auf das Portal anfordern, indem sie ihre E-Mail an einem statischen Link eingeben, der niemals abläuft. Das Format des statischen Portal-Links variiert je nach Umgebung: Testmodus (für Tests und Entwicklung): 
https://test.customer.dodopayments.com/login/{business_id}
Live-Modus (für Produktion mit echten Transaktionen): 
https://customer.dodopayments.com/login/{business_id}
Ersetzen Sie {business_id} durch Ihre tatsächliche Geschäftskennung, und teilen Sie den entsprechenden Link mit Ihren Kunden, damit sie ihre E-Mail eingeben und sicheren Zugang zum Portal erhalten.
E-Mail-basierter Login-Bildschirm
1

Merchant flow

  1. Gehen Sie zu Sales → Customer.
  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 Static link.
  2. Geben Sie die beim Kauf verwendete E-Mail-Adresse ein.
  3. Erhalten Sie einen sicheren Login-Link, um auf das Portal zuzugreifen.
Bestehende Kunden werden automatisch erkannt.
Ein personalisierter, einmaliger Magic Link, der Kunden direkt ins Portal sendet. Der Link läuft nach 24 Stunden ab.
Dynamische Links laufen nach 24 Stunden ab. Wenn sie ablaufen, erstellen und senden Sie einen neuen Link.
Direkter Zugang über Magic Link
1

Merchant flow

  1. Gehen Sie zu Sales → Customer.
  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 Dynamic link.
  2. Greifen Sie direkt auf das Kundenportal zu, ohne eine E-Mail einzugeben.

​
Portal-Funktionen

Das überarbeitete Kundenportal bietet eine klare, einheitliche Oberfläche mit einer linken Seitenleiste und organisierten Abschnitten für alle Kontoverwaltungsanforderungen.

Active Subscriptions

Zeigen Sie alle aktiven Abonnements mit Planname, Preis, Verlängerungsdatum und Gültigkeit an. Klicken Sie auf “Manage subscription”, um Details anzuzeigen, Abrechnungsinformationen zu bearbeiten oder zu kündigen.

Payment Methods

Zeigen Sie alle gespeicherten Zahlungsmethoden (Karten, UPI usw.) auf einen Blick an. Bearbeiten Sie Zahlungsmethoden direkt aus den Abonnementdetails heraus.

Billing History

Zeigen Sie alle Transaktionen in einer detaillierten Tabelle mit Datum, Status, Preisart, Berechtigungen und herunterladbaren Rechnungen an.

Billing Information

Zeigen Sie auf der Seite mit den Abonnementdetails Ihren Namen, Ihre E-Mail-Adresse, Telefonnummer und Rechnungsadresse an und bearbeiten Sie diese direkt.

​
Portalübersicht

Die Hauptseite des Portals zeigt alle aktiven Abonnements, gespeicherten Zahlungsmethoden und den Abrechnungsverlauf in einer einzigen, scrollbaren Ansicht an.
Hauptseite des Kundenportals mit aktiven Abonnements und Zahlungsmethoden

​
Zahlungsmethoden & Abrechnungsverlauf

Scrollen Sie nach unten, um gespeicherte Zahlungsmethoden und den vollständigen Abrechnungsverlauf mit Statusanzeigen und herunterladbaren Rechnungen anzuzeigen.
Zahlungsmethoden und Rechnungshistorie mit Rechnung zum Herunterladen

​
Sprachunterstützung

Das Kundenportal ist in 21 Sprachen verfügbar, sodass Ihre Kunden ihre Abonnements, Zahlungsmethoden und Rechnungshistorie in der ihnen bequemsten Sprache verwalten können.

​
So funktioniert die Sprachauswahl

  • Automatische Erkennung: Beim ersten Besuch erkennt das Portal die bevorzugte Sprache des Kunden anhand der Browser-Einstellungen und lädt die entsprechende Übersetzung, wenn verfügbar. Englisch wird als Fallback verwendet.
  • Manuelle Überschreibung: Kunden können die aktive Sprache jederzeit über den Sprachwähler im Kopfbereich des Portals ändern (sowohl auf Desktop als auch mobil verfügbar).
  • Bevorzugte Einstellung speichern: Die ausgewählte Sprache wird im NEXT_LOCALE Cookie gespeichert (gültig für 1 Jahr), sodass das Portal die Auswahl über Sitzungen hinweg merkt.

​
Unterstützte Sprachen

SpracheCodeSpracheCode
Englisch (Standard)enIndonesischid
ArabischarItalienischit
KatalanischcaJapanischja
ChinesischzhKoreanischko
NiederländischnlMalaiischms
FranzösischfrPolnischpl
DeutschdePortugiesischpt
HebräischheRumänischro
RussischruSpanisches
SchwedischsvThailändischth
Türkischtr

​
Planänderungen (Upgrade/Downgrade)

Wenn Produkte in Produktkollektionen organisiert sind, können Kunden direkt über das Kundenportal zwischen Plänen upgraden oder downgraden.
Möchten Sie Upgrade/Downgrade für bestehende Abonnements aktivieren? Fügen Sie Ihre Abonnementprodukte zu einer Produktkollektion hinzu. Sobald gruppiert, können Kunden zwischen Plänen in derselben Kollektion über das Kundenportal wechseln.

​
Verfügbare Aktionen

AktionBeschreibungWann verfügbar
UpgradeWechsel zu einem höherwertigen Plan in derselben KollektionUnternehmen hat Abonnement-Updates aktiviert
DowngradeWechsel zu einem niedrigeren Plan in derselben KollektionUnternehmen hat Abonnement-Updates aktiviert

​
Wie Planänderungen funktionieren

  1. Kunde sieht sein aktuelles Abonnement im Portal
  2. Verfügbare Upgrade/Downgrade-Optionen werden basierend auf der Produktkollektion angezeigt
  3. Kunde wählt den neuen Plan aus
  4. Der Anteil wird berechnet und die Zahlung sofort (falls zutreffend) verarbeitet
  5. Das Abonnement wird auf den neuen Plan aktualisiert
Planänderungen sind nur zwischen Produkten innerhalb derselben Kollektion verfügbar. Produkte müssen Abonnement- oder verbrauchsgestützte Abrechnungsarten sein.

​
Geschäftskontrollen

Unternehmen können das Verhalten bei Planänderungen in den Abonnementeinstellungen konfigurieren:
  • Abonnement-Updates zulassen: Ermöglicht oder verbietet Kunden, ihre Abonnements zu verbessern oder herunterzustufen

Product Collections

Erfahren Sie, wie Sie Produktkollektionen einrichten und Upgrade/Downgrade-Pfade konfigurieren.

​
Abonnementdetails

Wenn Kunden auf “Abonnement verwalten” bei einem aktiven Abonnement klicken, gelangen sie zur Seite mit den Abonnementdetails. Diese Seite zeigt:
  • Plandetails: Abonnementname, Preis, Verlängerungsdatum und Gültigkeitszeitraum
  • Zahlungsmethode: Die Karte oder Zahlungsmethode, die dem Abonnement zugeordnet ist, mit einem “Bearbeiten”-Button
  • Rechnungsinformationen: Name, E-Mail, Telefonnummer und Rechnungsadresse mit einem “Bearbeiten”-Button
  • Rechnungshistorie: Eine detaillierte Tabelle aller Zahlungen für dieses Abonnement
  • Abonnement kündigen: Ein prominenter Button, um das Abonnement zu kündigen
Seite mit Abonnementdetails, die Planinformationen, Zahlungsmethode, Rechnungsinformationen und Kündigungsoption zeigt

​
Ein Abonnement kündigen

Kunden können ihr Abonnement direkt von der Seite mit den Abonnementdetails kündigen. Ein Klick auf “Abonnement kündigen” öffnet einen Bestätigungsdialog mit zwei Optionen:
  • Zum nächsten Abrechnungsdatum kündigen: Das Abonnement bleibt aktiv, bis der aktuelle Abrechnungszeitraum endet, und wird dann automatisch gekündigt.
  • Sofort kündigen: Das Abonnement wird sofort gekündigt.
Kündigungsdialog mit Optionen zum Kündigen zum nächsten Abrechnungsdatum oder sofort

​
Gründe für die Kündigung

Bevor die Kündigung bestätigt wird, werden Kunden gefragt „Warum kündigen Sie?“ und aufgefordert, einen Grund aus einer vorgegebenen Liste auszuwählen. Der Grund wird im Abonnement gespeichert und in Webhook-Payloads und der API angezeigt, sodass Sie Abwanderungsgründe analysieren und Ihre Rückgewinnungsstrategien anpassen können.
Kündigungsmodul mit dem Dropdown 'Warum kündigen Sie?' mit Gründen wie Zu teuer, Fehlende Funktionen und Sonstiges
WertKundenbezogenes Label
too_expensiveZu teuer
missing_featuresFehlende Funktionen
switched_serviceZu einem anderen Dienst gewechselt
unusedNicht genug genutzt
customer_serviceSchlechter Kundenservice
low_qualityNiedrige Qualität
too_complexZu komplex
otherSonstiges
Der ausgewählte Wert wird im cancellation_feedback Feld des Abonnements gespeichert. Ein optionaler Freitext cancellation_comment kann ebenfalls erfasst werden. 
// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"
Beide Felder sind auch in der subscription.cancelled Webhook-Payload enthalten, und Sie können sie programmatisch auf PATCH /subscriptions/{id} ausfüllen, wenn Sie eine Kündigung über die API planen oder ausführen.
Kombinieren Sie cancellation_feedback mit Subscription Dunning, um Rückgewinnungs-E-Mails maßzuschneidern – senden Sie beispielsweise einen Rabattcode an too_expensive Kündiger und eine „Was fehlt?“-Umfrage an missing_features Kündiger.

​
Aktualisierung von Zahlungsmethoden

Kunden können ihre Zahlungsmethoden direkt auf der Abonnement-Detailseite aktualisieren, indem sie neben der Zahlungsmethode auf „Bearbeiten“ klicken. Diese Funktion ist besonders wichtig, um Abonnements zu reaktivieren, die aufgrund fehlgeschlagener Zahlungen pausiert wurden.

​
Reaktivierung von pausierten Abonnements

Wenn ein Abonnement aufgrund einer fehlgeschlagenen Zahlung im on_hold Zustand ist, müssen Kunden ihre Zahlungsmethode aktualisieren, um es zu reaktivieren. Der Aktualisierungsprozess erstellt automatisch:
  1. Erstellung einer Gebühr für ausstehende Beträge
  2. Erstellung einer Rechnung für die Gebühr
  3. Verarbeitung der Zahlung mit der neuen Zahlungsmethode
  4. Reaktivierung des Abonnements in den active Zustand bei erfolgreicher Zahlung
Abonnements im on_hold Zustand werden nicht automatisch erneuert. Kunden müssen ihre Zahlungsmethode aktualisieren, um ausstehende Beträge zu begleichen und das Abonnement zu reaktivieren.
Nach erfolgreicher Aktualisierung der Zahlungsmethode für ein on_hold Abonnement sehen Kunden eine Bestätigungsseite und erhalten E-Mail-Benachrichtigungen über die erfolgreiche Zahlung und Abonnementreaktivierung.

​
Zahlungsaktualisierungsablauf

1

Access subscription details

Klicken Sie auf „Abonnement verwalten“ bei einem aktiven Abonnement von der Startseite des Portals.
2

Click Edit on payment method

Klicken Sie auf die Schaltfläche „Bearbeiten“ neben der Zahlungsmethode, um die Schnittstelle zur Zahlungsaktualisierung zu öffnen.
3

Select or add payment method

Wählen Sie eine vorhandene gespeicherte Zahlungsmethode aus oder fügen Sie eine neue hinzu, indem Sie Kartendaten sicher eingeben.
4

Confirm changes

Bestätigen Sie die Aktualisierung. Bei on_hold Abonnements wird dadurch automatisch eine Gebühr für ausstehende Beträge erstellt.
5

Complete payment (if on hold)

Wenn das Abonnement pausiert ist, werden Kunden weitergeleitet, um die Zahlung für ausstehende Beträge abzuschließen. Bei erfolgreicher Zahlung wird das Abonnement automatisch reaktiviert.
6

Confirmation

Kunden erhalten eine Bestätigung, dass die Zahlungsmethode aktualisiert wurde und, falls zutreffend, dass das Abonnement reaktiviert wurde.

​
Integrationsbeispiele

Erstellen Sie eine zeitgebundene Customer-Portal-Sitzung für einen bestimmten Kunden über die API und leiten Sie den Benutzer dann zur Sitzungs-URL weiter. 
const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

​
Einheitliches Kundenportal

Zusätzlich zu geschäftsspezifischen Kundenportalen bietet Dodo Payments ein Einheitliches Kundenportal auf customer.dodopayments.com an, wo Kunden alle ihre Einkäufe und Abonnements bei verschiedenen Unternehmen, die Dodo Payments verwenden, einsehen und verwalten können.
Einheitliches Kundenportal

​
Funktionen des Einheitlichen Portals

  • Geschäftsübergreifende Sichtbarkeit: Alle Einkäufe und Abonnements von jedem Dodo Payments-Händler an einem Ort einsehen
  • Zentrale Verwaltung: Abonnements bei verschiedenen Unternehmen von einem einzigen Dashboard aus verwalten
  • Einheitliche Rechnungsverlauf: Zugriff auf Rechnungen und Zahlungshistorie aller Einkäufe
  • Single Sign-on: Einmal mit E-Mail einloggen, um auf Einkäufe von allen Dodo Payments-Händlern zuzugreifen
Das Einheitliche Kundenportal ergänzt geschäftsspezifische Portale. Kunden können je nach Präferenz entweder das gebrandete Händlerportal oder das einheitliche Portal nutzen.

​
Fehlerbehebung

  • Link abgelaufen: Generieren und senden Sie einen neuen dynamischen Link.
  • E-Mail nicht erkannt: Bitten Sie den Kunden, die mit seinem Kauf verknüpfte E-Mail zu verwenden
  • Abonnement pausiert: Wenn ein Abonnement pausiert ist, müssen Kunden ihre Zahlungsmethode über das Portal aktualisieren, um ausstehende Beträge zu begleichen und das Abonnement zu reaktivieren. Der Aktualisierungsprozess berechnet automatisch die ausstehenden Beträge.
  • Aktualisierung der Zahlungsmethode fehlgeschlagen: Wenn die Zahlung während des Aktualisierungsprozesses für ein on_hold Abonnement fehlschlägt, bleibt das Abonnement pausiert. Kunden können es erneut mit einer anderen Zahlungsmethode versuchen.

Design & Theme Customization

Passen Sie das Erscheinungsbild Ihres Kundenportals mit vorgefertigten Themen, Typografie, Farben und Live-Vorschau von der Designseite an.
Last modified on May 14, 2026