WooCommerce Plugin

​

Einführung

​

Schritt-für-Schritt-Installationsanleitung

1. Laden Sie dodo-payments-for-woocommerce.zip aus der neuesten Version auf GitHub herunter.
   Download Plugin

   Holen Sie sich die neueste Version des Dodo Payments-Plugins für WooCommerce
   Sie können das Plugin auch aus dem WordPress-Pluginverzeichnis installieren. Suchen Sie auf der Seite Plugins hinzufügen nach Dodo Payments for WooCommerce, klicken Sie auf Jetzt installieren, anschließend auf Aktivieren und fahren Sie mit der Konfigurationsanleitung fort.
   WordPress Plugin Directory

   Dodo Payments for WooCommerce von WordPress.org installieren
2. Melden Sie sich als Administrator bei Ihrer WordPress-Website an. WooCommerce muss installiert und aktiviert sein.
3. Gehen Sie zu Plugins → Neues Plugin hinzufügen.
   
4. Klicken Sie auf Plugin hochladen. Daraufhin wird ein Upload-Formular angezeigt.
   
   
5. Klicken Sie auf Durchsuchen… und wählen Sie die heruntergeladene ZIP-Datei aus.
6. Klicken Sie auf Jetzt installieren.
   
7. Klicken Sie nach Abschluss der Installation auf Plugin aktivieren. Sie können das Plugin auch später unter Plugins → Installierte Plugins aktivieren.
   
8. Das Plugin ist installiert, aber noch nicht konfiguriert. Fahren Sie unten mit der Konfigurationsanleitung fort.

​

Konfigurationsanleitung

​

API-Keys und Webhooks einrichten

1. Gehe zu WooCommerce → Settings → Payments oder klicke in der Seitenleiste unter WooCommerce auf Payments.
   
   
2. Aktiviere Dodo Payments, falls es nicht aktiv ist, und klicke anschließend auf Manage.
3. Die Plugin-Einstellungen werden geöffnet. Unter jeder Option wird eine Beschreibung angezeigt. Vergewissere dich, dass Enable Dodo Payments ausgewählt ist, und beginne dann mit Live API Key.
   
4. Aktiviere im Dodo Payments-Dashboard den Schalter Live Mode in der Seitenleiste. Gehe zu Developer → API Keys oder verwende diesen direkten Link und klicke auf Add API key.
   
5. Gib einen Namen für den Schlüssel ein, zum Beispiel WooCommerce Plugin, und klicke auf Create.
   
6. Klicke auf Copy API Key. Das Dashboard zeigt den Schlüssel nur einmal an. Füge ihn unter Live API Key in den Plugin-Einstellungen ein.
   
   
7. Richte als Nächstes den Webhook Signing Key ein. Dodo Payments sendet Zahlungsaktualisierungen per Webhook an deinen Shop. Das Plugin verwendet den Schlüssel, um zu überprüfen, ob jeder Webhook von Dodo Payments stammt.
8. Kopiere am unteren Ende der Plugin-Einstellungen unter Webhook Endpoint die URL. Sie hat das Format https://your-store.com/?wc-api=dodo_payments.
   
9. Gehe im Dodo Payments-Dashboard, weiterhin im Live-Modus, zu Developer → Webhooks und klicke auf Add endpoint.
   
10. Füge die URL aus Schritt 8 unter Endpoint URL ein. Lass Subscribed events leer, um jedes Event zu empfangen, oder wähle nur die Payment-, Refund- und Subscription-Events aus, die das Plugin verarbeitet. Klicke anschließend auf Create endpoint.
    
11. Der Tab Overview des Endpunkts wird geöffnet. Klicke unter Signing secret auf das Augensymbol, um das Secret anzuzeigen, und anschließend auf das Kopiersymbol.
    
12. Füge das Secret unter Live Webhook Signing Key in den Plugin-Einstellungen ein und klicke anschließend auf Save changes.
    
13. Überprüfe Global Tax Category und All Prices are Tax Inclusive. Das Plugin wendet diese Einstellungen an, wenn es ein Produkt in Dodo Payments erstellt. Das geschieht beim ersten Checkout eines Kunden mit diesem Produkt. Danach behält das Produkt die Steuereinstellungen aus dem Dodo Payments-Dashboard bei, wo du sie für jedes Produkt ändern kannst. Test API Key und Test Webhook Signing Key werden nur für den Testmodus benötigt.
    

​

Du bist startklar!

​

Wichtigste Funktionen

