Zum Hauptinhalt springen
Produkte bilden die Grundlage von Dodo Payments. Egal, ob Sie einen einmaligen Download, ein Abo mit wiederkehrenden Zahlungen oder nutzungsbasierte Zugänge verkaufen – Sie beginnen mit der Erstellung eines Produkts. Jedes Produkt legt fest, wie es bepreist, im Checkout angezeigt und nach dem Kauf bereitgestellt wird.

One‑Time

Einmalig berechnen für lebenslangen Zugriff oder eine einzelne Lieferung.

Subscriptions

Planmäßig abrechnen mit Probezeiten, anteiliger Abrechnung und Add-ons.

Usage‑Based

Verbrauch messen und nach tatsächlicher Nutzung abrechnen.

​
Erstellen Sie ein Produkt

Sie können Produkte über das Dashboard oder über die API erstellen. Wählen Sie das Preismodell im Voraus: Einmalig, Abonnement oder Nutzungsbasiert und konfigurieren Sie dann die Details. Das Preismodell kann später nicht geändert werden; erstellen Sie ein neues Produkt, wenn Sie ein anderes Modell benötigen.
1

Name & description

Geben Sie einen klaren Titel und eine prägnante, wertorientierte Beschreibung an. Markdown wird in Beschreibungen unterstützt.
Halten Sie den ersten Satz kundenorientiert und ergebnisfokussiert; dieser erscheint prominent im Checkout.
Products
2

Pricing model & price

Wählen Sie das Preismodell:
  • Einmalig: Festpreis, der einmal bezahlt wird.
  • Abonnement: Wiederkehrender Preis mit Intervall und optionaler Testphase.
  • Nutzungsbasiert: Preis, der aus gemessenen Ereignissen abgeleitet wird.
Legen Sie dann die Preise fest:
  • Preis: Basisbetrag und Währung.
  • Rabatt (%): Optionaler Inline-Rabatt, der an der Kasse und auf Rechnungen angezeigt wird.
  • Für Abonnements legen Sie Wiederholen alle (z. B. 1 Monat oder 1 Jahr) und Testtage fest, falls erforderlich.
Eine Preisänderung betrifft nur neue Käufe. Bestehende Abos folgen den Planänderungsregeln.
3

Product media

Laden Sie Bilder hoch, um das Produkt im Checkout und auf Rechnungen zu präsentieren. Unterstützt werden PNG/JPG/WebP bis 3 MB. Sortieren oder ersetzen Sie die Bilder jederzeit neu.
4

Automated entitlements (Under Advanced Settings)

Fügen Sie eine Bereitstellung hinzu, die nach der Zahlung automatisch aktiviert wird:
  • Lizenzschlüssel: Einmalige Schlüssel ausgeben und validieren
  • Dateidownloads: Sicherer Dateizugriff gewähren
  • Benutzerdefiniert: Ihre eigene Berechtigungslogik über Webhooks auslösen
Fügen Sie Vorteile hinzu oder entfernen Sie sie, wenn sich Ihr Angebot weiterentwickelt. Bestehende Abonnenten erhalten entsprechend Zugang oder verlieren ihn.

​
Varianten und Preisoptionen

Statt Varianten unter einem Produkt zu verwenden, erstellen Sie separate Produkte für jede Preisoption (zum Beispiel monatlich und jährlich). Gruppieren Sie diese dann in einer Produktkollektion, um alle Optionen in einem einzigen Checkout anzuzeigen und den Planwechsel im Kundenportal zu ermöglichen.
Product Collections

​
Warum dieser Ansatz?

  • Klare Preismodelle: Jedes Produkt hat ein einzelnes, klar definiertes Preismodell (einmalig, Abonnement oder nutzungsbasiert)
  • Vorhersehbare APIs: Einfachere Integrationen ohne verschachtelte Variantenlogik
  • Einfache Berichterstattung: Verfolgen Sie Einnahmen und Kennzahlen pro Produkt ohne Variante-Aggregation
  • Flexibler Checkout: Mehrere Produkte nebeneinander anzeigen, damit Kunden vergleichen und auswählen können

​
Wie Produktkollektionen funktionieren

  1. Produkte erstellen: Richten Sie einzelne Produkte für jeden Plan ein (z.B. Starter Monatlich, Starter Jährlich, Pro Monatlich, Pro Jährlich)
  2. In einer Kollektion gruppieren: Fügen Sie verwandte Produkte einer Produktkollektion hinzu
  3. Einheitlicher Checkout: Kunden sehen alle Optionen in einem Checkout und wählen ihren bevorzugten Plan aus
  4. Planwechsel: Kunden können zwischen Produkten in derselben Kollektion über das Kundenportal auf- oder absteigen

Product Collections

Gruppieren Sie verwandte Produkte für einheitliche Checkout-Erlebnisse und nahtlose Upgrade-/Downgrade-Pfade.

