Bitcoin - Modul für PrestaShop

• Modulübersicht
• Vorteile
• Kompatibilität
• Installation
• Übersetzungen
• Lizenz
• Downloads
• Konfiguration
• Einstellungen
• Status & Zahlung
• Logs
• Wartung
• FAQ
• BTC-Empfängeradressen erklärt

Modulübersicht

Vorteile

• Globale Zahlungsmethode: Bitcoin wird weltweit genutzt und akzeptiert — ideal für internationale Kunden.

• Keine Bankdaten erforderlich: Zahlung erfolgt direkt per Wallet, ohne Eingabe persönlicher Kontodaten.

• Schnelle Transaktionsbestätigung: Zahlung läuft dezentral über die Blockchain, ohne Verzögerungen durch Banken.

• Keine Währungsumrechnungen: Bitcoin-Zahlung vermeidet Wechselgebühren und schützt vor schwankenden Fremdwährungen.

• Unabhängigkeit von Zahlungsdienstleistern: Keine Registrierung oder Verträge mit Payment-Anbietern notwendig.

• Hohe Zahlungssicherheit: Transparentes Bezahlen via QR-Code oder Zahlungslink — ohne Chargebacks und Fehlüberweisungen.

• Erweiterte Käuferzielgruppe: Erreicht Kunden, die bevorzugt oder ausschließlich mit Kryptowährungen bezahlen.

• Privatsphäre: Silent Payments (BIP-0352) ermöglichen maximale Zahlungssicherheit und Datenschutz, ohne dass Wallet-Adressen öffentlich nachvollziehbar sind.

Kompatibilität

Das Modul "Bitcoin" ist kompatibel mit PrestaShop 8.x. und 9.x. Spezifizierte technischen Angaben oder auch ältere Versionen sind auf der Modulverkaufsseite zu finden und werden regelmäßig gepflegt.

Bitcoin für PrestaShop 9.x

• Kompatibel mit PrestaShop 9
• Mindestens PHP 8.1 - die offizielle Dokumentation empfiehlt PHP 8.4 für optimale Leistung und Sicherheit.

Hinweis: Falls Sie eine andere PrestaShop Version nutzen, können die Screenshots lt. dieser Dokumentation abweichen.

Bitcoin für PrestaShop 8.x

• Kompatibel mit PrestaShop 8.x ab Version 8.x.
• Mindestens PHP 7.1
  
  

Hinweis: Falls Sie eine andere PrestaShop Version nutzen, können die Screenshots lt. dieser Dokumentation abweichen.

Installation

Es ist wichtig, vor der Installation eines Moduls eine vollständige Sicherung Ihrer Website oder Ihres Servers durchzuführen, um Datenverluste zu vermeiden, falls etwas schiefgeht. Wenn Sie unsicher sind oder Bedenken haben, ziehen Sie die Hilfe eines erfahrenen Webentwicklers oder Administrators in Betracht.

1. Gehen Sie im PrestaShop Backoffice zur Modulverwaltung (ehemals Modul-Manager) und klicken Sie auf „Modul hochladen“
2. Ziehen Sie nun die Moduldatei (zip-Datei) per Drag & Drop oder wählen Sie
   die Datei im System-Verzeichnisbaum aus
3. Wählen Sie die hochzuladende ZIP-Datei aus und klicken Sie auf "OK"
4. Ihr Modul wird installiert und erscheint in der Liste der installierten Module
5. Warten Sie bis die Modulinstallation erfolgreich abgeschlossen ist
6. Um mit der Einrichtung zu beginnen, klicken Sie auf "Konfigurieren". Wenn Sie mehrere Shops haben, müssen Sie jeden Shop separat konfigurieren. Bitte wählen Sie Ihren Shop direkt aus dem Menü aus, mit dem Sie beginnen möchten
7. Testen Sie das Modul: Gehen Sie zur Frontend-Ansicht Ihrer Website und überprüfen Sie, ob das Modul wie erwartet funktioniert

Viel Erfolg!

Übersetzungen

Übersetzungen in anderen Sprachen

Das Modul kann in alle verfügbaren Sprachen übersetzt werden. Standardmäßig sind Deutsch und Englisch enthalten.
Um eine Übersetzung vorzunehmen, gehen Sie im Menü links auf „International“ (1) und anschließend auf „Übersetzungen“ (2).
Wählen Sie im Bereich „Programmteil“ die Option „Installierte Module“ (3), anschließend das gewünschte Modul (4) und die gewünschte Sprache (5). Klicken Sie danach auf „Bearbeiten“, um die Übersetzung anzupassen.