• Hosted Checkout: Kunden bezahlen auf einer Dodo Payments-Checkout-Seite und kehren anschließend zur Bestellbestätigungsseite deines Shops zurück.
• Multiple Payment Methods: Der Checkout zeigt die verfügbaren Zahlungsmethoden für den Standort, die Währung und das Gerät des jeweiligen Kunden.
• Order Status Sync: Webhooks setzen die Bestellung auf Completed, Processing, Failed oder Cancelled, sobald sich der Zahlungsstatus ändert. Fehlgeschlagene und stornierte Zahlungen geben die Artikel wieder für den Lagerbestand frei.
• Refunds: Veranlasse Rückerstattungen im Dodo Payments-Dashboard. Wenn eine Rückerstattung erfolgreich ist, setzt das Plugin die Bestellung auf Refunded.
• Subscriptions: Mit WooCommerce Subscriptions werden Statusänderungen in beide Richtungen synchronisiert, auch wenn ein Abonnement gekündigt, pausiert oder reaktiviert wird. Änderungen an den Abonnementdaten in WooCommerce werden nicht synchronisiert.
• Order Notes: Das Plugin fügt für jede Checkout-Session, Statusänderung und jeden Fehler Bestellnotizen hinzu, sodass du jede Zahlung auf der Bestellseite verfolgen kannst.
• Multi-currency Support: Produkte werden in der Währung deines WooCommerce-Shops mit Dodo Payments synchronisiert. Das Flag Allow Currency Selection steuert, ob Kunden die Währung beim Checkout ändern können.

​

Fehlerbehebung

​

Häufige Probleme

1. Fehler bei der Zahlungsabwicklung
   • Überprüfe, ob der API Key dem Plugin-Modus entspricht. Wenn Test Mode deaktiviert ist, verwendet das Plugin Live API Key, der aus dem Dashboard im Live-Modus stammen muss. Wenn Test Mode aktiviert ist, verwendet es Test API Key.
   • Überprüfe die Bestellnotizen. Wenn das Plugin keinen Checkout erstellen kann, fügt es eine Notiz mit dem Fehler hinzu, zum Beispiel eine, die mit Dodo Payments Error: beginnt.
   • Wenn Dodo Payments beim Checkout nicht angezeigt wird, überprüfe, ob deine Checkout-Seite den klassischen Checkout und nicht den Checkout-Block verwendet.
   • Wenn die Bestellung einen Rabattcode enthält, überprüfe, ob es sich um einen einzelnen prozentualen Rabattcode handelt.
   • Live-Zahlungen beginnen, nachdem dein Konto die Account Verification bestanden hat.
2. Probleme bei der Webhook-Synchronisierung
   • Überprüfe, ob Endpoint URL exakt der URL unter Webhook Endpoint in den Plugin-Einstellungen entspricht.
   • Überprüfe, ob der Signing Key im Plugin mit dem Signing secret des Endpunkts übereinstimmt und beide aus demselben Modus stammen.
   • Überprüfe dein PHP-Fehlerprotokoll auf Zeilen, die mit Dodo Payments: beginnen, zum Beispiel Dodo Payments: Could not verify webhook event. Im Live-Modus gibt das Plugin auch dann 200 zurück, wenn die Überprüfung fehlschlägt. Daher zeigen die Dodo Payments-Protokolle die Zustellung als erfolgreich an. Im Testmodus gibt es 401 zurück.
   • Überprüfe, ob deine Website über ein gültiges SSL-Zertifikat verfügt. Endpoint URL akzeptiert nur HTTPS-URLs.
   • Überprüfe, ob dein Server, deine Firewall und deine Sicherheits-Plugins POST-Anfragen an die Webhook-URL von den Dodo Payments-IP-Adressen akzeptieren.
   • Öffne den Tab Logs unter Developer → Webhooks, um jede Zustellung und die Antwort deiner Website anzuzeigen.

​

Support-Ressourcen

• Schreibe eine E-Mail an support@dodopayments.com.
• Lies die Dodo Payments-Dokumentation.

​

Best Practices für die Wartung

1. Aktualisiere das Plugin, sobald eine neue Version veröffentlicht wird, um Sicherheitsupdates und neue Funktionen zu erhalten.
2. Teste alle Zahlungsabläufe im Testmodus, bevor du Live-Zahlungen entgegennimmst.
3. Halte WordPress und WooCommerce auf dem neuesten Stand.
4. Erstelle regelmäßig Backups deiner Website.
5. Beobachte deine Bestellungen und das Dodo Payments-Dashboard auf ungewöhnliche Aktivitäten.
6. Bewahre API Keys sicher auf und teile sie niemals öffentlich.