Was Sie brauchen
| Feld | Was es tut |
|---|---|
| API Key | Lässt uns Dodo aufrufen, um den gehosteten Checkout zu erstellen. Geheim. |
| Webhook Signing Secret (whsec_…) | Bestätigt, dass ein Webhook wirklich von Dodo kam. Geheim. |
| Return URL | Wohin der Käufer nach dem Checkout landet. |
Warum wir nach jedem Feld fragen
API Key
Autorisiert das Erstellen des gehosteten Checkouts, sodass die Belastung über Ihr Konto läuft.
Webhook Signing Secret
Beweist, dass ein eingehender Webhook echt von Dodo stammt, sodass niemand ein "bezahlt"-Ereignis fälschen kann. Es ist ein vom API Key getrennter Wert.
Return URL
Schlichte Einstellung: wohin der Käufer nach dem Checkout landet. Nicht geheim.
Einrichten
- Testmodus nutzen (kostenlos)
Dodo hat eine getrennte Testumgebung. Testmodus-Schlüssel laufen gegen den Dodo-Test-Host, und es bewegt sich kein echtes Geld.
- Melden Sie sich bei app.dodopayments.com an.
- Dodo trennt Live- und Test-Schlüssel. Richten Sie zuerst den Test ein, dann wiederholen Sie es live.
- Ihren API Key kopieren
Gehen Sie zu Developer → API Keys und kopieren Sie den Test-Schlüssel zum Verifizieren oder den Live-Schlüssel, um echte Zahlungen anzunehmen.
Dodo → Developer → API Keys - Den Webhook hinzufügen
- Fügen Sie in Dodo einen Webhook hinzu.
- Setzen Sie die Webhook-URL auf die Webhook-Adresse Ihres Projekts (unten).
- Kopieren Sie das Webhook Signing Secret (whsec_…). Fügen Sie einen getrennten Webhook in Test und in Live hinzu.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Im Dashboard verbinden
Anbieter hinzufügen → Dodo Payments. Geben Sie die Return URL und die Live-Gruppe ein (Live-API-Key, Live-Webhook-Signing-Secret). Fügen Sie die optionale Test-Gruppe hinzu, um zuerst zu verifizieren. Die Test-Gruppe ist gepaart: fügen Sie sowohl einen Test-API-Key als auch ein Test-Webhook-Secret hinzu oder lassen Sie beide leer. Live und Test werden getrennt geprüft.
Nachdem Sie verbunden haben
Führen Sie vor dem Live-Gang eine Testzahlung durch:
- Erstellen Sie ein Produkt und setzen Sie seine Umgebung auf Testing. Das betreibt das Produkt mit Ihren Test-Zugangsdaten, sodass Sie eine volle Bestellung aufgeben können, ohne Geld zu bewegen. (Wenn Sie den Test-Satz übersprungen haben, fällt ein Testing-Produkt auf Live zurück, fügen Sie ihn also zuerst hinzu.)
- Setzen Sie den Buy-Button auf eine Seite (eine lokale HTML-Datei reicht), die auf Ihr Projekt zeigt.
- Schließen Sie den Checkout in Dodos Testmodus ab.
- Öffnen Sie den Reiter Transaktionen. Eine neue Zeile erscheint, mit Testing markiert. Wenn ihr Status succeeded erreicht, funktionieren Ihre Zugangsdaten und der Webhook beide von Ende zu Ende.
Schalten Sie die Umgebung des Produkts auf Live, wenn Sie für echte Zahlungen bereit sind.
Fehlerbehebung
Beginnen Sie mit Verifizieren. Klicken Sie im Dashboard Verifizieren (oder Testdaten verifizieren), um Ihren API Key zu prüfen.
Testdaten verifizieren sagt, es seien keine Testdaten gespeichert.
Fügen Sie im Test-Reiter einen Test-API-Key hinzu, speichern Sie den Anbieter, öffnen Sie dann den Dialog erneut und verifizieren Sie.
Zahlung wird abgeschlossen, aber die Bestellung bleibt ausstehend.
Bestätigen Sie, dass die Webhook-URL übereinstimmt und dass das Signing Secret zum Webhook in derselben Umgebung passt (Test-Secret für Test, Live für Live).
Das Speichern der Test-Gruppe wird abgelehnt.
Die Test-Gruppe ist gepaart: fügen Sie sowohl einen Test-API-Key als auch ein Test-Webhook-Secret hinzu oder lassen Sie beide leer.
Bestätigen Sie es von Ende zu Ende.
Dodo Dashboard → Developer → Webhooks → Send Example (oder die Dodo-CLI) auf Ihre Webhook-URL gerichtet, dann beobachten Sie, wie die Bestellung sich aktualisiert.
Gut zu wissen
Nur Einmalzahlungen. Coin Moebius nutzt Dodo für einzelne Zahlungen, nicht für Abos.
Secrets rotieren. Rollen Sie den API Key oder das Webhook-Secret jederzeit, fügen Sie dann den neuen Wert ein. Geheime Felder bleiben beim Bearbeiten leer.
Fragen? Join our Discord