Crypto Payment Handbuch.

So nimmst du Bitcoin, Ethereum, Cardano, Solana und XRP als Zahlung an - mit eigenen Wallets, ohne Zahlungsdienstleister dazwischen.

Zum Plugin: Crypto Payment

Systemvoraussetzungen

Shopware 6.7 und ein gültiger Lizenzschlüssel. Zusätzlich brauchst du für jede Kryptowährung, die du anbieten willst, eine eigene Wallet-Adresse, auf der du Zahlungen empfangen kannst.

Installation

Plugin-ZIP im Shopware-Admin unter Erweiterungen hochladen, installieren und aktivieren. Alternativ über die Konsole:

bin/console plugin:refresh bin/console plugin:install --activate StawCryptoPaymentDirect bin/console cache:clear

Lizenzschlüssel

In der Plugin-Konfiguration wird zuerst der Lizenzschlüssel hinterlegt. Lizenzierung und Updates laufen über unsere Lizenzplattform.

Einrichtung in drei Schritten

  1. Lizenzschlüssel eintragen.
  2. Wallet-Adressen der gewünschten Kryptowährungen hinterlegen.
  3. Zahlungsart im gewünschten Verkaufskanal aktivieren.

Unterstützte Kryptowährungen

Fünf Währungen stehen zur Verfügung: Bitcoin (BTC), Ethereum (ETH), Cardano (ADA), Solana (SOL) und XRP.

Nur was hinterlegt ist, erscheint: Im Checkout werden ausschließlich Währungen angeboten, für die eine Wallet-Adresse eingetragen ist. Du musst also nicht alle fünf anbieten - trage einfach nur die Adressen ein, die du wirklich nutzen willst.

Wallet-Adressen hinterlegen

Je Währung gibt es ein eigenes Feld in der Konfiguration: btcAddress, ethAddress, adaAddress, solAddress und xrpAddress.

Sorgfältig prüfen: Kryptozahlungen sind nicht rückholbar. Eine falsch eingetragene Adresse führt dazu, dass Zahlungen unwiederbringlich an eine fremde oder nicht existierende Wallet gehen. Kopiere die Adressen immer aus deiner Wallet, statt sie abzutippen, und teste jede Währung einmal mit einem Kleinstbetrag.

Zahlungsart im Verkaufskanal aktivieren

Wie jede Zahlungsart in Shopware muss auch diese im jeweiligen Verkaufskanal freigeschaltet werden. Ohne diesen Schritt erscheint sie im Checkout nicht, selbst wenn Adressen hinterlegt sind.

Auswahl im Checkout

Der Kunde wählt die gewünschte Kryptowährung direkt im Checkout aus - nicht erst danach. Angeboten wird nur, was du hinterlegt hast.

Die Abschlussseite

Nach dem Bestellabschluss zeigt die Finish-Seite die passende Wallet-Adresse mit einem Kopieren-Button. Der Kunde überweist den Betrag dann selbst aus seiner Wallet.

Zahlungseingang prüfen und bestätigen

Wichtig zu wissen: Das Plugin führt keine automatische Zahlungsprüfung auf der Blockchain durch. Es zeigt dem Kunden die Wallet-Adresse zur manuellen Überweisung an. Ob und wann die Zahlung eingegangen ist, prüfst du selbst in deiner Wallet, und der Zahlungseingang wird anschließend im Shop manuell bestätigt.

Plane das im Tagesgeschäft ein: Bestellungen mit Kryptozahlung brauchen einen festen Kontrollpunkt, ähnlich wie Vorkasse per Überweisung. Da Kurse schwanken, lohnt sich außerdem eine klare Regel, bis wann eine Zahlung eingehen muss und wie du mit Unter- oder Überzahlungen umgehst.

Anpassbare Texte

Alle Texte lassen sich im Admin ändern. Zwei davon sind vorbelegt:

Bestätigungstext
Bitte senden Sie den genauen Betrag an die unten angegebene Adresse.
Hinweis Netzwerkgebühren
Bitte beachten Sie: Netzwerkgebühren sind nicht im Bestellbetrag enthalten.

Das Plugin ist zweisprachig ausgeliefert, Deutsch und Englisch.

Problemlösung

Eine Währung erscheint nicht im Checkout

Für diese Währung ist keine Wallet-Adresse hinterlegt. Das ist das gewollte Verhalten.

Die Zahlungsart taucht gar nicht auf

Dann ist sie im Verkaufskanal nicht aktiviert, oder es ist keine einzige Adresse eingetragen.

Der Kunde hat gezahlt, die Bestellung steht weiter offen

Das ist so vorgesehen. Der Zahlungseingang wird manuell bestätigt, es gibt keine automatische Blockchain-Prüfung.

Der überwiesene Betrag weicht ab

Netzwerkgebühren gehen zulasten des Kunden und sind nicht Teil des Bestellbetrags - darauf weist der vorbelegte Hinweistext hin. Bei größeren Abweichungen bleibt nur die individuelle Klärung.

Support

Fragen zur Einrichtung oder zum Ablauf beantworten wir gern. Schreib uns über die Kontaktseite oder an info@stoneandwater.online.

Über den Store oder direkt bei uns.

Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.

Direkt über Stone & Water

Ab sofort möglich

Monatlich4,99 €
Halbjährlich24,99 €17 % günstiger
Bester PreisJährlich44,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.

Krypto als Zahlungsart?

Zurück zu Crypto Payment.

Alle Funktionen und Preise findest du auf der Produktseite. Bei Einrichtung und Wallet-Anbindung helfen wir gern.

Zur Produktseite Setup anfragen