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

Anstatt Varianten unter einem Produkt zu erstellen, erstellen Sie separate Produkte für jede Preisoption (z. B. Monatlich und Jährlich). Sie können mehrere Produkte nebeneinander an derselben Kasse präsentieren und es den Kunden ermöglichen, zwischen ihnen zu wechseln.
Dies hält die APIs vorhersehbar und vereinfacht die Berichterstattung. Jedes Produkt hat ein einzelnes Preismodell.

​
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, das Hochladen von Bildern und das Archivieren von Produkten.

​
Dashboard-Verwaltung

  • Aktualisieren: Bearbeiten Sie Namen, Beschreibung, Bilder, Preis, Felder und Vorteile jederzeit (das Preismodell ist unveränderlich).
  • Archivieren: Blenden Sie ein Produkt von neuen Käufen aus, 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 eine POST Anfrage an den /products Endpunkt 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 Sie einen billing_cycle an (daily, weekly, monthly, yearly).

Create Product API

Detaillierte Anfrage- und Antwortstruktur in der Dokumentation der Create Product API anzeigen.
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 die product_id im Endpunkt mit einem bestehenden Produkt übereinstimmt.

Update Product API

Detaillierte Anfrage- und Antwortstruktur in der Dokumentation der Update Product API anzeigen.
Sie können eine Liste von Produkten, die in Ihrem Konto gespeichert sind, mit einer GET Anfrage an den /products Endpunkt abrufen. Dies ermöglicht es Ihnen, Produktdetails, einschließlich aktiver und archivierter Produkte, abzurufen.

Retrieve Products API

Detaillierte Anfrage- und Antwortstruktur in der Dokumentation der Retrieve Products API anzeigen.
Sie können ein Bild mit einem Produkt verknüpfen, indem Sie es über eine vorab signierte URL, die von der API bereitgestellt wird, in AWS S3 hochladen. Fordern Sie zunächst eine URL zum Hochladen von Bildern vom /products/{product_id}/images Endpunkt 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, sodass das Bild innerhalb dieses Zeitrahmens hochgeladen werden muss.
Sobald die vorab signierte URL von der API empfangen wurde, laden Sie das Bild mit der PUT Methode hoch. Dies gewährleistet sicheren und temporären Zugriff auf AWS S3 zum Hochladen des Bildes.Unterstützte Bibliotheken für das 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 anzeigt, dass das Bild erfolgreich gespeichert wurde.

Upload Product Image API

Detaillierte Anfrage- und Antwortstruktur in der Dokumentation der Upload Product Image API anzeigen.
Wenn Sie ein Produkt nicht mehr anzeigen oder verwenden möchten, können Sie es mit einer POST Anfrage an den /products/{product_id}/archive Endpunkt archivieren. Diese Aktion blendet das Produkt aus, löscht es jedoch nicht dauerhaft.

Archive Product API

Detaillierte Anfrage- und Antwortstruktur in der Dokumentation der Archive Product API anzeigen.
Wenn Sie ein archiviertes Produkt wiederherstellen müssen, senden Sie eine POST Anfrage an den /products/{product_id}/unarchive Endpunkt. Dies reaktiviert das Produkt und macht es wieder verfügbar.

Unarchive Product API

Detaillierte Anfrage- und Antwortstruktur in der Dokumentation der Unarchive Product API anzeigen.

​
Best Practices

  • Beginnen Sie mit Klarheit: Separate Produkte für jede Preisoption (Monatlich vs Jährlich)
  • Nutzen Sie Testphasen sinnvoll: Kombinieren Sie Testphasen mit Onboarding, um die Aktivierung zu fördern
  • Automatisieren Sie die Erfüllung: Verwenden Sie Vorteile und Webhooks, um sofort zu liefern
  • Taggen Sie mit Metadaten: Speichern Sie Ihre System-IDs zur Abstimmung
Sie sind bereit, Produkte zu erstellen und zu verkaufen - einmalig, wiederkehrend oder nach Nutzung.