Akzeptieren Sie Krypto-Zahlungen auf WordPress mit dem DV.net WooCommerce-Plugin
Die Integration eines Krypto-Zahlungsgateways in Ihren E-Commerce-Shop ist eine hervorragende Möglichkeit, Ihre Kundenbasis zu erweitern und moderne, sichere Zahlungsoptionen anzubieten. DV.net bietet eine leistungsstarke Lösung für die Abwicklung dieser Transaktionen, und das dedizierte WooCommerce-Plugin macht den Integrationsprozess unkompliziert. Diese Anleitung führt Sie Schritt für Schritt durch die Installation und Konfiguration des DV.net WooCommerce-Plugins auf Ihrer WordPress-Website.
Voraussetzungen:
- Eine aktive WordPress-Website.
- Das WooCommerce-Plugin ist installiert und aktiviert.
- Ein aktives DV.net-Konto.
Schritt 1: Holen Sie sich das DV.net WooCommerce-Plugin
Der erste Schritt besteht darin, die Plugin-Dateien herunterzuladen. Anders als Plugins im offiziellen WordPress-Repository erhalten Sie dieses von der DV.net GitHub-Seite.
Navigieren Sie zum offiziellen DV.net WooCommerce-Plugin-Repository: https://github.com/dv-net/dv-woocommerce (Dies wurde in Ihren Dateien bereitgestellt).
- Klicken Sie im rechten Menü auf den Bereich „Releases“.
- Wählen Sie „Source code (zip)“ aus dem Menü der neuesten Version.
- Speichern Sie die .zip-Datei auf Ihrem Computer. Entpacken Sie sie nicht.
Schritt 2: Installieren Sie das Plugin auf Ihrer WordPress-Website
Jetzt laden Sie die heruntergeladene ZIP-Datei in Ihr WordPress-Admin-Dashboard hoch.
- Melden Sie sich in Ihrem WordPress-Adminbereich an (z. B. yourdomain.com/wp-admin).
- Navigieren Sie im linken Menü zu Plugins > Add New.
- Klicken Sie oben auf der Seite „Add Plugins“ auf die Schaltfläche Upload Plugin.
- Klicken Sie auf „Choose File“ und wählen Sie die soeben heruntergeladene Datei dv-woocommerce-main.zip aus.
- Klicken Sie auf Install Now.
- Nachdem WordPress die Installation abgeschlossen hat, klicken Sie auf Activate Plugin. Sie sehen nun „DV.net WooCommerce Plugin“ in Ihrer Liste der aktiven Plugins.
Schritt 3: Beschaffen Sie Ihre DV.net API-Zugangsdaten
Um Ihren Shop mit DV.net zu verbinden, benötigen Sie Ihren API Key, API Secret und die API URL.
- Melden Sie sich in Ihrem DV.net-Kontodashboard an.
- Suchen Sie Ihr Projekt oder erstellen Sie ein neues.
- Navigieren Sie zum Bereich API Keys über Projects -> Edit für das spezifische Projekt (siehe obtaining-api-key-and-secret.md aus den Dokumentationsdateien).
- Sie sehen den API key und secret key. Sie können diese bei Bedarf neu generieren.
- Geben Sie im darunterliegenden Abschnitt die URLs für Webhooks an. Im Grunde benötigen Sie nur den Webhook für erfolgreiche Zahlungen.
Schritt 4: Konfigurieren Sie das DV.net-Gateway in WooCommerce
Mit Ihren API-Schlüsseln können Sie nun die Plugin-Einstellungen in WooCommerce konfigurieren.
- Gehen Sie in Ihrem WordPress-Dashboard zu WooCommerce > Settings.
- Klicken Sie oben auf die Registerkarte Payments.
- In der Liste der Zahlungsmethoden sehen Sie „DV.net“. Klicken Sie ganz rechts auf die Schaltfläche Manage.
- Es öffnet sich die DV.net-Einstellungsseite. Füllen Sie die folgenden Felder aus:
- Enable/Disable: Aktivieren Sie „Enable DV.net“, um diese Zahlungsmethode an der Kasse verfügbar zu machen.
- Title: Dieser Text wird Kunden bei der Auswahl der Zahlungsmethode angezeigt. Zum Beispiel: „Mit Krypto über DV.net bezahlen“.
- Description: Dies ist der kurze Text unter dem Titel. Zum Beispiel: „Sicher mit Kryptowährung bezahlen.“
- API URL: Fügen Sie die API URL ein.
- API Key: Fügen Sie den API Key aus Schritt 3 ein.
- API Secret: Fügen Sie das API Secret aus Schritt 3 ein.
- Klicken Sie unten auf der Seite auf Save changes.
Schritt 5: Konfigurieren Sie den Webhook in Ihrem DV.net-Konto
Ihr Shop ist nun eingerichtet, um Zahlungsanfragen an DV.net zu senden. Der letzte Schritt ist das Einrichten eines Webhooks, damit DV.net Zahlungsstatus-Updates (wie „Paid“ oder „Failed“) an Ihren Shop zurücksenden kann.
- Gehen Sie zurück zu Ihrem DV.net-Kontodashboard.
- Navigieren Sie zum Bereich Webhooks oder Developer.
- Erstellen Sie einen neuen Webhook.
- Payload URL: Dies ist der wichtigste Teil. Die eindeutige Webhook-URL Ihres Shops lautet:
https://example.com/wc-api/dv_gateway/(Denken Sie daran, example.com durch Ihre tatsächliche Website-Adresse zu ersetzen. Stellen Sie sicher, dass https:// verwendet wird). - Platzieren Sie hier die Adresse für Ihren Webhook (für Woo sieht sie etwa so aus:
https://example.com/?wc-api=dv_gateway) - Events: Falls abgefragt, wählen Sie die Ereignisse, auf die dieser Webhook hören soll. Sie sollten alle zahlungsbezogenen Ereignisse aktivieren, wie:
- Confirmed payment
- Unconfirmed payment (z. B. wenn der Kunde seine Zahlung via BTC sendet und ...)
- Processing withdrawal (derzeit von dieser Integration nicht unterstützt)
- Speichern und aktivieren Sie den Webhook in Ihrem DV.net-Dashboard.
Schritt 6: Alles eingerichtet! (Vergessen Sie den Test nicht)
Glückwunsch! Das DV.net-Zahlungsgateway ist nun vollständig in Ihren WooCommerce-Shop integriert.
Als Letztes sollten Sie einen Live-Test durchführen. Am besten gehen Sie so vor:
- Besuchen Sie Ihren Shop wie ein normaler Kunde.
- Legen Sie ein echtes Produkt in den Warenkorb.
- Gehen Sie zur Checkout-Seite.
- Wählen Sie „Mit Krypto über DV.net bezahlen“ (oder den von Ihnen festgelegten Titel).
- Schließen Sie die Bestellung ab und stellen Sie sicher, dass Sie korrekt zur DV.net-Zahlungsseite weitergeleitet werden.
- Wir empfehlen dringend, eine kleine Testtransaktion durchzuführen, um zu bestätigen, dass sich der Bestellstatus in Ihrem WooCommerce-Bereich Orders nach erfolgreicher Zahlung automatisch von „Pending payment“ zu „Processing“ oder „Completed“ ändert.
Wenn sich der Bestellstatus automatisch aktualisiert, war Ihre Integration erfolgreich!