Skip to main content
Produkte bilden die Grundlage von Dodo Payments. Unabhängig davon, ob Sie einen einmaligen Download, ein wiederkehrendes Abonnement oder einen nutzungsbasierten Zugriff verkaufen: Sie beginnen mit der Erstellung eines Produkts. Jedes Produkt legt fest, wie es bepreist, beim Checkout präsentiert und nach dem Kauf bereitgestellt wird.

One-Time

Berechnen Sie einmalig für lebenslangen Zugriff oder eine einzelne Leistung.

Subscriptions

Rechnen Sie nach einem Zeitplan mit Testphasen, anteiliger Abrechnung und Add-ons ab.

Usage-Based

Messen Sie den Verbrauch und rechnen Sie nach der tatsächlichen Nutzung ab.

​
Produkt erstellen

Erstellen Sie Produkte über das Dashboard oder per API. Wählen Sie das Preismodell im Voraus – One-Time, Subscription oder Usage-Based – und konfigurieren Sie anschließend die Details. Das Preismodell ist unveränderlich. Erstellen Sie ein neues Produkt, wenn Sie ein anderes Modell benötigen.
1

Name and Description

Geben Sie einen klaren Titel und eine prägnante, nutzenorientierte Beschreibung an. Markdown wird in Beschreibungen unterstützt.
Formulieren Sie den ersten Satz aus Kundensicht und ergebnisorientiert. Er wird beim Checkout prominent angezeigt.
Produkt-Dashboard mit Formular zur Produkterstellung
2

Pricing Model and Price

Wählen Sie das Preismodell:
  • One-Time: Einmalig gezahlter Festpreis.
  • Subscription: Wiederkehrender Preis mit Intervall und optionaler Testphase.
  • Usage-Based: Preis, der aus gemessenen Ereignissen abgeleitet wird.
Legen Sie dann die Preise fest:
  • Price: Basisbetrag und Währung. Sie können den Basispreis in jeder von Dodo Payments unterstützten Währung festlegen, außer bei Pay What You Want-Produkten, deren Basiswährung USD, GBP oder EUR sein muss. USD, GBP, EUR und INR sind für den schnellen Zugriff oben im Währungsselektor angeheftet.
  • Discount (%): Optionaler prozentualer Rabatt, der beim Checkout und auf Rechnungen angezeigt wird.
  • Legen Sie bei Abonnements Repeat every (z. B. 1 Monat oder 1 Jahr), Trial days und optional Trial amount für eine bezahlte Testphase fest. Ein nicht nuller Abonnementpreis muss mindestens $1 betragen (oder dem Gegenwert in der gewählten Währung entsprechen). Ein Preis von genau $0 wird ebenfalls unterstützt. Sie können Kunden erlauben, ein $0-Abonnement ohne Karte zu starten. Siehe Card-Optional at Zero Price. Negative Beträge werden nicht unterstützt.
Wenn Adaptive Currency aktiviert ist, werden Kunden außerhalb Ihrer Basiswährung in ihrer lokalen Währung abgerechnet. So können Sie Preise in der Währung festlegen, die am besten zu Ihrem Markt passt. Ist die Funktion deaktiviert, zahlen Kunden in Ihrer Basiswährung.
Möchten Sie statt einer dynamischen FX-Umrechnung einen festen Preis pro Währung oder Land? Setzen Sie pricing_mode für das Produkt und fügen Sie Regeln für Localized Pricing hinzu, etwa 9,99 € in EUR oder ₹999 in Indien.
Wenn Sie einen Preis bearbeiten, ändert sich der Betrag, den neue Kunden zahlen. Bestehende Abonnements werden niemals neu bepreist; jedes behält den Preis, mit dem es erstellt wurde. Um einen bestehenden Abonnenten auf einen anderen Preis umzustellen, ändern Sie seinen Plan ausdrücklich über die Change Plan API. Einstellungen für die anteilige Abrechnung gelten für diese Planänderung, nicht für Preisänderungen.
3

Product Media

