Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Neue Funktionen
1. Gestapelte Rabattcodes
Checkout-Sitzungen, Zahlungen, Abonnements und Planänderungen akzeptieren jetzt bis zu 20 Rabattcodes in einer einzelnen Anfrage über das discount_codes Array. Codes werden in Array-Reihenfolge angewandt — der erste gültige Code reduziert den Basispreis, der zweite reduziert den bereits rabattierten Preis und so weiter — dadurch können Kampagnen geschichtet werden, ohne maßgeschneiderte Kombinationscodes erstellen zu müssen.
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
customer: { email: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
| Oberfläche | Feld | Maximal Codes |
|---|
| Checkout-Sitzungen | discount_codes | 20 |
| Zahlungen | discount_codes | 20 |
| Abonnements | discount_codes | 20 |
| Planänderungen | discount_codes | 20 |
discount_codes wert | Effekt |
|---|
| Nicht bereitgestellt | Bestehende Rabatte mit preserve_on_plan_change=true bleiben, falls auf das neue Produkt anwendbar |
[] (leeres Array) | Alle bestehenden Rabatte werden vom Abonnement entfernt |
['CODE_A', 'CODE_B', ...] | Ersetzt alle bestehenden Rabatte mit diesem gestapelten Set, angewandt in Array-Reihenfolge |
discounts Array bei Zahlungen und Abonnements zurückgegeben — jeder Eintrag beinhaltet discount_id, position und cycles_remaining (für Abonnements). Das veraltete singuläre Feld discount_id ist zwar noch vorhanden, dient jedoch der Rückwärtskompatibilität.
Das singuläre discount_code Feld ist veraltet, aber weiterhin unterstützt — bestehende Integrationen funktionieren weiterhin unverändert. Es kann nicht mit discount_codes in derselben Anfrage kombiniert werden. Wir empfehlen die Migration zu discount_codes, wann es bequem ist, selbst für einzelne Codes, um von der Stapelung und der reicheren Antwortstruktur zu profitieren.
2. Sieben neue Kundenbenachrichtigungs-E-Mails
Sieben neue transaktionale E-Mails werden nun automatisch an Ihre Kunden gesendet, die Rückerstattungsbestätigungen, Meilensteine des Abonnementlebenszyklus und Zahlungsausfälle abdecken. Jede E-Mail kann unabhängig von Einstellungen → Kommunikation im Abschnitt Kunden-E-Mails umgeschaltet werden.
Opt-in (standardmäßig aktiviert)
| E-Mail | Wann sie ausgelöst wird |
|---|
| Rückerstattung erfolgreich | Eine Rückerstattung wird erfolgreich bearbeitet und das Geld ist auf dem Weg zurück zum Kunden |
| Abonnement-Testphase endet | Ca. 2 Tage bevor eine Testphase endet und die erste Abbuchung erfolgt |
| Abonnement sofort gekündigt | Ein Abonnement wird mit sofortiger Wirkung gekündigt |
| Abonnement zur Kündigung am nächsten Abrechnungsdatum festgelegt | Ein Abonnement ist zur Kündigung am Ende der aktuellen Abrechnungsperiode terminiert |
| E-Mail | Wann sie ausgelöst wird |
|---|
| Zahlung fehlgeschlagen | Ein Zahlungsversuch scheitert — aktivieren, wenn Dodo Payments den Kunden direkt benachrichtigen soll, anstatt es in Ihrem eigenen System zu verwalten |
| Abonnementverlängerung fehlgeschlagen | Eine Abonnementverlängerungszahlung schlägt spezifisch fehl; wird anstelle der allgemeinen E-Mail Zahlung fehlgeschlagen bei Verlängerungszahlungen ausgelöst (nicht zusätzlich) |
| Erinnerung an bevorstehende Verlängerung | Ca. 2 Tage vor der Abonnementverlängerung |
Wenn Sie die Kundenkommunikation selbst über Webhooks verwalten, lassen Sie die Opt-out-E-Mails deaktiviert, um doppelte Benachrichtigungen für dasselbe Ereignis zu vermeiden.
Kunden-E-Mails sind getrennt von den Benachrichtigungs-E-Mails, die an Ihr Team gesendet werden. Das Deaktivieren einer Kunden-E-Mail hat keine Auswirkungen auf die Benachrichtigungen Ihres Teams für dasselbe Ereignis.
3. Sunbit — Ratenfinanzierung für US-Kunden
Sunbit ist jetzt als Zahlungsmethode Kaufen Jetzt, Später Bezahlen erhältlich und ermöglicht es US-Kunden, Einkäufe beim Checkout in verwaltbare monatliche Raten aufzuteilen.
| Funktion | Details |
|---|
| Verfügbarkeit | Vereinigte Staaten |
| Währung | USD |
| Mindestbetrag | $60,00 |
| Maximalbetrag | $19.999,00 |
| Abonnements | Nicht unterstützt (nur einmalige Zahlungen) |
sunbit in allowed_payment_method_types, um es in einer Checkout-Sitzung zu aktivieren:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['sunbit', 'credit', 'debit'],
return_url: 'https://example.com/success'
});
Immer credit und debit als Rückstellungen einschließen. Nicht alle Kunden qualifizieren sich für die Sunbit-Finanzierung, und Transaktionen außerhalb des Bereichs von 60,00–19.999,00 zeigen die Option nicht an. Verbesserungen
4. Überarbeitung der Zahlungsseite beim Checkout
Die Zahlungsseite beim Checkout wurde umfassend überarbeitet — engeres Layout, schneller wahrgenommene Ladezeiten, klarere Validierungszustände und verfeinerte Karteneingabe-UX. Insgesamt haben diese Änderungen die beobachteten Erfolgsraten beim Checkout um ~2–3 % weltweit erhöht.
Was sich geändert hat:
- Sanftere Feldinteraktionen — Autofokus, intelligenter Tabulatorreihenfolge und verbesserte Tastaturnavigation im Kartenformular
- Sauberere Fehler- und Ladezustände — Inline-Validierung zeigt genau dort an, wo der Kunde handeln muss, und ersetzt das vorherige Muster des vollständigen Fehlerbanners
- Schnellere Darstellung — Skelette und progressive Hydration beseitigen das kurze Flackergefühl eines leeren Zustands bei langsamen Netzwerken
- Mobil Politur — Tippziele, Scroll-Verhalten und Tastatur-Handling speziell für den mobilen Checkout optimiert, auf den mittlerweile der Großteil des Traffics entfällt
Keine Integrationsänderungen erforderlich. Bestehende Checkout-Sitzungen übernehmen automatisch die neue Zahlungsseite.
- Live-Vorschau — sehen Sie, wie Ihr Produkt im Checkout und im Kundenportal angezeigt wird, während Sie es bearbeiten, und zwar nebeneinander mit dem Formular
- Automatisches Speichern — Entwürfe werden automatisch gespeichert, sodass das Verlassen der Seite oder der Verlust des Tabs nicht mehr bedeutet, dass Ihre Arbeit verloren geht
- Markdown-Editor — Produktbeschreibungen unterstützen jetzt einen vollständigen Markdown-Editor mit Live-Rendering, Link-Vorschauen und Inline-Formatierungssteuerungen
- Duplizierungsablauf-Parität — das Duplizieren eines Produkts öffnet das gleiche vereinheitlichte Formular, das vorausgefüllt ist, anstelle eines abgespeckten Dialogs, sodass Sie vor dem Speichern der Kopie jedes Feld anpassen können
Verwenden Sie Duplizieren, um regionale oder Preisstufenvarianten eines bestehenden Produkts zu erstellen, ohne Beschreibungen, Metadaten oder Konfigurationen zur Erfüllung neu einzugeben.
6. Redesign der Business Settings-Seite
Die Einstellungen → Geschäft-Seite wurde neu gestaltet, um die Konfiguration leichter scanbar und schneller aktualisierbar zu machen. Einstellungen sind jetzt in klarere Abschnitte mit erklärenden Texten gruppiert, die die Auswirkungen jedes Schalters beschreiben, bevor Sie ihn umlegen.
Es gibt keine Verhaltensänderungen bei bestehenden Einstellungen — nur das Layout, die Gruppierung und die umgebenden Erklärungen wurden verbessert.
Verbesserungen
credits_amount Override jetzt korrekt auf GET-Checkout-Sitzung und Zahlungslink-Routen angewandt — wenn eine Checkout-Sitzung oder ein Zahlungslink mit einem pro Checkout credit_entitlements Override erstellt wurde, wurde über GET das produktbezogene Standard credits_amount zurückgegeben anstelle des überschriebenen Werts. Dies ist jetzt behoben.- Rückerstattungsaktion für vollständig zurückerstattete Zahlungen deaktiviert — die Rückerstattungsschaltfläche für eine Zahlung ist jetzt deaktiviert, sobald eine Zahlung vollständig zurückerstattet wurde, mit einem Tooltip, der erklärt warum. Bisher blieb die Schaltfläche aktiv und gab nur nach der Übermittlung einen Fehler zurück.
- Kleinere Fehlerbehebungen und Stabilitätsverbesserungen auf der gesamten Plattform
