Übersicht
Der Inline-Checkout ermöglicht es Ihnen, vollständig integrierte Checkout-Erlebnisse zu schaffen, die nahtlos mit Ihrer Website oder Anwendung verschmelzen. Im Gegensatz zum Overlay-Checkout, der als Modal über Ihrer Seite geöffnet wird, bettet der Inline-Checkout das Zahlungsformular direkt in Ihr Seitenlayout ein. Mit dem Inline-Checkout können Sie:- Checkout-Erlebnisse erstellen, die vollständig in Ihre App oder Website integriert sind
- Dodo Payments sicher die Kunden- und Zahlungsinformationen in einem optimierten Checkout-Rahmen erfassen lassen
- Artikel, Gesamtsummen und andere Informationen von Dodo Payments auf Ihrer Seite anzeigen
- SDK-Methoden und -Ereignisse verwenden, um fortschrittliche Checkout-Erlebnisse zu erstellen

Funktionsweise
Der Inline-Checkout funktioniert, indem ein sicherer Dodo Payments-Rahmen in Ihre Website oder App eingebettet wird. Der Checkout-Rahmen kümmert sich um das Sammeln von Kundeninformationen und das Erfassen von Zahlungsdetails. Ihre Seite zeigt die Artikelliste, Gesamtsummen und Optionen zum Ändern der Checkout-Inhalte an. Das SDK ermöglicht es Ihrer Seite und dem Checkout-Rahmen, miteinander zu interagieren. Dodo Payments erstellt automatisch ein Abonnement, wenn ein Checkout abgeschlossen ist, bereit für Sie zur Bereitstellung.Der Inline-Checkout-Rahmen verarbeitet sicher alle sensiblen Zahlungsinformationen und gewährleistet die PCI-Konformität, ohne dass zusätzliche Zertifizierungen Ihrerseits erforderlich sind.
Was macht einen guten Inline-Checkout aus?
Es ist wichtig, dass die Kunden wissen, von wem sie kaufen, was sie kaufen und wie viel sie bezahlen. Um einen Inline-Checkout zu erstellen, der konform und optimiert für Konversionen ist, muss Ihre Implementierung Folgendes enthalten:
Beispiel für ein Inline-Checkout-Layout mit erforderlichen Elementen
- Wiederkehrende Informationen: Wenn es sich um wiederkehrende Zahlungen handelt, wie oft sie wiederkehren und der Gesamtbetrag bei der Erneuerung. Wenn es sich um eine Testversion handelt, wie lange die Testversion dauert.
- Artikelbeschreibungen: Eine Beschreibung dessen, was gekauft wird.
- Transaktionssummen: Transaktionssummen, einschließlich Zwischensumme, Gesamtsteuer und Gesamtsumme. Stellen Sie sicher, dass auch die Währung angegeben ist.
- Dodo Payments-Fußzeile: Der vollständige Inline-Checkout-Rahmen, einschließlich der Checkout-Fußzeile, die Informationen über Dodo Payments, unsere Verkaufsbedingungen und unsere Datenschutzrichtlinie enthält.
- Rückerstattungsrichtlinie: Ein Link zu Ihrer Rückerstattungsrichtlinie, falls diese von der Standard-Rückerstattungsrichtlinie von Dodo Payments abweicht.
Kundenreise
Der Checkout-Fluss wird durch Ihre Konfiguration der Checkout-Sitzung bestimmt. Je nachdem, wie Sie die Checkout-Sitzung konfigurieren, erleben die Kunden einen Checkout, der möglicherweise alle Informationen auf einer einzigen Seite oder über mehrere Schritte hinweg präsentiert.1
Kunde öffnet den Checkout
Sie können den Inline-Checkout öffnen, indem Sie Artikel oder eine vorhandene Transaktion übergeben. Verwenden Sie das SDK, um Informationen auf der Seite anzuzeigen und zu aktualisieren, und SDK-Methoden, um Artikel basierend auf der Interaktion des Kunden zu aktualisieren.

