Bepaal de grens van de wallet
Een watch-only wallet kan betalingen detecteren zonder de privé-uitgiftesleutels te bewaren. Een uitgebreide publieke sleutel onthult nog steeds gevoelige walletactiviteit en moet worden beschermd. Lightning-integratie kan een online wallet vereisen en introduceert extra operationeel risico.
Afgestemd op de volledige stack
Een Bitcoin-backend, database, webservice en optionele Lightning-node hebben verschillende opslag- en geheugenbehoeften. Raadpleeg de actuele ondersteunde implementatie-instructies en groeibehoeften voordat je een kleine machine kiest.
Beveilig de handelaarsinterface
Gebruik een toegewijde hostnaam, HTTPS, sterke inlogbeveiliging en beperkte beheerderstoegang. Houd de server bijgewerkt en verifieer webhookhandtekeningen of ondersteunde verificatiemechanismen in de ontvangende applicatie. Verzend geen goederen op basis van alleen een browserredirect.
Back-uppen en afstemmen
Bescherm winkelconfiguratie, database, wallet-herstelinformatie en Lightning-specifiek materiaal volgens de relevante documentatie. Test herstel en verifieer facturen tegen het betalingssysteem, vooral rond verlopen, onderbetaling en terugbetalingen.
Controleer de implementatie en de ketenstrategie
Gebruik de huidige ondersteunde implementatie-instructies, een speciale hostnaam en een geverifieerde HTTPS-route. Een geprunede chain kan de doorlopende opslagvereisten verminderen waar ondersteund, maar rescan- en herstelbehoeften moeten worden begrepen. Kies geen schijf op basis van alleen de huidige chaingrootte; laat ruimte voor de volledige stack en groei.
- Verifieer de betalingscallback vanuit een externe test
- Gebruik testbetalingen voordat je winkel live gaat
- Bevestig het afwikkelingsbeleid voor facturen
Officiële documentatie: Implementatieopties voor BTCPay
Bewaar de uitgiftesleutel waar u die wilt
Een watch-only opstelling kan betalingen detecteren vanuit een uitgebreide publieke sleutel zonder de server de uitgiftesleutel te geven. De xpub is gevoelig omdat deze walletactiviteit kan onthullen. Een hot wallet verandert dit risico door uitgiftecapaciteit online te plaatsen. Beoordeel wallet- en Lightning-bewaring afzonderlijk en volg het ondersteunde back-upproces.
Officiële documentatie: BTCPay-walletmodel
Stel een implementatiechecklist op rond de gekozen stack
Begin met een toegewezen domein, een ondersteunde implementatiemethode, de beoogde chainmodus en voldoende schijfruimte voor synchronisatie. Controleer de upstream Docker-generator en de geselecteerde componenten vóór de installatie; bewaar de niet-geheime implementatiekeuzes zodat een andere machine consistent kan worden herbouwd. Controleer domeinresolutie, certificaatuitgifte en eigenaarschap van het beheerdersaccount voordat je klanten een checkout toont. Een generiek Docker Compose-voorbeeld is geen bewijs dat elke optionele BTCPay-component is geconfigureerd.
- Bepaal welke instantie-eigenaar updates, monitoring, back-ups en incidentrespons beheert.
- Scheid reverse-proxy-blootstelling van private Bitcoin RPC, database en Lightning-administratie.
- Documenteer de herstel-/rescanlimieten van een geprunede backend voordat u een wallet met historische betalingen verbindt.
- Houd een ondersteunde testomgeving of een kleine gecontroleerde betalingsoefening voor integraties achter de hand voordat je waardevolle orders afhandelt.
Officiële documentatie: BTCPay Server: implementatiekeuzes · BTCPay Server: ondersteunde Docker-implementatie
Onderzoek ontbrekende walletbetalingen zonder een seed te importeren
Een winkel kan de xpub/afleidingsinformatie van een wallet gebruiken terwijl de uitgiftesleutel op een ander apparaat blijft. Test ontvangst en het herstelpad met de gekozen wallet. Als BTCPay een factuurbetaling ziet maar een externe wallet deze niet toont, inspecteer dan het afleidingsschema en het gedrag van de adres-gap-limiet voordat u aanneemt dat de fondsen verdwenen zijn. Lange reeksen onbetaalde gegenereerde adressen kunnen de ontdekking van een wallet beïnvloeden. Gebruik ondersteunde walletdiagnostiek in plaats van herstelwoorden naar de server te kopiëren.
Officiële documentatie: BTCPay Server: probleemoplossing voor wallet en afleiding
Facturen afstemmen vóór uitvoering
Leg factuuridentificaties vast en maak de uitvoeringsbewerking idempotent. De terugkeer van een browser naar de winkel is een navigatiegebeurtenis, geen bewijs van afwikkeling. Verifieer de betalingsstatus via je geauthenticeerde serverintegratie, behandel verlopen, late of onderbetaalde facturen expliciet en houd een beoordelingspad voor onopgeloste uitkomsten. Als een callback zich herhaalt, mag het retourneren van een succesvolle bevestiging de bestelling niet tweemaal verzenden of crediteren.
- Test een betaling die vlak voor het verlopen binnenkomt en verifieer dat de bestelling aan de juiste factuur gekoppeld blijft.
- Bewaar database, winkelconfiguratie en wallet-herstelmateriaal in een geteste onafhankelijke back-up.
- Lightning voegt een aparte verantwoordelijkheid voor liquiditeit en kanaalback-ups toe; het herstellen van de volledige VPS van gisteren is geen veilige universele herstelprocedure.
- Het hosten van een BTCPay-instantie voegt geen Lightning of XMR toe aan de KoalaVPS-afrekening voor klanten; betaalmethoden op deze hostingsite blijven de zeven gepubliceerde routes.
Officiële documentatie: Bitcoin ontwikkelaarsgids: betalingsverificatie · LND: noodherstel · Core Lightning: back-ups van wallet en kanalen