Screenshot "Modul Übersetzungen bearbeiten"

Screenshot "Einzelne Felder übersetzen"

Lizenz

• Das Modul unterliegt einer kommerziellen Lizenz. Sie dürfen das Modul auf einer Domain installieren.
• Zu Test- und Debugzwecken ist keine weitere Lizenz notwendig.
  
• Nach Bestellung können Sie die Domain lizenzieren, unter der das Modul verwendet wird.
  
• In Ihrem Kundenkonto können Sie Ihre Lizenzen unter dem Link "Meine Lizenzen" verwalten.
  

Downloads

Aktuelle Modul-Downloads
Bitcoin PrestaShop 9.x
Bitcoin PrestaShop 8.x

Hinweis
Bitte beachten Sie, dass diese Dokumentation eine Momentaufnahme darstellt und sich von älteren oder zukünftigen Versionen unterscheiden kann. Wir sind darum bemüht, unsere Dokumentation aktuell zu halten. Bei Rückfragen oder Unsicherheiten stehen wir Ihnen jederzeit gerne zur Verfügung.

Falls Sie Unterstützung bei der Optimierung Ihres PrestaShop-Shops benötigen, zögern Sie nicht, Gurkcity zu kontaktieren. Unser Support-Team steht Ihnen nicht nur bei der Modulinstallation zur Seite, sondern bietet Ihnen auch umfassende Dienstleistungen als PrestaShop Full-Service-Agentur an.

Konfiguration

Einstellungen

Im Tab „Konfiguration“ werden alle zentralen Funktionen des Bitcoins-Moduls verwaltet. Hier legen Sie fest, wie die Bitcoin-Zahlung im Checkout dargestellt wird, welche Zahlungsinformationen Kunden erhalten und welche Statusabläufe nach Bestellung automatisch ausgeführt werden. Darüber hinaus können Zahlungsdetails, QR-Code-Darstellung und Beschreibungstexte angepasst werden, um den Bezahlvorgang transparent und komfortabel zu gestalten.

Empfängeradresse

Hinterlegt die Bitcoin-Adresse der Kunden an die, die Zahlung gesendet werden soll. Alternativ kann das Feld leer bleiben, wenn stattdessen eine Silent-Payment-Adresse verwendet wird.

Beispiel (klassische Bitcoin-Empfängeradresse im Bech32-Format):

---

Silent Payment Adresse 

Hinterlegt den öffentlichen Silent-Payment-Schlüssel (64-stelliger Hex-Wert), der von kompatiblen Wallets genutzt wird, um automatisch individuelle Empfangsadressen abzuleiten.

Beispiel (Silent-Payment Empfängeradresse in Dana Wallet konfiguriert - Bech32m-kodiert):

Darstellung eines Silent-Payment-QR-Codes im Front Office auf der Bestellbestätigungsseite

Klassische Bitcoin-Empfängeradressen

Klassische Bitcoin-Adressen dienen als öffentliche Zieladressen für den Empfang von BTC. Es gibt drei Hauptformate:

Diese Adressen sind öffentlich sichtbar und jede Transaktion an diese Adresse ist in der Blockchain direkt zuordenbar.

Silent Payment Empfangsadressen (BIP-0352)

Silent Payments sind ein besonders datenschutzfreundlicher Adresstyp, bei dem:

• keine wiederverwendbare BTC-Adresse veröffentlicht wird,

• jede Zahlung automatisch auf einer neuen Zieladresse eingeht,

• der Empfänger Zahlungen durch Scan der Blockchain erkennt – ohne Onchain-Verknüpfung.

Aufbau:

Silent Payments nutzen keinen klassischen Bitcoin-Adress-String, sondern einen sogenannten Scan-PubKey (auch: x-only Public Key). Dieser wird in folgendem Format veröffentlicht:

silent:pubkey=f3c1d4b8e5a1c0d2b7f98ab3d378ff45a56739c0d59d3e49d23e89dd1b35c3af

• Der Schlüssel besteht aus 32 Byte und wird hexadezimal kodiert (64 Zeichen).

• Alternativ verwenden viele Wallets das kompaktere Format mit sp1...-Präfix (Bech32m-kodiert).

• Beide Formate sind gleichwertig – die Unterstützung hängt von der verwendeten Wallet ab.

Für den Empfänger:

• Veröffentlicht nur seinen Scan-PubKey (z. B. in einer der beiden Varianten).

• Erkennt eingehende Zahlungen durch regelmäßiges Scannen der Blockchain.

• Nutzt dazu eine Silent Payments-kompatible Wallet (z. B. Cake Wallet, Dana Wallet, SilentPay).

