# Konfiguration

Ist die Modulinstallation erfolgreich abgeschlossen, ist die richtige Konfiguration entscheidend. Im Allgemeinen sind die Module intuitiv zu bedienen. Sollten Sie einmal nicht weiterkommen, kontaktieren Sie gerne unseren kostenlosen Support im Rahmen des Modulkaufs.

# 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.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/scaled-1680-/2LMgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/2LMgrafik.png)

**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):

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/scaled-1680-/Mmxgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/Mmxgrafik.png)

---

**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):

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/scaled-1680-/HRlgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/HRlgrafik.png)

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

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/scaled-1680-/0g2grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/0g2grafik.png)

#### Klassische Bitcoin-Empfängeradressen

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

<div class="TyagGW_tableContainer" id="bkmrk-format-pr%C3%A4fix-beispi"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1141" data-start="425"><thead data-end="542" data-start="425"><tr data-end="542" data-start="425"><th data-col-size="sm" data-end="438" data-start="425">Format</th><th data-col-size="sm" data-end="450" data-start="438">Präfix</th><th data-col-size="md" data-end="498" data-start="450">Beispiel</th><th data-col-size="md" data-end="542" data-start="498">Beschreibung</th></tr></thead><tbody data-end="1141" data-start="661"><tr data-end="780" data-start="661"><td data-col-size="sm" data-end="674" data-start="661">**P2PKH**</td><td data-col-size="sm" data-end="687" data-start="674">`1...`</td><td data-col-size="md" data-end="736" data-start="687">`1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa`</td><td data-col-size="md" data-end="780" data-start="736">Legacy-Adresse, veraltet, hohe Gebühren</td></tr><tr data-end="900" data-start="781"><td data-col-size="sm" data-end="794" data-start="781">**P2SH**</td><td data-col-size="sm" data-end="807" data-start="794">`3...`</td><td data-col-size="md" data-end="856" data-start="807">`3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy`</td><td data-col-size="md" data-end="900" data-start="856">Für Multisig oder Scripts</td></tr><tr data-end="1021" data-start="901"><td data-col-size="sm" data-end="914" data-start="901">**Bech32**</td><td data-col-size="sm" data-end="927" data-start="914">`bc1q...`</td><td data-col-size="md" data-end="976" data-start="927">`bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh`</td><td data-col-size="md" data-end="1021" data-start="976">Native SegWit (P2WPKH), niedrige Gebühren</td></tr><tr data-end="1141" data-start="1022"><td data-col-size="sm" data-end="1035" data-start="1022">**Taproot**</td><td data-col-size="sm" data-end="1048" data-start="1035">`bc1p...`</td><td data-col-size="md" data-end="1097" data-start="1048">`bc1p5cyxnuxmeuwuvkwfem96l0hu32k6sd59k5u2dd`</td><td data-col-size="md" data-end="1141" data-start="1097">P2TR (seit 2021), Grundlage für BIP-0352</td></tr></tbody></table>

</div></div>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