2
Kunde gibt seine Daten ein
Der Inline-Checkout fordert die Kunden zunächst auf, ihre E-Mail-Adresse einzugeben, ihr Land auszuwählen und (wo erforderlich) ihre PLZ oder Postleitzahl einzugeben. Dieser Schritt sammelt alle notwendigen Informationen, um Steuern und verfügbare Zahlungsmethoden zu bestimmen.Sie können die Kundendaten vorab ausfüllen und gespeicherte Adressen anzeigen, um das Erlebnis zu optimieren.
3
Kunde wählt Zahlungsmethode
Nachdem sie ihre Daten eingegeben haben, werden den Kunden verfügbare Zahlungsmethoden und das Zahlungsformular angezeigt. Die Optionen können Kredit- oder Debitkarte, PayPal, Apple Pay, Google Pay und andere lokale Zahlungsmethoden basierend auf ihrem Standort umfassen.Zeigen Sie gespeicherte Zahlungsmethoden an, wenn verfügbar, um den Checkout zu beschleunigen.

4
Checkout abgeschlossen
Dodo Payments leitet jede Zahlung an den besten Acquirer für diesen Verkauf weiter, um die bestmögliche Erfolgsquote zu erzielen. Die Kunden gelangen in einen Erfolgsworkflow, den Sie erstellen können.

5
Dodo Payments erstellt Abonnement
Dodo Payments erstellt automatisch ein Abonnement für den Kunden, bereit für Sie zur Bereitstellung. Die Zahlungsmethode, die der Kunde verwendet hat, wird für Erneuerungen oder Änderungen des Abonnements gespeichert.