Für den Sender:

• Muss eine Wallet mit Silent Payments-Sendeunterstützung verwenden.

• Die Zieladresse wird automatisch berechnet und regulär als Taproot-Zahlung durchgeführt.

• Aktuell unterstützte Wallets: u. a. SilentPay, Dana Wallet, Cake Wallet, BitBox02 (nur senden).

---

Unterschiede im Überblick

Silent Payments erhöhen die Privatsphäre erheblich, ohne neue Coins oder zentrale Dienste einzuführen.
Sie basieren auf Taproot und sind vollständig Bitcoin-kompatibel, benötigen aber passende Wallets zur Nutzung.

Silent Payments – Wallet-Kompatibilitätstabelle

Wallet	📥 Empfangen	📤 Senden	Plattform	Hinweise
BitBox02	❌ Nein	✅ Ja	Hardware (Desktop App)	Nur Senden unterstützt (ab Firmware 9.21.0 / App 4.45.0)
BlueWallet	❌ Nein	❌ Nein	Android / iOS	Keine Taproot- oder SP-Unterstützung
Cake Wallet	❌ Nein	❌ Nein	Android / iOS	Kein SP-Fokus
Calke Wallet	✅ Ja	✅ Ja	Android (F-Droid)	Privacy-fokussiert, gute QR/Export-Tools
Dana Wallet	✅ Ja	✅ Ja	Android / Desktop (FOSS)	Aktive SP-Unterstützung, manuell installierbar über F-Droid
Electrum	❌ Nein	❌ Nein	Desktop	Kein offizieller SP-Support
Ledger Live	❌ Nein	❌ Nein	Desktop / Mobile	Kein SP-Support, Taproot vorhanden
Samourai Wallet	❌ Nein	❌ Nein	Android	Fokus auf CoinJoin, kein BIP-352
Shakesco Wallet	✅ Ja	✅ Ja	CLI / Dev Tool	Für technisch versierte Nutzer, CLI-basiert
SilentPay Wallet	✅ Ja	✅ Ja	Android (GitHub Build)	Open Source, vollen BIP-352 Support
Silentium Wallet	✅ Ja	✅ Ja	PWA (Browser)	Modernes Webinterface mit vollständigem SP-Support
Sparrow Wallet	🔄 Bald	🔄 Bald	Desktop	SP-Funktion in Entwicklung (teils via Script nutzbar)
Trezor	❌ Nein	❌ Nein	Hardware (Web App)	Kein Taproot-Support in Core → kein SP
Wasabi Wallet	❌ Nein	❌ Nein	Desktop	Fokus auf CoinJoin, kein SP geplant

Zahlung mit Bitcoin und QR-Codes auf der Bestellbestätigungsseite

Sollten beide Adressen im Modul konfiguriert sein, werden auf der Seite der Bestellbestätigung auch beide QR-Codes angezeigt:

In der Regel erkennt die Wallet beim Scannen des QR-Codes automatisch den Betrag (hier Dana Wallet für Android):

Status & Zahlung

Im Tab „Status & Zahlung“ wird festgelegt, wie die Bitcoin-Zahlung im Bestellprozess abgewickelt wird. Hier bestimmen Sie, welcher Bestellstatus zu welchem Zeitpunkt gesetzt wird, welche Informationen im Checkout angezeigt werden und wie die Zahlungsart visuell dargestellt wird. Dadurch kann der gesamte Zahlungsablauf klar strukturiert und vollständig automatisiert werden.

Bestellstatus, nachdem die Bestellung aufgegeben wurde

Legt fest, welcher Bestellstatus unmittelbar nach Abschluss der Bestellung gesetzt wird — noch bevor der Kunde die Zahlung ausführt.

---

Warten auf Zahlungseingang

Setzt den Bestellstatus automatisch auf „Warten auf Zahlungseingang“, nachdem der Kunde Bitcoin als Zahlungsart gewählt hat. 

---

Folgestatus "Warten auf Zahlungseingang"

Versendet optional eine zusätzliche E-Mail mit Zahlungsinformationen, sobald der Status „Warten auf Zahlungseingang“ aktiv ist.

---

Zahlungslogo anzeigen

Aktiviert die Anzeige des Bitcoin-Logos während der Zahlungsartauswahl im Checkout.

---

Logo-Zahlung

Ermöglicht das Hochladen eines eigenen Zahlungslogos (32 × 32 px).

---

Titel der Zahlungsart 

Texttitel der Bitcoin-Zahlung im letzten Schritt des Bestellabschlusses optional leer lassen, um ausschließlich das Logo anzuzeigen.