<div class="TyagGW_tableContainer" id="bkmrk-merkmal-klassische-b"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="3030" data-start="2340"><thead data-end="2435" data-start="2340"><tr data-end="2435" data-start="2340"><th data-col-size="sm" data-end="2370" data-start="2340">Merkmal</th><th data-col-size="sm" data-end="2398" data-start="2370">Klassische BTC-Adresse</th><th data-col-size="md" data-end="2435" data-start="2398">Silent Payment Adresse</th></tr></thead><tbody data-end="3030" data-start="2533"><tr data-end="2637" data-start="2533"><td data-col-size="sm" data-end="2562" data-start="2533">Sichtbarkeit in Blockchain</td><td data-col-size="sm" data-end="2590" data-start="2562">Öffentliche Adresse</td><td data-col-size="md" data-end="2637" data-start="2590">Zieladresse ist nur für Empfänger erkennbar</td></tr><tr data-end="2733" data-start="2638"><td data-col-size="sm" data-end="2667" data-start="2638">Format</td><td data-col-size="sm" data-end="2695" data-start="2667">`1...`, `3...`, `bc1q...`</td><td data-col-size="md" data-end="2733" data-start="2695">`silent:pubkey=...`</td></tr><tr data-end="2836" data-start="2734"><td data-col-size="sm" data-end="2764" data-start="2734">Wiederverwendung</td><td data-col-size="sm" data-end="2792" data-start="2764">Sollte vermieden werden</td><td data-col-size="md" data-end="2836" data-start="2792">Kann **dauerhaft** veröffentlicht werden</td></tr><tr data-end="2933" data-start="2837"><td data-col-size="sm" data-end="2867" data-start="2837">Datenschutz</td><td data-col-size="sm" data-end="2895" data-start="2867">Schwach</td><td data-col-size="md" data-end="2933" data-start="2895">**Sehr hoch**</td></tr><tr data-end="3030" data-start="2934"><td data-col-size="sm" data-end="2964" data-start="2934">Wallet-Kompatibilität</td><td data-col-size="sm" data-end="2992" data-start="2964">Weit verbreitet</td><td data-col-size="md" data-end="3030" data-start="2992">Aktuell nur in Spezialwallets</td></tr></tbody></table>

</div></div>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

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

#### 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:

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/scaled-1680-/ZZ1grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/ZZ1grafik.png)

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

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/scaled-1680-/HtLgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2026-01/HtLgrafik.png)

# Status & Zahlung

Im Tab ***„Status &amp; 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.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/scaled-1680-/X22grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/X22grafik.png)

<span style="color: rgb(68, 68, 68);">**Bestellstatus, nachdem die Bestellung aufgegeben wurde**</span>

<span style="color: rgb(68, 68, 68);">Legt fest, welcher Bestellstatus unmittelbar nach Abschluss der Bestellung gesetzt wird — noch bevor der Kunde die Zahlung ausführt.  
  
</span>[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/scaled-1680-/gg1grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/gg1grafik.png)

---

<span style="color: rgb(68, 68, 68);">**Warten auf Zahlungseingang**</span>

<span style="color: rgb(68, 68, 68);">Setzt den Bestellstatus automatisch auf *„Warten auf Zahlungseingang“*, nachdem der Kunde Bitcoin als Zahlungsart gewählt hat. </span>

---

<span style="color: rgb(68, 68, 68);">**Folgestatus "Warten auf Zahlungseingang"**</span>

<span style="color: rgb(68, 68, 68);">Versendet optional eine zusätzliche E-Mail mit Zahlungsinformationen, sobald der Status *„Warten auf Zahlungseingang“* aktiv ist.</span>

---

<span style="color: rgb(68, 68, 68);">**Zahlungslogo anzeigen**</span>

<span style="color: rgb(68, 68, 68);">Aktiviert die Anzeige des Bitcoin-Logos während der Zahlungsartauswahl im Checkout.</span>

---

<span style="color: rgb(68, 68, 68);">**Logo-Zahlung**</span>

<span style="color: rgb(68, 68, 68);">Ermöglicht das Hochladen eines eigenen Zahlungslogos (32 × 32 px).</span>

---

<span style="color: rgb(68, 68, 68);">**Titel der Zahlungsart** </span>

<span style="color: rgb(68, 68, 68);">Texttitel der Bitcoin-Zahlung im letzten Schritt des Bestellabschlusses optional leer lassen, um ausschließlich das Logo anzuzeigen.</span>

---

<span style="color: rgb(68, 68, 68);">**Beschreibung der Zahlungsart (DE/EN)**</span>

<span style="color: rgb(68, 68, 68);">Zusatztext zur Erklärung der Bitcoin-Zahlung im Checkout; mehrsprachig pflegbar.</span>

# 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.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/scaled-1680-/O4Agrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/O4Agrafik.png)

**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.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/scaled-1680-/38qgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/38qgrafik.png)

**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.