Definisci il confine del wallet
Un wallet watch-only può rilevare i pagamenti senza detenere le chiavi private di spesa. Una chiave pubblica estesa rivela comunque attività sensibili del wallet e va protetta. L'integrazione con Lightning può richiedere un wallet online e introduce ulteriori rischi operativi.
Dimensiona per l'intero stack
Un backend Bitcoin, un database, un servizio web e un nodo Lightning opzionale hanno esigenze diverse di storage e memoria. Rivedi le istruzioni di deployment attualmente supportate e i requisiti di crescita prima di scegliere una macchina piccola.
Proteggi l'interfaccia del merchant
Usa un hostname dedicato, HTTPS, una forte protezione del login e un accesso amministrativo limitato. Mantieni il server aggiornato e verifica le firme dei webhook o i meccanismi di verifica supportati nell'applicazione ricevente. Non spedire merci basandoti solo su un redirect del browser.
Esegui il backup e riconcilia
Proteggi la configurazione dello store, il database, le informazioni di recupero del wallet e il materiale specifico di Lightning secondo la documentazione pertinente. Verifica il ripristino e riconcilia le fatture con il sistema di pagamento, in particolare per scadenza, pagamento insufficiente e rimborsi.
Verifica la strategia di distribuzione e della catena
Usa le istruzioni di distribuzione attualmente supportate, un hostname dedicato e una rotta HTTPS verificata. Una catena pruned può ridurre i requisiti di archiviazione continui ove supportata, ma è necessario comprendere le esigenze di rescan e ripristino. Non scegliere un disco solo in base alla dimensione attuale della catena; lascia spazio per l'intero stack e per la crescita.
- Verifica il callback di pagamento da un test esterno
- Usa pagamenti di prova prima di un negozio live
- Conferma la politica di regolamento delle fatture
Documentazione ufficiale: Opzioni di deployment BTCPay
Conserva la chiave di spesa dove intendi
Una configurazione watch-only può rilevare i pagamenti da una chiave pubblica estesa senza fornire al server la chiave di spesa. La xpub è sensibile perché può rivelare l'attività del wallet. Un hot wallet modifica questo rischio mettendo online la capacità di spesa. Esamina separatamente la custodia del wallet e di Lightning e segui il processo di backup supportato.
Documentazione ufficiale: Modello di wallet BTCPay
Crea una lista di controllo per la distribuzione basata sullo stack scelto
Inizia con un dominio dedicato, un metodo di distribuzione supportato, la modalità di catena prevista e spazio su disco sufficiente per la sincronizzazione. Esamina il generatore Docker upstream e i suoi componenti selezionati prima dell'installazione; conserva le scelte di distribuzione non segrete così che un'altra macchina possa essere ricostruita in modo coerente. Verifica la risoluzione del dominio, l'emissione del certificato e la proprietà dell'account amministrativo prima di mostrare un checkout ai clienti. Un esempio generico di Docker Compose non è prova che ogni componente opzionale di BTCPay sia configurato.
- Decidi quale proprietario dell'istanza controlla aggiornamenti, monitoraggio, backup e risposta agli incidenti.
- Separa l'esposizione del reverse proxy dall'RPC Bitcoin privato, dal database e dall'amministrazione Lightning.
- Documenta i limiti di ripristino/rescan di un backend pruned prima di collegare un wallet con pagamenti storici.
- Mantieni un ambiente di test supportato o un piccolo esercizio di pagamento controllato per le integrazioni prima di evadere ordini di valore.
Documentazione ufficiale: BTCPay Server: scelte di distribuzione · BTCPay Server: distribuzione Docker supportata
Indaga i pagamenti del wallet mancanti senza importare un seed
Un negozio può usare le informazioni xpub/derivazione di un wallet mentre la chiave di spesa resta su un altro dispositivo. Testa la ricezione e il percorso di ripristino con il wallet scelto. Se BTCPay vede il pagamento di una fattura ma un wallet esterno non lo mostra, ispeziona il suo schema di derivazione e il comportamento del gap-limit degli indirizzi prima di presumere che i fondi siano spariti. Lunghe sequenze di indirizzi generati non pagati possono influire sulla scoperta di un wallet. Usa la diagnostica supportata del wallet invece di copiare le parole di ripristino nel server.
Documentazione ufficiale: BTCPay Server: risoluzione dei problemi di wallet e derivazione
Riconcilia le fatture prima dell'evasione
Registra gli identificatori delle fatture e rendi idempotente l'operazione di evasione. Il ritorno del browser al negozio è un evento di navigazione, non una prova di regolamento. Verifica lo stato del pagamento tramite la tua integrazione server autenticata, gestisci esplicitamente le fatture scadute, in ritardo o sottopagate e mantieni un percorso di revisione per gli esiti irrisolti. Se un callback si ripete, restituire un riconoscimento di successo non deve spedire o accreditare l'ordine due volte.
- Testa un pagamento in arrivo vicino alla scadenza e verifica che l'ordine rimanga associato alla fattura corretta.
- Conserva database, configurazione dello store e materiale di recupero del wallet in un backup indipendente testato.
- Lightning aggiunge una responsabilità separata di liquidità e backup dei canali; ripristinare l'intero VPS di ieri non è una procedura di ripristino universale sicura.
- Ospitare un'istanza BTCPay non aggiunge Lightning o XMR al checkout cliente di KoalaVPS; i metodi di pagamento su questo sito di hosting restano i suoi sette percorsi pubblicati.
Documentazione ufficiale: Guida per sviluppatori Bitcoin: verifica dei pagamenti · LND: ripristino dopo un disastro · Core Lightning: backup di wallet e canali