Stablecoins op je BTCPay-afrekenpagina.

Installeren

1. Downloaden BTCPayServer.Plugins.WhollyCrypto.btcpay en controleer dit met de bij de release behorende SHA256SUMS. Gebruik het pluginbestand, niet de broncode-ZIP van GitHub.
2. Open als BTCPay-beheerder Plugins beheren → Plugin uploaden, upload het bestand en herstart BTCPay.
3. Selecteer een winkel → Plugins → Wholly Crypto. Alleen installeren verbindt geen winkel.

Updates gebruiken hetzelfde uploadproces. Het bijwerken van Wholly-handelaarssoftware werkt de BTCPay-plugin niet bij.

Een winkel verbinden

1. Maak in Wholly een ingeschakeld project/winkel met geaccepteerde methoden, wallets met back-up, koersen en bevestigingen. Gebruik een actuele handelaarsinstallatie; deze connector is gericht op de 6.4.5-API.
2. Kopieer de project-/winkel-UUID's vanuit Winkel → Basis → API-ID's. Maak een tot het project beperkte API-referentie met lees-/schrijfrechten. Schakel Winkel → IPN in en kopieer het ondertekeningsgeheim, geen webhookgeheim.
3. Voer in de Wholly-instellingen van BTCPay die waarden in, plus je API- en afreken-oorsprongen, zoals https://api.example.com en https://pay.example.com. Gebruik publieke HTTPS op poort 443; geen paden.
4. Schakel Wholly Crypto aanbieden bij afrekenenin, sla op en kies daarna Leestoegang testen. Kies eventueel een deel van de geaccepteerde methoden van de winkel.

Sta HTTPS-callbacks van je Wholly-server naar BTCPay door beide firewalls toe. De plugin levert de callback-URL. Houd browseraanmelding, CAPTCHA en Basic Auth uit op die route; handtekeningcontroles moeten ingeschakeld blijven.

Ingebed afrekenen

Afrekenen op een volledige pagina is de standaard, vooral handig voor mobiele walletapps. Voor een iframe:

1. Schakel in Wholly onder Winkel → Geavanceerdde optie Ingebed afrekenen toestaanin. Voeg je exacte BTCPay-HTTPS-oorsprong toe aan Toegestane HTTPS-oorsprongen, zonder pad of jokerteken.
2. Kies in de plugininstellingen van BTCPay Klantafrekening → Ingebed afrekenen (iframe) en sla op.
3. Test een nieuwe factuur. Bestaande facturen behouden hun oorspronkelijke weergavemodus. Volledige afrekenpagina openen blijft voor dezelfde factuur beschikbaar als het frame niet kan laden.

Browserberichten en terugkeerlinks dienen voor navigatie, nooit als betalingsbewijs.

Het betaalproces controleren

Maak een kleine, positieve fiatfactuur in een testwinkel. Selecteer Stablecoins & crypto · Wholly. Verifieer afrekenen, ondertekende IPN en API-verificatie tot en met bevestiging. Handel alleen af op basis van een voldane BTCPay-factuur, één keer per bestelling.

Leestoegang testen test geen factuuraanmaak of IPN. Gebruik Verbinding en Gekoppelde betalingen voor veilige foutmeldingen, bestelreferenties en betalingscontroles.