---

Beschreibung der Zahlungsart (DE/EN)

Zusatztext zur Erklärung der Bitcoin-Zahlung im Checkout; mehrsprachig pflegbar.

Logs

Moduleinstellungen

Im Tab "Logs" werden die vom Modul erstellten Protokolldateien verwaltet. Diese dienen zur Fehlerdiagnose, zur Nachverfolgung technischer Abläufe und zur Unterstützung bei Wartungsarbeiten.

Vorhandene Logs

Listet alle vom Modul erzeugten Log-Dateien mit Dateinamen, Erstellungsdatum, Dateigröße und der Option zum Löschen.

---

Log-Einstellungen

Hier wird das Log-Level definiert (z. B. Warnung, Fehler, Debug). Eine niedrigere Stufe als Warnung sollte nur für Debug-Zwecke verwendet werden, da sonst sehr große Log-Dateien entstehen können.

Wartung

Der Tab "Wartung" bietet Shopbetreibern eine Übersicht über die technische Integrität des Moduls. Er hilft dabei, mögliche Fehlerquellen zu identifizieren und fehlerhafte Installationen von Hooks, Menüeinträgen, Datenbankstrukturen oder Templates schnell zu beheben.

Hooks

Zeigt alle vom Modul verwendeten Hooks. Nicht eingetragene Hooks können per Klick nachinstalliert werden.

---

Registerkarten

Listet alle Backend-Menüeinträge mit den entsprechenden Berechtigungen (CRUD).

---

Datenbank

Prüft das SQL-Schema und zeigt Abweichungen von der aktuellen Datenbankstruktur.

---

Konfiguration 

Listet die Konfigurationswerte des Moduls. Fehlerhafte Werte können zurückgesetzt und fehlende Konfigurationen direkt installiert werden. 

---

Controller

Zeigt, ob für das Modul Controller installiert werden müssen. Optional können fehlende Controller installiert werden. 

---

Bestellstatus

Kontrolliert, ob spezielle Bestellstatus durch das Modul installiert werden. Optional können fehlende Bestellstatus installiert werden. 

---

Templates

Überprüft, ob die Front-Office-Templates korrekt installiert sind oder im Theme überschrieben wurden. Kritische Versionen werden entsprechend markiert. 

---

Plugins

Zeigt an, wenn weitere Plugins für dieses Moduls verfügbar sind.

---

Erweiterte Optionen 

Dort kann bei Bedarf der Lizenzschlüssel geändert werden. Die jeweils installierten Versionen werden angezeigt. 

FAQ

BTC-Empfängeradressen erklärt

Was ist der Unterschied zwischen einer klassischen Empfängeradresse und einer
Silent Empfänger Adresse?

Empfängeradresse
Die Empfängeradresse ist die klassische Form, Bitcoin an eine andere Person oder ein Unternehmen zu senden. Sie funktioniert ähnlich wie eine Kontonummer im Bankwesen: Der Sender trägt die Adresse ein, und der gewünschte Betrag wird dorthin übertragen. Solche Adressen werden von Wallets erzeugt und können öffentlich weitergegeben werden, zum Beispiel auf Rechnungen, Webseiten oder in Zahlungsanfragen. Da Bitcoin-Transaktionen grundsätzlich in der Blockchain nachvollziehbar sind, kann eine mehrfach verwendete Adresse von Dritten eingesehen und mit Zahlungseingängen verknüpft werden. Aus diesem Grund empfehlen viele Wallets, für jeden Zahlungseingang eine neue Adresse zu verwenden.

Silent Payment Adresse

Die Silent Payment Adresse ist eine moderne Alternative zur klassischen Empfängeradresse und wurde entwickelt, um die Privatsphäre beim Empfang von Bitcoin zu verbessern. Statt eine sichtbare Empfangsadresse weiterzugeben, wird ein öffentlicher Schlüssel verwendet, aus dem kompatible Wallets automatisch für jede Zahlung eine neue, individuelle Empfangsadresse ableiten. Dadurch erscheint auf der Blockchain nicht dieselbe Adresse mehrfach, was Rückschlüsse auf Zahlungseingänge erschwert. Silent Payments eignen sich besonders für Nutzer, die regelmäßig Zahlungen empfangen oder ihre Finanzdaten besser schützen möchten. Voraussetzung ist, dass die verwendeten Wallets diese Funktion unterstützen.

Klassische Bitcoin-Empfängeradressen

Klassische Bitcoin-Adressen dienen als öffentliche Zieladressen für den Empfang von BTC. Es gibt drei Hauptformate:

