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 Rechnung nach tatsächlicher Nutzung erstellen.
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.
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.
- Preis: Basisbetrag und Währung. Sie können den Basispreis in jeder Währung festlegen, die Dodo Payments berechnen kann, nicht nur in USD. Verwenden Sie die durchsuchbare Währungsauswahl, um eine Währung zu finden; USD, GBP, EUR und INR sind oben in der Liste angeheftet.
- Rabatt (%): Optionaler Inline-Rabatt, der im Checkout und auf Rechnungen angezeigt wird.
- Legen Sie bei Abonnements Wiederholen alle (z. B. 1 Monat oder 1 Jahr), Testtage und einen optionalen Testbetrag für einen kostenpflichtigen Testzeitraum fest. Der Abonnementpreis muss mindestens 1 $ (oder dem Gegenwert in der gewählten Währung) entsprechen; Beträge unter diesem Mindestwert werden nicht unterstützt, und das Abonnement funktioniert nicht.
Kunden außerhalb Ihrer Basiswährung werden weiterhin über Adaptive Currency abgerechnet. So können Sie Preise in der Währung festlegen, die am besten zu Ihrem Markt passt, ohne die Abrechnung für Käufer zu ändern.
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 zu 3 MB. Sie können die Reihenfolge jederzeit ändern oder Bilder ersetzen.
4
Automated entitlements (Under Advanced Settings)
Fügen Sie eine Fulfillment-Option hinzu, die nach der Zahlung automatisch aktiviert wird:
- Lizenzschlüssel: Eindeutige Schlüssel ausstellen und validieren
- Dateidownloads: Sicheren Dateizugriff gewähren
- Benutzerdefiniert: Lösen Sie Ihre eigene Berechtigungslogik über Webhooks aus
Varianten und Preisoptionen
Erstellen Sie statt Varianten unter einem Produkt separate Produkte für jede Preisoption (zum Beispiel monatlich und jährlich). Gruppieren Sie diese anschließend in einer Product Collection, um alle Optionen in einem einzigen Checkout anzuzeigen und den Planwechsel im Customer Portal zu ermöglichen.
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
- Produkte erstellen: Richten Sie einzelne Produkte für jeden Plan ein (z. B. Starter Monthly, Starter Annual, Pro Monthly, Pro Annual)
- In einer Collection gruppieren: Fügen Sie verwandte Produkte zu einer Product Collection hinzu
- Einheitlicher Checkout: Kunden sehen alle Optionen in einem Checkout und wählen ihren bevorzugten Plan aus
- 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 nahtlose Upgrade- und Downgrade-Prozesse 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
- Aktualisieren: Bearbeiten Sie Name, Beschreibung, Bilder, Preis, Felder und Vorteile jederzeit (das Preismodell ist unveränderlich).
- Archivieren: Blenden Sie ein Produkt für neue Käufe aus, ohne bestehende Kunden zu beeinträchtigen. Sie können es später wieder aus dem Archiv holen.
- Entwürfe: Ein Produkt in Bearbeitung wird als Entwurf gespeichert, damit Sie später darauf zurückkommen können. Entwürfe werden separat für den Testmodus und den Live-Modus gespeichert, sodass ein unfertiges Produkt in einem Modus niemals in den anderen übergeht. Verwenden Sie Entwurf löschen, um ihn zu verwerfen und neu zu beginnen.
Verwaltung über die API
Mit den folgenden Anweisungen können Sie Produkte erstellen, aktualisieren, verwalten und abrufen, einschließlich des Hochladens von Bildern.Creating a Product
Creating a Product
Ein Produkt kann ein einmaliger Artikel oder ein abonnementbasierter Dienst sein. Um ein neues Produkt zu erstellen, senden Sie eine
POST-Anfrage an den Endpunkt /products mit Angaben wie Name, Beschreibung, Preis, Währung und der Information, 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 API-Dokumentation zu Create Product.
Updating a Product
Updating a Product
Um ein bestehendes Produkt zu ändern, senden Sie eine
PATCH-Anfrage an den Endpunkt /products/{product_id}. 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 API-Dokumentation zu Update Product.
Retrieving Products
Retrieving Products
Sie können eine Liste der in Ihrem Konto gespeicherten Produkte mit einer
GET-Anfrage an den Endpunkt /products abrufen. 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 API-Dokumentation zu Retrieve Products.
Uploading Product Images
Uploading Product Images
Sie können ein Bild mit einem Produkt verknüpfen, indem Sie es mithilfe einer von der API bereitgestellten vorab signierten URL in AWS S3 hochladen. Fordern Sie zunächst eine URL zum Hochladen eines Bildes über den Endpunkt
/products/{product_id}/images an und verwenden Sie anschließend die bereitgestellte URL, um das Bild innerhalb von 60 Sekunden hochzuladen.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
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 API-Dokumentation zu Upload Product Image.
Archiving a Product
Archiving a Product
Wenn Sie ein Produkt nicht mehr anzeigen oder verwenden möchten, können Sie es mit einer
DELETE-Anfrage an den Endpunkt /products/{id} archivieren. Dadurch wird das Produkt ausgeblendet, aber nicht dauerhaft gelöscht.Archive Product API
Eine detaillierte Struktur von Anfrage und Antwort finden Sie in der API-Dokumentation zu Archive Product.
Unarchiving a Product
Unarchiving a Product
Wenn Sie ein archiviertes Produkt wiederherstellen müssen, senden Sie eine
POST-Anfrage an den Endpunkt /products/{product_id}/unarchive. 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 API-Dokumentation zu Unarchive Product.
Checkout & fulfillment
Checkout & fulfillment
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 für erstellte, verlängerte und gekündigte Abonnements.
Best Practices
- Mit Klarheit beginnen: Separate Produkte für jede Preisoption (monatlich gegenüber jährlich)
- Testzeiträume sinnvoll einsetzen: Kombinieren Sie Testzeiträume mit Onboarding, um die Aktivierung zu fördern
- Fulfillment automatisieren: Verwenden Sie Vorteile und Webhooks, um Leistungen sofort bereitzustellen
- Metadaten verwenden: Speichern Sie die IDs Ihres Systems zur Abstimmung
Sie können jetzt Produkte erstellen und mit dem Verkauf beginnen – einmalig, wiederkehrend oder nutzungsbasiert.
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, statt sich auf Live-Wechselkurse zu verlassen.