Stablecoins in deinem BTCPay-Checkout.

Installation

1. Lade BTCPayServer.Plugins.WhollyCrypto.btcpay und prüfe die Datei mit SHA256SUMS aus dem Release. Nutze die Plugin-Datei, nicht das Quellcode-ZIP von GitHub.
2. Öffne als BTCPay-Admin Manage Plugins → Upload Plugin, lade die Datei hoch und starte BTCPay neu.
3. Store wählen → Plugins → Wholly Crypto. Die Installation allein verbindet noch keinen Store.

Updates spielst du genauso ein. Ein Update der Wholly-Händlersoftware aktualisiert das BTCPay-Plugin nicht.

Store verbinden

1. Erstelle in Wholly ein aktives Projekt und einen Store mit Zahlungsarten, gesicherten Wallets, Kursen und Bestätigungen. Nutze eine aktuelle Installation; das Plugin ist auf die API von 6.4.5 abgestimmt.
2. Kopiere die Projekt-/Store-UUIDs aus Store → Basic → API IDs. Erstelle einen API-Schlüssel mit Lese-/Schreibzugriff nur für dieses Projekt. Aktiviere Store → IPN und kopiere dessen Signierschlüssel, keinen Webhook-Schlüssel.
3. Trage diese Werte in BTCPays Wholly-Einstellungen ein, dazu deine API- und Checkout-Adressen, etwa https://api.example.com und https://pay.example.com. Öffentliches HTTPS auf Port 443, ohne Pfad.
4. Aktiviere Offer Wholly Crypto at checkout, speichere und klicke Test read access. Optional wählst du nur bestimmte erlaubte Zahlungsarten des Stores aus.

Erlaube HTTPS-Callbacks vom Wholly-Server zu BTCPay in beiden Firewalls. Das Plugin setzt die Callback-URL automatisch. Diese Route darf keinen Browser-Login, CAPTCHA oder Basic Auth verlangen. Die Signaturprüfung bleibt aktiv.

Eingebetteter Checkout

Standard ist der Checkout als eigene Seite, besonders praktisch für mobile Wallet-Apps. Für einen iframe:

1. Aktiviere in Wholly unter Store → Advanced die Option Allow embedded checkout. Trage deine genaue BTCPay-HTTPS-Adresse in Allowed HTTPS origins ein, ohne Pfad oder Platzhalter.
2. Wähle im BTCPay-Plugin Customer checkout → Embedded checkout (iframe) und speichere.
3. Teste eine neue Rechnung. Bestehende behalten ihre ursprüngliche Ansicht. Falls der Frame nicht lädt, öffnet Open full checkout dieselbe Rechnung auf einer eigenen Seite.

Browser-Nachrichten und Rücklinks dienen der Navigation, nie als Zahlungsnachweis.

Zahlungsablauf prüfen

Erstelle in einem Teststore eine kleine, positive Fiat-Rechnung. Wähle Stablecoins & crypto · Wholly. Prüfe Checkout, signierte IPN und API-Abgleich bis zur Bestätigung. Liefere erst bei abgeschlossener BTCPay-Rechnung, einmal pro Bestellung.

Test read access prüft weder das Erstellen von Rechnungen noch IPN. Unter Connection und Linked payments findest du Fehler, Bestellreferenzen und Zahlungschecks.