Zum Hauptinhalt springen
Produkte sind die Grundlage von Dodo Payments. Egal, ob Sie einen einmaligen Download, ein wiederkehrendes Abonnement oder einen nutzungsbasierten Zugang verkaufen, Sie beginnen mit der Erstellung eines Produkts. Jedes Produkt definiert, wie es bepreist, an der Kasse präsentiert und nach dem Kauf erfüllt wird.

Einmalig

Einmalige Gebühr für lebenslangen Zugang oder ein einzelnes Lieferobjekt.

Abonnements

Rechnungen nach einem Zeitplan mit Testphasen, anteiligen Gebühren und Zusatzleistungen.

Nutzungsbasiert

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 & Beschreibung

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 ergebnisorientiert; er erscheint prominent an der Kasse.
Produkte
2

Preismodell & Preis

Wählen Sie das Preismodell aus:
  • 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.
Änderungen des Preises betreffen nur neue Käufe. Bestehende Abonnements folgen den Regeln für Planänderungen.
3

Produktmedien

Laden Sie Bilder hoch, um das Produkt an der Kasse und auf Rechnungen zu präsentieren. Unterstützte Formate: PNG/JPG/WebP bis zu 3 MB. Neu anordnen oder jederzeit ersetzen.
4

Automatisierte Berechtigungen (Unter Erweiterte Einstellungen)

Fügen Sie Erfüllungen hinzu, die nach der Zahlung automatisch aktiviert werden:
  • 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 diese, während sich Ihr Angebot entwickelt. Bestehende Abonnenten erhalten oder verlieren entsprechend den Zugang.

​
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.
Produktkollektionen

​
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

Produktkollektionen

Gruppieren Sie verwandte Produkte für einheitliche Checkout-Erlebnisse und nahtlose Upgrade- und 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 abonnementbasierter Dienst sein. Um ein neues Produkt zu erstellen, senden Sie einen POST Request an den /products Endpoint mit Details wie Name, Beschreibung, Preis, Währung und ob es sich um ein wiederkehrendes Produkt handelt.Für wiederkehrende Produkte setzen Sie recurring: true und geben einen billing_cycle (daily, weekly, monthly, yearly) an.

Create Product API

Sehen Sie die detaillierte Anforderungs- und Antwortstruktur in der Dokumentation der Create Product API.
Um ein bestehendes Produkt zu ändern, senden Sie einen PATCH Request an den /products/{product_id} Endpoint. Sie können Eigenschaften wie Name, Preis und Beschreibung aktualisieren und andere Details unverändert lassen.Stellen Sie sicher, dass der product_id im Endpoint mit einem bestehenden Produkt übereinstimmt.

Update Product API

Sehen Sie die detaillierte Anforderungs- und Antwortstruktur in der Dokumentation der Update Product API.
Sie können eine Liste von in Ihrem Konto gespeicherten Produkten mithilfe eines GET Requests an den /products Endpoint abrufen. Dies ermöglicht es Ihnen, Produktdetails, einschließlich aktiver und archivierter Produkte, abzurufen.

Retrieve Products API

Sehen Sie die detaillierte Anforderungs- und Antwortstruktur in der Dokumentation der Retrieve Products API.
Sie können ein Bild mit einem Produkt verknüpfen, indem Sie es über eine vorher signierte URL hochladen, die von der API bereitgestellt wird. Fordern Sie zuerst eine Bild-Upload-URL vom /products/{product_id}/images Endpoint an, und verwenden Sie die bereitgestellte URL, um das Bild innerhalb von 60 Sekunden hochzuladen.
Die vorher signierte URL läuft nach 60 Sekunden ab, sodass das Bild innerhalb dieses Zeitrahmens hochgeladen werden muss.
Sobald die vorher signierte URL von der API empfangen wurde, laden Sie das Bild mit der PUT Methode hoch. Dies gewährleistet sicheren und vorübergehenden Zugriff auf AWS S3 zum Hochladen des Bildes.Unterstützte Bibliotheken zum Hochladen nach 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 einen 200 OK Status zurück, der angibt, dass das Bild erfolgreich gespeichert wurde.

Upload Product Image API

Sehen Sie die detaillierte Anforderungs- und Antwortstruktur in der Dokumentation der Upload Product Image API.
Wenn Sie ein Produkt nicht mehr anzeigen oder verwenden möchten, können Sie es mit einem POST Request an den /products/{product_id}/archive Endpoint archivieren. Diese Aktion versteckt das Produkt, löscht es jedoch nicht dauerhaft.

Archive Product API

Sehen Sie die detaillierte Anforderungs- und Antwortstruktur in der Dokumentation der Archive Product API.
Wenn Sie ein archiviertes Produkt wiederherstellen müssen, senden Sie einen POST Request an den /products/{product_id}/unarchive Endpoint. Dadurch wird das Produkt reaktiviert und wieder zur Verwendung verfügbar gemacht.

Unarchive Product API

Sehen Sie die detaillierte Anforderungs- und Antwortstruktur in der Dokumentation der Unarchive Product API.

​
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 zu verkaufen - einmalig, wiederkehrend oder nach Nutzung.