Per accetta pagamenti in criptovaluta su WooCommerce, installa il modulo gratuito Payora, incolla la tua chiave API e il segreto nelle impostazioni del plugin e registra un URL di callback — https://yoursite.com/?wc-api=payora — nel tuo dashboard Payora. Questa è l'intera configurazione. Dopo di che, un cliente seleziona "Paga con criptovaluta" al checkout, sceglie una moneta su una pagina di pagamento ospitata, la invia e l'ordine WooCommerce passa da pending a pagato da solo quando il webhook firmato raggiunge il tuo server. Nessun processore di carte, nessun conto commerciale, nessuna commissione prelevata dalla vendita.
Cosa succede quando accetti pagamenti in criptovaluta su WooCommerce
WooCommerce tratta Payora come qualsiasi altro gateway di pagamento: appare sotto WooCommerce → Impostazioni → Pagamenti come un metodo che puoi rinominare in base a ciò che i tuoi acquirenti comprendono. Quando qualcuno lo seleziona e clicca su Effettua ordine, accadono tre cose:
- WooCommerce crea l'ordine in
pending. Niente è pagato, niente è spedito. - Il modulo chiama il server API Payora server-to-server con l'ID dell'ordine e il totale del carrello nella valuta del tuo negozio, e riceve un URL di checkout ospitato.
- L'acquirente viene reindirizzato lì, sceglie una moneta e vede un importo fisso, un indirizzo, un codice QR e un conto alla rovescia per il blocco del tasso.
L'acquirente non digita mai un numero di carta, e la tua installazione di WordPress non tocca mai una chiave privata. La quotazione, la derivazione dell'indirizzo e il tracciamento della conferma avvengono al di fuori della tua box. Prova il demo dal vivo primo.
Installazione del gateway di pagamento in criptovaluta WooCommerce
Il modulo è uno dei 22 integrazioni CMS gratuite disponibili nella pagina dei moduli. Un normale ZIP di plugin, niente Composer.
- Crea un account gratuito e genera un
api_key/api_secretcoppia nel dashboard. Registrazione è gratuita. - Scarica il file ZIP di WooCommerce da /moduli, carica sotto Plugin → Aggiungi Nuovo → Carica Plugin, attiva.
- Apri WooCommerce → Impostazioni → Pagamenti → Payora. Incolla la chiave e il segreto, scegli quali monete mostrare, salva.
- Tornando alla dashboard di Payora, imposta l'URL di callback di questo negozio su
https://yoursite.com/?wc-api=payora. - Effettua un piccolo ordine di prova reale e pagalo con qualcosa di economico, come USDT su Tron. Guarda lo stato cambiare da solo.
L'URL di callback è il passaggio che le persone saltano
Salta il passaggio 4 e tutto sembra perfetto fino a quando non lo è. L'acquirente paga, le monete arrivano nel tuo portafoglio — e l'ordine rimane in pending per sempre, perché nulla ha informato WooCommerce che il denaro è arrivato. È l'errore di configurazione più comune e fallisce silenziosamente: nessun errore, solo ordini che non progrediscono mai. Imposta il callback prima della tua prima vendita reale, sul tuo dominio live tramite HTTPS, esattamente come lo serve WordPress.
Perché il webhook segna l'ordine come pagato, non il ritorno dell'acquirente
Il reindirizzamento alla tua pagina di ringraziamento è cosmetico — una conferma per lo shopper, nient'altro. Gli acquirenti chiudono le schede. Il loro telefono squilla durante il pagamento. Pagano da un portafoglio hardware su una macchina diversa da quella con il carrello aperto, o trasmettono la transazione e si allontanano mentre la rete impiega quattro minuti per confermare. Se il tuo negozio trattasse il viaggio di ritorno come prova di pagamento, una parte degli ordini pagati non verrebbe mai contrassegnata come pagata, e tu li troveresti a mano nella casella di supporto.
Quindi il modulo ignora completamente il ritorno come fonte di verità. Payora osserva la catena, attende la regola di finalità di quella moneta, quindi invia un corpo JSON al tuo URL di callback firmato con HMAC-SHA256 sul payload grezzo, portando una finestra di timestamp e una chiave di idempotenza. Ricalcola la firma con il tuo api_secret, la confronta in tempo costante, rifiuta qualsiasi cosa al di fuori della finestra, elimina le chiavi duplicate, controlla l'importo, quindi chiama il payment_complete() di WooCommerce — che porta avanti l'ordine, decrementa lo stock e invia l'email al cliente. Il controllo della firma è trattato in la descrizione del webhook HMAC; il modulo esegue ogni passaggio per te.
La conseguenza pratica è il punto principale: un cliente che paga e chiude la scheda riceve comunque il proprio ordine.
Scegliere quali monete offrire
Decidi quali dei 20+ asset su 9 reti appaiono sulla pagina ospitata. Maggiore scelta non è automaticamente migliore; un muro di loghi fa esitare un acquirente per la prima volta. Un'impostazione predefinita sensata:
| Attivo / rete | Costo per l'acquirente | Perché includerlo |
|---|---|---|
| USDT su Tron (TRC-20) | Cent | Il cavallo da lavoro: stabile, economico, ampiamente detenuto. |
| USDT su TON (Gram) | Cent | Quasi istantaneo; il predefinito all'interno dei portafogli Telegram. |
| USDC su Base o Polygon | Cent | Percorso economico per fondi già su EVM. |
| USDT su Ethereum (ERC-20) | Dollari al picco | Ordini più grandi, dove il gas è rumore. |
| BTC | Varia con il mempool | Detentori di Bitcoin che insistono nel pagare in BTC. |
USDT-TRC20 e TON meritano di essere menzionati. Un trasferimento di USDT su Tron costa solitamente al compratore pochi centesimi; lo stesso USDT su Ethereum in un'ora di punta può costare diversi dollari. Su un ordine di €40, quel divario decide se il carrello si converte, e il compratore paga la commissione di rete in ogni caso, quindi lo sente. Se il tuo ordine medio è piccolo, metti una stablecoin su una rete economica in cima — confronto più approfondito in la guida alle reti USDT.
Tieni comunque abilitato Bitcoin. È più lento e la sua commissione fluttua, ma i clienti che vogliono pagare in BTC sono fermi su questo. Quanto a lungo li fai aspettare è una questione di conferme — vedi quante conferme sono sicure.
Stati degli ordini, HPOS e rimborsi
Il flusso di stato rimane noioso, ed è ciò che desideri:
pending— fattura creata; nulla inviato ancora, o non confermato ancora.on-hold— opzionale: visto on-chain, in attesa di conferme.processingocompleted— webhook verificato, ordine pagato. Prodotti virtuali e scaricabili passano direttamente a completato.cancelled— la fattura è scaduta non pagata; lo stock è rilasciato.
Il modulo è compatibile con HPOS (Archiviazione Ordini ad Alte Prestazioni, le tabelle degli ordini personalizzate che sono predefinite per le nuove installazioni da WooCommerce 8.2) e con archiviazione basata su post legacy: dichiara compatibilità e utilizza l'API CRUD piuttosto che leggere wp_postmeta direttamente, quindi si comporta allo stesso modo in entrambi i casi. Sono supportati sia i checkout basati su blocchi che quelli classici con shortcode.
I rimborsi sono il compromesso onesto di scegliere di accettare pagamenti in criptovaluta su WooCommerce. La criptovaluta non ha chargeback, ed è per questo che la frode nei pagamenti smette di essere un tuo problema — ma nessun pulsante riporta indietro i soldi dal portafoglio del cliente. Un rimborso è un pagamento che invii a un indirizzo fornito dal cliente, dal tuo saldo, firmato offline. Un cambiamento di flusso di lavoro, non un blocco, ma decidi la tua politica prima di attivare il gateway.
Commissioni: 0% per accettare
Payora prende 0% per accettare un pagamento. Questa è la principale ragione per cui utilizzarlo invece di un plugin bitcoin per WordPress che instrada silenziosamente attraverso un processore che prende lo 0,5–1% di ogni vendita. A €10.000 al mese, quella differenza è di €50–100, ogni mese, per un lavoro che il tuo server fa già.
Le commissioni si applicano solo quando trasferisci denaro fuori: 1,5% su pagamenti, trasferimenti e prelievi a un portafoglio esterno nel piano Free, più la commissione di rete della moneta su un pagamento o un prelievo (prelievo minimo $50). Accettare è gratuito. Le commissioni di rete on-chain sono separate, si applicano sempre e nella fase in entrata sono pagate dal mittente. Suddivisione su prezzi.
Dove atterra il denaro
Per impostazione predefinita, Payora accredita ogni pagamento confermato sul tuo saldo Payora. Puoi rimborsare o prelevare da quel saldo secondo il tuo programma, e le configurazioni di liquidazione diretta approvate possono utilizzare materiali di chiave pubblica del commerciante — un xPub o un pool di indirizzi generati offline — dove quella modalità è abilitata e supportata. In quella modalità di liquidazione diretta, le chiavi private rimangono fuori dal server e i pagamenti in uscita sono comunque firmati offline.
Per un proprietario di negozio che è operativo, non ideologico: WooCommerce e WordPress non necessitano mai di chiavi private, e il tuo checkout si basa ancora su webhook firmati invece di reindirizzamenti del browser. Se utilizzi la liquidazione diretta approvata, le meccaniche xPub/watch-only sono spiegate in l'esplainer xPub.
Cosa ti serve per farlo funzionare
PHP 7.4 o superiore — nel 2026, ogni host condiviso ordinario — e nulla oltre a ciò che WordPress richiede già. Nessun Composer, nessun lavoratore di coda, nessun demone. Il modulo avvolge un SDK PHP a file singolo, senza dipendenze; se preferisci chiamare direttamente l'API REST in JSON semplice, questo è documentato in la documentazione.
Una onesta avvertenza: il tuo server deve essere raggiungibile da internet affinché il webhook arrivi — vero in modo triviale per un negozio normale, una vera insidia in fase di staging dietro autenticazione HTTP.
Se gestisci già un negozio WooCommerce, questo è un lavoro di dieci minuti senza costi mensili associati.Crea un account gratuito, incolla le tue chiavi, imposta l'URL di callback e fai un ordine di prova — poi informati su checkout ospitati, fatture e link di pagamento su accetta pagamenti.
Comments