Diese Adressen sind öffentlich sichtbar und jede Transaktion an diese Adresse ist in der Blockchain direkt zuordenbar.

Silent Payment Empfangsadressen (BIP-0352)

Silent Payments sind ein besonders datenschutzfreundlicher Adresstyp, bei dem:

• keine wiederverwendbare BTC-Adresse veröffentlicht wird,

• jede Zahlung automatisch auf einer neuen Zieladresse eingeht,

• der Empfänger Zahlungen durch Scan der Blockchain erkennt – ohne Onchain-Verknüpfung.

Aufbau:

Silent Payments nutzen keinen klassischen Bitcoin-Adress-String, sondern einen sogenannten Scan-PubKey (auch: x-only Public Key). Dieser wird in folgendem Format veröffentlicht:

silent:pubkey=f3c1d4b8e5a1c0d2b7f98ab3d378ff45a56739c0d59d3e49d23e89dd1b35c3af

• Der Schlüssel besteht aus 32 Byte und wird hexadezimal kodiert (64 Zeichen).

• Alternativ verwenden viele Wallets das kompaktere Format mit sp1...-Präfix (Bech32m-kodiert).

• Beide Formate sind gleichwertig – die Unterstützung hängt von der verwendeten Wallet ab.

Für den Empfänger:

• Veröffentlicht nur seinen Scan-PubKey (z. B. in einer der beiden Varianten).

• Erkennt eingehende Zahlungen durch regelmäßiges Scannen der Blockchain.

• Nutzt dazu eine Silent Payments-kompatible Wallet (z. B. Cake Wallet, Dana Wallet, SilentPay).

Für den Sender:

• Muss eine Wallet mit Silent Payments-Sendeunterstützung verwenden.

• Die Zieladresse wird automatisch berechnet und regulär als Taproot-Zahlung durchgeführt.

• Aktuell unterstützte Wallets: u. a. SilentPay, Dana Wallet, Cake Wallet, BitBox02 (nur senden).

Unterschiede im Überblick

Silent Payments erhöhen die Privatsphäre erheblich, ohne neue Coins oder zentrale Dienste einzuführen.
Sie basieren auf Taproot und sind vollständig Bitcoin-kompatibel, benötigen aber passende Wallets zur Nutzung.

 

Silent Payments – Wallet-Kompatibilitätstabelle

Wallet	📥 Empfangen	📤 Senden	Plattform	Hinweise
BitBox02	❌ Nein	✅ Ja	Hardware (Desktop App)	Nur Senden unterstützt (ab Firmware 9.21.0 / App 4.45.0)
BlueWallet	❌ Nein	❌ Nein	Android / iOS	Keine Taproot- oder SP-Unterstützung
Cake Wallet	❌ Nein	❌ Nein	Android / iOS	Kein SP-Fokus
Calke Wallet	✅ Ja	✅ Ja	Android (F-Droid)	Privacy-fokussiert, gute QR/Export-Tools
Dana Wallet	✅ Ja	✅ Ja	Android / Desktop (FOSS)	Aktive SP-Unterstützung, manuell installierbar über F-Droid
Electrum	❌ Nein	❌ Nein	Desktop	Kein offizieller SP-Support
Ledger Live	❌ Nein	❌ Nein	Desktop / Mobile	Kein SP-Support, Taproot vorhanden
Samourai Wallet	❌ Nein	❌ Nein	Android	Fokus auf CoinJoin, kein BIP-352
Shakesco Wallet	✅ Ja	✅ Ja	CLI / Dev Tool	Für technisch versierte Nutzer, CLI-basiert
SilentPay Wallet	✅ Ja	✅ Ja	Android (GitHub Build)	Open Source, vollen BIP-352 Support
Silentium Wallet	✅ Ja	✅ Ja	PWA (Browser)	Modernes Webinterface mit vollständigem SP-Support
Sparrow Wallet	🔄 Bald	🔄 Bald	Desktop	SP-Funktion in Entwicklung (teils via Script nutzbar)
Trezor	❌ Nein	❌ Nein	Hardware (Web App)	Kein Taproot-Support in Core → kein SP
Wasabi Wallet	❌ Nein	❌ Nein	Desktop	Fokus auf CoinJoin, kein SP geplant

 

Zahlung mit Bitcoin und QR-Codes auf der Bestellbestätigungsseite

Sollten beide Adressen im Modul konfiguriert sein, werden auf der Seite der Bestellbestätigung auch beide QR-Codes angezeigt:

In der Regel erkennt die Wallet beim Scannen des QR-Codes automatisch den Betrag (hier Dana Wallet für Android):