Voraussetzungen
Um die Dodo Payments API zu integrieren, benötigen Sie:- Ein Dodo Payments Händlerkonto
- API-Anmeldeinformationen (API-Schlüssel und Webhook-Geheimschlüssel) aus dem Dashboard
Dashboard-Einrichtung
- Navigieren Sie zum Dodo Payments Dashboard
- Erstellen Sie ein Produkt (Einmalzahlung oder Abonnement)
-
Generieren Sie Ihren API-Schlüssel:
- Gehen Sie zu Entwickler > API
- Detaillierte Anleitung
- Kopieren Sie den API-Schlüssel in die Umgebungsvariable DODO_PAYMENTS_API_KEY
-
Konfigurieren Sie Webhooks:
- Gehen Sie zu Entwickler > Webhooks
- Erstellen Sie eine Webhook-URL für Zahlungsbenachrichtigungen
- Kopieren Sie den Webhook-Geheimschlüssel in die Umgebungsvariable
Integration
Zahlungslinks
Wählen Sie den Integrationspfad, der zu Ihrem Anwendungsfall passt:- Checkout-Sitzungen (empfohlen): Am besten für die meisten Integrationen. Erstellen Sie eine Sitzung auf Ihrem Server und leiten Sie die Kunden zu einem sicheren, gehosteten Checkout weiter.
- Overlay-Checkout: Verwenden Sie dies, wenn Sie eine In-Page-Erfahrung benötigen, die den Checkout als modales Overlay auf Ihrer Website öffnet.
- Inline-Checkout: Betten Sie den Checkout direkt in Ihr Seitenlayout ein, um vollständig integrierte, markenbezogene Checkout-Erlebnisse zu schaffen.
- Statische Zahlungslinks: No-Code, sofort teilbare URLs zur schnellen Zahlungsabwicklung.
- Dynamische Zahlungslinks: Programmgesteuert erstellte Links. Checkout-Sitzungen werden jedoch empfohlen und bieten mehr Flexibilität.
1. Checkout-Sitzungen
Verwenden Sie Checkout-Sitzungen, um eine sichere, gehostete Checkout-Erfahrung für Einmalzahlungen oder Abonnements zu schaffen. Sie erstellen eine Sitzung auf Ihrem Server und leiten den Kunden dann zur zurückgegebenencheckout_url weiter.
Checkout-Sitzungen sind standardmäßig 24 Stunden gültig. Wenn Sie
confirm=true übergeben, sind die Sitzungen 15 Minuten gültig und alle erforderlichen Felder müssen bereitgestellt werden.1
Erstellen Sie eine Checkout-Sitzung
Wählen Sie Ihr bevorzugtes SDK oder rufen Sie die REST-API auf.
- Node.js SDK
- Python SDK
- REST API
2
Leiten Sie den Kunden zum Checkout weiter
Nach der Erstellung der Sitzung leiten Sie zu
checkout_url weiter, um den gehosteten Ablauf zu starten.2. Overlay-Checkout
Für eine nahtlose In-Page-Checkout-Erfahrung erkunden Sie unsere Overlay-Checkout Integration, die es Kunden ermöglicht, Zahlungen abzuschließen, ohne Ihre Website zu verlassen.3. Inline-Checkout
Für vollständig integrierte Checkout-Erlebnisse, die direkt in Ihre Seite eingebettet sind, verwenden Sie unsere Inline-Checkout-Integration. Dies ermöglicht es Ihnen, benutzerdefinierte Bestellübersichten zu erstellen und die vollständige Kontrolle über das Checkout-Layout zu haben, während Dodo Payments die Zahlungsabwicklung sicher übernimmt.4. Statische Zahlungslinks
Statische Zahlungslinks ermöglichen es Ihnen, Zahlungen schnell zu akzeptieren, indem Sie eine einfache URL teilen. Sie können das Checkout-Erlebnis anpassen, indem Sie Abfrageparameter übergeben, um Kundendaten vorauszufüllen, Formularfelder zu steuern und benutzerdefinierte Metadaten hinzuzufügen.1
Erstellen Sie Ihren Zahlungslink
Beginnen Sie mit der Basis-URL und fügen Sie Ihre Produkt-ID hinzu:
2
Fügen Sie grundlegende Parameter hinzu
Fügen Sie wesentliche Abfrageparameter hinzu:
-
Anzahl der zu kaufenden Artikel.
-
URL zur Weiterleitung nach Abschluss der Zahlung.
Die Weiterleitungs-URL enthält Zahlungsdetails als Abfrageparameter, zum Beispiel:
https://example.com/?payment_id=pay_ts2ySpzg07phGeBZqePbH&status=succeeded3
Kundeninformationen vorausfüllen (optional)
Fügen Sie Kunden- oder Rechnungsfelder als Abfrageparameter hinzu, um den Checkout zu optimieren.
Unterstützte Kundenfelder
Unterstützte Kundenfelder
-
Vollständiger Name des Kunden (wird ignoriert, wenn firstName oder lastName angegeben ist).
-
Vorname des Kunden.
-
Nachname des Kunden.
-
E-Mail-Adresse des Kunden.
-
Land des Kunden.
-
Straßenadresse.
-
Stadt.
-
Bundesland oder Provinz.
-
Postleitzahl.
-
true oder false
4
Formularfelder steuern (optional)
Sie können bestimmte Felder deaktivieren, um sie für den Kunden schreibgeschützt zu machen. Dies ist nützlich, wenn Sie bereits die Daten des Kunden haben (z. B. bei angemeldeten Benutzern).
disable…-Flag auf true:- Tabelle der Deaktivierungsflags
| Feld | Deaktivierungsflag | Erforderlicher Parameter |
|---|---|---|
| Vollständiger Name | disableFullName | fullName |
| Vorname | disableFirstName | firstName |
| Nachname | disableLastName | lastName |
disableEmail | email | |
| Land | disableCountry | country |
| Adresszeile | disableAddressLine | addressLine |
| Stadt | disableCity | city |
| Bundesland | disableState | state |
| Postleitzahl | disableZipCode | zipCode |
Das Setzen von
showDiscounts=false deaktiviert und verbirgt den Rabattbereich im Checkout-Formular. Verwenden Sie dies, wenn Sie verhindern möchten, dass Kunden während des Checkouts Gutscheine oder Aktionscodes eingeben.5
Erweiterte Steuerungen hinzufügen (optional)
-
Gibt die Zahlungswährung an. Standardmäßig wird die Währung des Rechnungslandes verwendet.
-
Währungsauswahl anzeigen oder ausblenden.
-
Betrag in Cent (nur für Pay What You Want-Preise).
-
Benutzerdefinierte Metadatenfelder (z. B.
metadata_orderId=123).
6
Teilen Sie den Link
Senden Sie den vollständigen Zahlungslink an Ihren Kunden. Wenn er die Seite besucht, werden alle Abfrageparameter gesammelt und mit einer Sitzungs-ID gespeichert. Die URL wird dann vereinfacht, um nur den Sitzungsparameter zu enthalten (z. B.
?session=sess_1a2b3c4d). Die gespeicherten Informationen bleiben bei Seitenaktualisierungen erhalten und sind während des gesamten Checkout-Prozesses zugänglich.Das Checkout-Erlebnis des Kunden ist jetzt optimiert und basierend auf Ihren Parametern personalisiert.
4. Dynamische Zahlungslinks
Erstellt über API-Aufruf oder unser SDK mit Kundendaten. Hier ist ein Beispiel: Es gibt zwei APIs zur Erstellung dynamischer Zahlungslinks:- Einmal-Zahlungslink-API API-Referenz
- Abonnement-Zahlungslink-API API-Referenz
Stellen Sie sicher, dass Sie
payment_link = true übergeben, um den Zahlungslink zu erhalten.- Node.js SDK
- Python SDK
- Go SDK
- API-Referenz
Nachdem Sie den Zahlungslink erstellt haben, leiten Sie Ihre Kunden weiter, um ihre Zahlung abzuschließen.