Laden Sie Bilder hoch, um das Produkt beim Checkout und auf Rechnungen zu präsentieren. Unterstützte Formate: PNG, JPG und WebP, bis zu 3 MB. Sie können Bilder jederzeit neu anordnen oder ersetzen.
4

Automated Entitlements

Fügen Sie im Abschnitt Entitlements Fulfillment hinzu, das nach der Zahlung automatisch aktiviert wird:
  • License Keys: Eindeutige Schlüssel ausstellen und validieren.
  • File Downloads: Sicheren Dateizugriff gewähren.
  • Custom: Ihre eigene Entitlement-Logik über Webhooks auslösen.
Fügen oder entfernen Sie Vorteile, wenn sich Ihr Angebot weiterentwickelt. Bestehende Abonnenten erhalten oder verlieren entsprechend den Zugriff.

​
Varianten und Preisoptionen

Erstellen Sie statt Varianten unter einem Produkt separate Produkte für jede Preisoption (z. B. Monthly und Yearly). Gruppieren Sie diese anschließend in einer Product Collection, um alle Optionen in einem einzigen Checkout zu präsentieren und den Planwechsel im Customer Portal zu ermöglichen.
Checkout-Seite mit mehreren Produktoptionen in einer Sammlung

​
Warum dieser Ansatz?

  • Klare Preismodelle: Jedes Produkt verfügt über ein einzelnes, klar definiertes Preismodell (einmalig, Abonnement oder nutzungsbasiert).
  • Vorhersehbare APIs: Einfachere Integrationen ohne verschachtelte Variantenlogik.
  • Einfachere Berichte: Verfolgen Sie Umsatz und Kennzahlen pro Produkt, ohne Varianten aggregieren zu müssen.
  • Flexibler Checkout: Zeigen Sie mehrere Produkte nebeneinander an, damit Kunden sie vergleichen und auswählen können.

​
So funktionieren Product Collections

  1. Produkte erstellen: Richten Sie einzelne Produkte für jeden Plan ein (z. B. Starter Monthly, Starter Annual, Pro Monthly, Pro Annual).
  2. In einer Collection gruppieren: Fügen Sie verwandte Produkte zu einer Product Collection hinzu.
  3. Einheitlicher Checkout: Kunden sehen alle Optionen in einem Checkout und wählen ihren bevorzugten Plan aus.
  4. Planwechsel: Kunden können über das Customer Portal zwischen Produkten derselben Collection upgraden oder downgraden.

Product Collections

Gruppieren Sie verwandte Produkte, um einheitliche Checkout-Erlebnisse sowie Upgrade- und Downgrade-Pfade zu ermöglichen.

​
Produkte verwalten

Sie können Produkte über das Dashboard oder programmgesteuert über die API verwalten. Die API bietet vollständige Kontrolle über das Erstellen, Aktualisieren und Abrufen von Produkten, das Hochladen von Bildern sowie das Archivieren.

​
Verwaltung über das Dashboard

  • Update: Bearbeiten Sie Name, Beschreibung, Bilder, Preis, Felder und Vorteile jederzeit (das Preismodell ist unveränderlich).
  • Archive: Blenden Sie ein Produkt für neue Käufe aus, ohne bestehende Kunden zu beeinträchtigen. Sie können es später wiederherstellen.
  • Drafts: Ein Produkt in Bearbeitung wird als Entwurf gespeichert, damit Sie später darauf zurückkommen können. Entwürfe werden für den Testmodus und den Live-Modus getrennt gespeichert. Ein unfertiges Produkt in einem Modus wirkt sich daher niemals auf den anderen aus. Verwenden Sie Clear Draft, um den Entwurf zu verwerfen und neu zu beginnen.
Produkt- und Collection-Formularseiten enthalten Aktionsschaltflächen im Header, sodass Sie speichern können, ohne zum Ende eines langen Formulars zu scrollen.

​
Verwaltung über die API