​
Produkte verwalten

Sie können Produkte über das Dashboard oder programmgesteuert über die API verwalten. Die API bietet vollständige Kontrolle über die Erstellung, Aktualisierung, Abfrage, Bild-Uploads und Archivierung von Produkten.

​
Dashboard-Verwaltung

  • Aktualisieren: Bearbeiten Sie Name, Beschreibung, Bilder, Preis, Felder und Vorteile jederzeit (das Preismodell ist unveränderlich).
  • Archivieren: Verstecken Sie ein Produkt vor neuen Käufen, ohne bestehende Kunden zu stören. Sie können es später wiederherstellen.

​
API-Verwaltung

Die folgenden Anweisungen ermöglichen es Ihnen, Produkte zu erstellen, zu aktualisieren, zu verwalten und abzurufen, einschließlich des Hochladens von Bildern.
Ein Produkt kann ein einmaliger Artikel oder ein abonnementbasiertes Angebot sein. Um ein neues Produkt zu erstellen, senden Sie eine POST-Anfrage an den /products-Endpunkt mit Details wie Name, Beschreibung, Preis, Währung und der Angabe, ob es sich um ein wiederkehrendes Produkt handelt.Bei wiederkehrenden Produkten setzen Sie recurring: true und geben ein billing_cycle an (daily, weekly, monthly, yearly).

Create Product API

Sehen Sie sich die detaillierte Anfrage- und Antwortstruktur in der API-Dokumentation zum Erstellen von Produkten an.
Um ein bestehendes Produkt zu ändern, 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 der product_id im Endpunkt einem bestehenden Produkt entspricht.

Update Product API

Sehen Sie sich die detaillierte Anfrage- und Antwortstruktur in der API-Dokumentation zum Aktualisieren von Produkten an.
Sie können eine Liste der in Ihrem Konto gespeicherten Produkte abrufen, indem Sie eine GET-Anfrage an den /products-Endpunkt senden. Damit lassen sich Produktdetails einschließlich aktiver und archivierter Produkte einsehen.

Retrieve Products API

Sehen Sie sich die detaillierte Anfrage- und Antwortstruktur in der API-Dokumentation zum Abrufen von Produkten an.
Sie können einem Produkt ein Bild zuordnen, indem Sie es mit einer von der API bereitgestellten vorab signierten URL in AWS S3 hochladen. Fordern Sie zunächst eine Upload-URL von /products/{product_id}/images an und verwenden Sie dann die bereitgestellte URL, um das Bild innerhalb von 60 Sekunden hochzuladen.
Die vorab signierte URL läuft nach 60 Sekunden ab, daher muss das Bild innerhalb dieses Zeitfensters hochgeladen werden.
Sobald die vorab signierte URL von der API empfangen wurde, laden Sie das Bild mit der PUT-Methode hoch. Dadurch wird ein sicherer und temporärer Zugriff auf AWS S3 zum Hochladen des Bildes gewährleistet.Unterstützte Bibliotheken für S3-Uploads:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Wenn der Upload erfolgreich ist, gibt AWS S3 einen 200 OK-Status zurück, der signalisiert, dass das Bild erfolgreich gespeichert wurde.

Upload Product Image API

Sehen Sie sich die detaillierte Anfrage- und Antwortstruktur in der API-Dokumentation zum Hochladen von Produktbildern an.
Wenn Sie ein Produkt nicht mehr anzeigen oder verwenden möchten, können Sie es archivieren, indem Sie eine POST-Anfrage an den /products/{product_id}/archive-Endpunkt senden. Dadurch wird das Produkt ausgeblendet, aber nicht dauerhaft gelöscht.

Archive Product API

Sehen Sie sich die detaillierte Anfrage- und Antwortstruktur in der API-Dokumentation zum Archivieren von Produkten an.
Wenn Sie ein archiviertes Produkt wiederherstellen müssen, senden Sie eine POST-Anfrage an den /products/{product_id}/unarchive-Endpunkt. Dadurch wird das Produkt reaktiviert und wieder nutzbar gemacht.

Unarchive Product API

Sehen Sie sich die detaillierte Anfrage- und Antwortstruktur in der API-Dokumentation zum Wiederherstellen archivierter Produkte an.

​
Best Practices

  • Mit Klarheit beginnen: Separate Produkte für jede Preisoption (monatlich vs. jährlich)
  • Trials bedacht nutzen: Trials mit Onboarding kombinieren, um Aktivierung zu fördern
  • Erfüllung automatisieren: Nutzen Sie Vorteile und Webhooks, um sofortige Lieferung zu gewährleisten
  • Mit Metadaten markieren: Speichern Sie Ihre System-IDs für die Abstimmung
Sie sind bereit, Produkte zu erstellen und mit dem Verkauf zu beginnen – einmalig, wiederkehrend oder nach Nutzung.

Product Analytics

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