Introduzione
WooCommerce è la piattaforma e-commerce più usata al mondo. Integrare BTCPay Server con WooCommerce permette di accettare Bitcoin e Lightning Network direttamente nel tuo negozio WordPress, senza commissioni e senza intermediari.
Requisiti
- WordPress con WooCommerce installato e attivo
- Un server BTCPay Server attivo (self-hosted o hosting gestito)
- Accesso admin al pannello WordPress
Passo 1: Installa il plugin BTCPay for WooCommerce
- Vai su Plugin > Aggiungi nuovo nel pannello WordPress
- Cerca "BTCPay for WooCommerce V2"
- Clicca Installa e poi Attiva
Passo 2: Configura la connessione con BTCPay Server
- Vai su WooCommerce > Impostazioni > Pagamenti
- Clicca su BTCPay Server e poi Gestisci
- Inserisci l’URL del tuo BTCPay Server (es.
https://btcpay.tuodominio.it) - Clicca "Genera credenziali API" — verrai reindirizzato al tuo BTCPay Server
- Autorizza l’accesso e torna su WooCommerce
Passo 3: Configura il webhook
Il webhook permette a BTCPay Server di notificare WooCommerce quando un pagamento viene confermato. Viene configurato automaticamente durante il passo 2, ma verifica che sia attivo:
- In BTCPay Server: Store > Webhooks
- Deve essere presente un webhook verso il tuo sito WooCommerce
- Evento:
InvoiceSettled
Passo 4: Configura Lightning Network
- In BTCPay Server, vai su Store > Lightning
- Attiva il Lightning Node integrato
- Apri canali con liquidità in entrata sufficiente
- In WooCommerce, abilita "Accetta pagamenti Lightning" nelle impostazioni BTCPay
Passo 5: Test del pagamento
- Aggiungi un prodotto al carrello nel tuo negozio
- Scegli Bitcoin come metodo di pagamento al checkout
- Verifica che venga generata la fattura BTCPay con QR code
- Paga con un wallet di test (usa la modalità testnet per i test)
- Verifica che l’ordine venga confermato automaticamente
Opzioni avanzate
- Conversione automatica in euro: configura BTCPay per convertire automaticamente i Bitcoin ricevuti
- Sconto per pagamenti Bitcoin: offri uno sconto del 2% per incentivare l’uso
- Email personalizzate: invia conferme d’ordine con dettagli della transazione Bitcoin
Conclusione
L’integrazione BTCPay Server + WooCommerce è completa in meno di 30 minuti. Se hai bisogno di supporto, il nostro team è disponibile per l’integrazione. Contattaci.