Schnellstart
Starten Sie mit dem Dodo Payments Inline Checkout in nur wenigen Zeilen Code:Schritt-für-Schritt-Integrationsanleitung
1
Installieren Sie das SDK
Installieren Sie das Dodo Payments Checkout SDK:
2
SDK für Inline-Anzeige initialisieren
Initialisieren Sie das SDK und geben Sie
displayType: 'inline' an. Sie sollten auch auf das checkout.breakdown Ereignis hören, um Ihre UI mit Echtzeitsteuer- und Gesamtrechnungen zu aktualisieren.3
Erstellen Sie ein Container-Element
Fügen Sie ein Element zu Ihrem HTML hinzu, in das der Checkout-Rahmen eingefügt wird:
4
Öffnen Sie den Checkout
Rufen Sie
DodoPayments.Checkout.open() mit dem checkoutUrl und dem elementId Ihres Containers auf:5
Testen Sie Ihre Integration
- Starten Sie Ihren Entwicklungsserver:
- Testen Sie den Checkout-Fluss:
- Geben Sie Ihre E-Mail- und Adressdaten im Inline-Rahmen ein.
- Überprüfen Sie, ob Ihre benutzerdefinierte Bestellübersicht in Echtzeit aktualisiert wird.
- Testen Sie den Zahlungsfluss mit Testanmeldeinformationen.
- Bestätigen Sie, dass die Weiterleitungen korrekt funktionieren.
Sie sollten
checkout.breakdown Ereignisse in Ihrer Browser-Konsole sehen, wenn Sie ein Konsolenprotokoll im onEvent Callback hinzugefügt haben.6
Live gehen
Wenn Sie bereit für die Produktion sind:
- Ändern Sie den Modus auf
'live':
- Aktualisieren Sie Ihre Checkout-URLs, um Live-Checkout-Sitzungen von Ihrem Backend zu verwenden.
- Testen Sie den gesamten Fluss in der Produktion.
Vollständiges React-Beispiel
Dieses Beispiel zeigt, wie Sie eine benutzerdefinierte Bestellübersicht zusammen mit dem Inline-Checkout implementieren und sie mithilfe descheckout.breakdown Ereignisses synchron halten.
API-Referenz
Konfiguration
Initialisierungsoptionen
| Option | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
mode | "test" | "live" | Ja | Umgebungsmodus. |
displayType | "inline" | "overlay" | Ja | Muss auf "inline" gesetzt werden, um den Checkout einzubetten. |
onEvent | function | Ja | Callback-Funktion zur Verarbeitung von Checkout-Ereignissen. |
Checkout-Optionen
| Option | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
checkoutUrl | string | Ja | Checkout-Sitzungs-URL. |
elementId | string | Ja | Die id des DOM-Elements, in dem der Checkout gerendert werden soll. |
Methoden
Checkout öffnen
Öffnet den Checkout-Rahmen im angegebenen Container.Checkout schließen
Entfernt programmgesteuert den Checkout-Rahmen und bereinigt die Ereignis-Listener.Status überprüfen
Gibt zurück, ob der Checkout-Rahmen derzeit eingefügt ist.Ereignisse
Das SDK bietet Echtzeitereignisse über dasonEvent Callback. Für den Inline-Checkout ist checkout.breakdown besonders nützlich, um Ihre UI zu synchronisieren.
| Ereignistyp | Beschreibung |
|---|---|
checkout.opened | Checkout-Rahmen wurde geladen. |
checkout.breakdown | Wird ausgelöst, wenn Preise, Steuern oder Rabatte aktualisiert werden. |
checkout.customer_details_submitted | Kundendaten wurden übermittelt. |
checkout.redirect | Checkout wird eine Weiterleitung durchführen (z. B. zu einer Bankseite). |
checkout.error | Ein Fehler ist während des Checkouts aufgetreten. |
Checkout-Breakdown-Daten
Dascheckout.breakdown Ereignis liefert die folgenden Daten:
Verständnis des Breakdown-Ereignisses
Dascheckout.breakdown Ereignis ist der primäre Weg, um die UI Ihrer Anwendung mit dem Checkout-Zustand von Dodo Payments synchron zu halten.
Wann es ausgelöst wird:
- Bei der Initialisierung: Sofort nachdem der Checkout-Rahmen geladen und bereit ist.
- Bei Adressänderung: Immer wenn der Kunde ein Land auswählt oder eine Postleitzahl eingibt, die zu einer Steuerneuberechnung führt.
| Feld | Beschreibung |
|---|---|
subTotal | Die Summe aller Positionen in der Sitzung, bevor Rabatte oder Steuern angewendet werden. |
discount | Der Gesamtwert aller angewendeten Rabatte. |
tax | Der berechnete Steuerbetrag. Im inline Modus wird dies dynamisch aktualisiert, während der Benutzer mit den Adressfeldern interagiert. |
total | Das mathematische Ergebnis von subTotal - discount + tax in der Basiswährung der Sitzung. |
currency | Der ISO-Währungs-Code (z. B. "USD") für die Standard-Zwischensumme, Rabatte und Steuerwerte. |
finalTotal | Der tatsächliche Betrag, den der Kunde berechnet wird. Dies kann zusätzliche Anpassungen des Devisenwechsels oder lokale Zahlungsgebühren umfassen, die nicht Teil der grundlegenden Preisaufstellung sind. |
finalTotalCurrency | Die Währung, in der der Kunde tatsächlich bezahlt. Dies kann von currency abweichen, wenn die Kaufkraftparität oder die lokale Währungsumrechnung aktiv ist. |
- Währungsformatierung: Preise werden immer als Ganzzahlen in der kleinsten Währungseinheit zurückgegeben (z. B. Cent für USD, Yen für JPY). Um sie anzuzeigen, teilen Sie durch 100 (oder die entsprechende Zehnerpotenz) oder verwenden Sie eine Formatierungsbibliothek wie
Intl.NumberFormat. - Umgang mit Anfangszuständen: Wenn der Checkout zum ersten Mal geladen wird, können
taxunddiscount0odernullsein, bis der Benutzer seine Rechnungsinformationen bereitstellt oder einen Code anwendet. Ihre UI sollte diese Zustände elegant handhaben (z. B. durch Anzeigen eines Strichs—oder durch Ausblenden der Zeile). - Der “Endbetrag” vs “Gesamt”: Während
totalIhnen die Standardpreisberechnung gibt, istfinalTotaldie Quelle der Wahrheit für die Transaktion. WennfinalTotalvorhanden ist, spiegelt es genau wider, was der Karte des Kunden belastet wird, einschließlich aller dynamischen Anpassungen. - Echtzeit-Feedback: Verwenden Sie das
taxFeld, um den Benutzern zu zeigen, dass Steuern in Echtzeit berechnet werden. Dies verleiht Ihrer Checkout-Seite ein “Live”-Gefühl und reduziert die Reibung während des Schrittes zur Eingabe der Adresse.
Implementierungsoptionen
Installation über Paketmanager
Installieren Sie über npm, yarn oder pnpm, wie in der Schritt-für-Schritt-Integrationsanleitung gezeigt.CDN-Implementierung
Für eine schnelle Integration ohne Build-Schritt können Sie unser CDN verwenden:TypeScript-Unterstützung
Das SDK ist in TypeScript geschrieben und enthält umfassende Typdefinitionen.Fehlerbehandlung
Das SDK bietet detaillierte Fehlermeldungen über das Ereignissystem. Implementieren Sie immer eine ordnungsgemäße Fehlerbehandlung in IhremonEvent Callback:
Best Practices
- Responsive Design: Stellen Sie sicher, dass Ihr Container-Element genügend Breite und Höhe hat. Das iframe wird typischerweise erweitert, um seinen Container auszufüllen.
- Synchronisation: Verwenden Sie das
checkout.breakdownEreignis, um Ihre benutzerdefinierte Bestellübersicht oder Preistabellen mit dem, was der Benutzer im Checkout-Rahmen sieht, synchron zu halten. - Skeleton States: Zeigen Sie einen Ladeindikator in Ihrem Container an, bis das
checkout.openedEreignis ausgelöst wird. - Bereinigung: Rufen Sie
DodoPayments.Checkout.close()auf, wenn Ihre Komponente unmontiert wird, um das iframe und die Ereignis-Listener zu bereinigen.
Fehlersuche
Checkout-Rahmen wird nicht angezeigt
Checkout-Rahmen wird nicht angezeigt
- Überprüfen Sie, ob
elementIdmit demideinesdivübereinstimmt, das tatsächlich im DOM vorhanden ist. - Stellen Sie sicher, dass
displayType: 'inline'anInitializeübergeben wurde. - Überprüfen Sie, ob die
checkoutUrlgültig ist.
Steuern werden in meiner UI nicht aktualisiert
Steuern werden in meiner UI nicht aktualisiert
- Stellen Sie sicher, dass Sie auf das
checkout.breakdownEreignis hören. - Steuern werden nur berechnet, nachdem der Benutzer ein gültiges Land und eine Postleitzahl im Checkout-Rahmen eingegeben hat.
Browserunterstützung
Das Dodo Payments Checkout SDK unterstützt die folgenden Browser:- Chrome (neueste)
- Firefox (neueste)
- Safari (neueste)
- Edge (neueste)
- IE11+
Apple Pay wird derzeit nicht im Inline-Checkout-Erlebnis unterstützt. Wir planen, die Unterstützung für Apple Pay in einer zukünftigen Version hinzuzufügen.
Inline- vs. Overlay-Checkout
Wählen Sie den richtigen Checkout-Typ für Ihren Anwendungsfall:| Funktion | Inline-Checkout | Overlay-Checkout |
|---|---|---|
| Integrationstiefe | Vollständig in die Seite eingebettet | Modal über der Seite |
| Layoutkontrolle | Volle Kontrolle | Eingeschränkt |
| Branding | Nahtlos | Getrennt von der Seite |
| Implementierungsaufwand | Höher | Niedriger |
| Am besten geeignet für | Benutzerdefinierte Checkout-Seiten, hochkonvertierende Flüsse | Schnelle Integration, bestehende Seiten |
Verwandte Ressourcen
Overlay Checkout
Verwenden Sie den Overlay-Checkout für eine schnelle modalbasierte Integration.
Checkout Sessions API
Erstellen Sie Checkout-Sitzungen, um Ihre Checkout-Erlebnisse zu unterstützen.
Webhooks
Verarbeiten Sie Zahlungsereignisse serverseitig mit Webhooks.
Integrationsleitfaden
Vollständiger Leitfaden zur Integration von Dodo Payments.