Mit den folgenden Anweisungen können Sie Produkte erstellen, aktualisieren, verwalten und abrufen, einschließlich des Hochladens von Bildern.
Senden Sie eine POST-Anfrage an den /products-Endpunkt. Geben Sie dabei Details wie Name, Beschreibung, Preis, Währung und an, ob es sich um ein wiederkehrendes Produkt handelt.Legen Sie bei wiederkehrenden Produkten das Objekt price auf einen wiederkehrenden Preis (type: recurring_price) fest und geben Sie payment_frequency_interval sowie subscription_period_interval (Day, Week, Month oder Year) zusammen mit den entsprechenden Anzahlen an.

Create Product API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Create Product API.
Senden Sie eine PATCH-Anfrage an den /products/{product_id}-Endpunkt. Sie können Eigenschaften wie Name, Preis und Beschreibung aktualisieren, während andere Details unverändert bleiben.Stellen Sie sicher, dass product_id im Endpunkt mit einem bestehenden Produkt übereinstimmt.

Update Product API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Update Product API.
Rufen Sie mit einer GET-Anfrage an den /products-Endpunkt eine Liste der in Ihrem Konto gespeicherten Produkte ab. So können Sie Produktdetails einschließlich aktiver und archivierter Produkte abrufen.

Retrieve Products API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Retrieve Products API.
Verknüpfen Sie ein Bild mit einem Produkt, indem Sie es über eine von der API bereitgestellte vorab signierte URL in AWS S3 hochladen. Fordern Sie zunächst eine URL zum Hochladen eines Bildes über den /products/{product_id}/images-Endpunkt an und verwenden Sie anschließend die bereitgestellte URL, um das Bild innerhalb von 60 Sekunden hochzuladen.
Die vorab signierte URL läuft nach 60 Sekunden ab. Das Bild muss daher innerhalb dieses Zeitraums hochgeladen werden.
Sobald Sie die vorab signierte URL von der API erhalten haben, laden Sie das Bild mit der PUT-Methode hoch. Dadurch wird ein sicherer und zeitlich begrenzter Zugriff auf AWS S3 zum Hochladen des Bildes gewährleistet.Unterstützte Bibliotheken für das Hochladen in S3:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Wenn der Upload erfolgreich ist, gibt AWS S3 den Status 200 OK zurück. Dies bedeutet, dass das Bild erfolgreich gespeichert wurde.

Upload Product Image API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Upload Product Image API.
Blenden Sie ein Produkt mit einer DELETE-Anfrage an den /products/{id}-Endpunkt für neue Käufe aus, ohne es dauerhaft zu löschen.

Archive Product API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Archive Product API.
Stellen Sie ein archiviertes Produkt wieder her, indem Sie eine POST-Anfrage an den /products/{product_id}/unarchive-Endpunkt senden. Dadurch wird das Produkt reaktiviert und wieder zur Verwendung verfügbar.

Unarchive Product API

Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Unarchive Product API.
Erstellen Sie Zahlungs- oder Abonnementabläufe aus Produkten und führen Sie die Bereitstellung automatisch über Vorteile und Webhooks aus.

Checkout Sessions

Erstellen Sie Checkout-Sitzungen für einmalige Käufe oder Abonnementkäufe.

Payment Webhooks

Reagieren Sie auf Ereignisse im Zahlungslebenszyklus.

Subscription Webhooks

Verarbeiten Sie Ereignisse zur Erstellung, Verlängerung und Kündigung von Abonnements.

​
Best Practices

  • Mit Klarheit beginnen: Separate Produkte für jede Preisoption (Monthly gegenüber Yearly).
  • Testphasen sinnvoll einsetzen: Kombinieren Sie Testphasen mit Onboarding, um die Aktivierung zu fördern.
  • Bereitstellung automatisieren: Verwenden Sie Vorteile und Webhooks für eine sofortige Bereitstellung.
  • Metadaten verwenden: Speichern Sie die IDs Ihrer Systeme zur Abstimmung.

​
Verwandte Themen

Product Analytics

Verfolgen Sie Umsatz, Kunden, Kundenbindung, Abonnenten und MRR für jedes einzelne Produkt.

Localized Pricing

Legen Sie feste Preise pro Währung oder Land für ein Produkt fest, anstatt sich auf aktuelle Wechselkurse zu verlassen.
Zuletzt geändert am 26. September 2026