Documentazione

Plugin WordPress

Un solo plugin per tutto il Suo sito WordPress: un metodo di pagamento crypto in WooCommerce, richieste di pagamento sui Suoi moduli e un'area di pagamento per il Suo page builder. I pagamenti vanno dal wallet del cliente direttamente al Suo; Toreador non detiene mai fondi.

In questa pagina

In breve

Funziona con
WooCommerce (checkout classico e a blocchi), JetFormBuilder, Contact Form 7, Elementor, Gutenberg
Requisiti
WordPress 6.0 o successivo, PHP 7.4 o successivo, un account Toreador con almeno un wallet di ricezione
Chi può collegare un sito
Il titolare o un amministratore dell'organizzazione
Valuta
Il Suo negozio in USD o in EUR. I clienti pagano in stablecoin (USDC, USDT, EURC e altre), sulla rete che scelgono
Versione descritta
0.2.2

Installare il plugin

  1. 1Scarichi il plugin Toreador (un file .zip).
  2. 2In WordPress apra Plugin → Aggiungi nuovo → Carica plugin, scelga il file e faccia clic su Installa ora.
  3. 3Lo attivi. Nel menu di amministrazione compare la voce Toreador.

Niente da attivare: WooCommerce, JetFormBuilder, Contact Form 7, Elementor e Gutenberg vengono rilevati non appena sono attivi.

Collegare il Suo sito

Lei non digita mai una password e non incolla mai una chiave in WordPress. Il sito viene collegato da una schermata di autorizzazione su Toreador e riceve una chiave limitata a questo sito, che può revocare in qualsiasi momento.

  1. 1Apra Toreador nel menu di WordPress e faccia clic su Collegare a Toreador.
  2. 2Acceda a Toreador se necessario. La schermata di autorizzazione indica il Suo sito con il dominio: verifichi che sia il Suo.
  3. 3Scelga l'organizzazione a cui appartiene il sito, poi faccia clic su Autorizzare. Torna in WordPress, collegato.
Amministrazione di WordPress, schermata Toreador, prima del collegamento
La schermata di autorizzazione, su Toreador
Amministrazione di WordPress, schermata Toreador, una volta collegato

Le regole

  • Solo il titolare o un amministratore dell'organizzazione può autorizzare un sito.
  • Per una chiave di produzione, Toreador chiede il codice inviato al Suo indirizzo email se ha effettuato l'accesso più di cinque minuti fa. Una chiave di prova non chiede altro.
  • Il titolare dell'organizzazione riceve un'email a ogni creazione di chiave.
  • La chiave può creare richieste di pagamento e leggere i Suoi pagamenti. Non può cambiare i Suoi wallet di ricezione.

Una volta collegato, il pulsante Testare la connessione verifica in qualsiasi momento che la chiave funzioni ancora.

WooCommerce

Il plugin aggiunge un metodo di pagamento, Pagare in crypto. Lei ragiona in USD o in EUR; il cliente sceglie la stablecoin e la rete su una pagina di pagamento Toreador e paga dal proprio wallet.

Le impostazioni

WooCommerce → Impostazioni → Pagamenti → Toreador.

  • Attivare: mostra il metodo di pagamento al checkout.
  • Titolo e descrizione: ciò che il cliente legge al checkout.
  • Wallet di ricezione: uno dei wallet del Suo account Toreador. L'indirizzo non viene mai digitato in WordPress; Lei aggiunge e rimuove i wallet dalla Sua dashboard Toreador.
  • Configurazione avanzata: selezioni esattamente le stablecoin e le reti che accetta. Per impostazione predefinita viene proposto tutto ciò che è compatibile con il Suo wallet.

Che cosa vede il cliente

  1. 1Al checkout sceglie Pagare in crypto e conferma l'ordine.
  2. 2Una pagina mostra l'importo e un pulsante Aprire la pagina di pagamento. La pagina di pagamento si apre in una nuova scheda.
  3. 3Sceglie una stablecoin e una rete, e paga dal proprio wallet.
  4. 4La pagina dell'ordine si aggiorna da sola: l'ordine è pagato, con la sua transazione.
Il checkout, poi la pagina dell'ordine mentre il cliente paga
La pagina dell'ordine una volta confermato il pagamento

Che cosa vede Lei sull'ordine

  • L'ordine resta in attesa, e pagabile, finché il pagamento non è confermato sulla blockchain. Poi passa a «In lavorazione».
  • Una nota registra l'importo ricevuto, la stablecoin, la rete e l'hash della transazione. Le email dell'ordine riportano gli stessi dettagli.
  • Un pagamento effettuato su una richiesta di pagamento precedente dello stesso ordine non viene applicato da solo: l'ordine viene messo in sospeso perché Lei lo verifichi.

Moduli: JetFormBuilder e Contact Form 7

Un modulo può concludersi con un pagamento crypto: un acconto, una donazione, una prenotazione. Una volta inviato il modulo, sotto compare un pannello di pagamento.

Apra Toreador → Moduli. Sono elencati tutti i moduli del Suo sito; faccia clic su Configurare.

  • Attivare Toreador: mette in servizio la richiesta di pagamento per questo modulo.
  • Wallet di ricezione: il wallet predefinito del Suo account, oppure un altro. Proviene sempre dal Suo account, mai da un campo del modulo.
  • Importo: fissato da Lei, oppure digitato dal visitatore in un campo numerico. Un importo digitato viene verificato di nuovo sul server, tra il minimo e il massimo che Lei fissa.
  • Valuta: USD o EUR.
  • Pagina dopo il pagamento: facoltativa. Senza, il visitatore resta sulla pagina e legge che il pagamento è confermato.
Toreador → Moduli, e le impostazioni di un modulo

JetFormBuilder richiede un passaggio in più nell'editor del modulo: nelle azioni dopo l'invio, aggiunga l'azione Toreador — Richiesta di pagamento crypto. Lì non ha impostazioni; tutto si regola in Toreador → Moduli.

Contact Form 7 non richiede altro. La richiesta di pagamento viene creata anche quando l'email di notifica del modulo non può essere inviata.

Se il wallet di un modulo viene rimosso dal Suo account, la schermata Moduli lo segnala, e i visitatori leggono che il pagamento crypto non è disponibile.

Area di pagamento: Elementor e Gutenberg

Per impostazione predefinita il pannello di pagamento compare subito sotto il modulo. Per collocarlo dove vuole, e dargli lo stile del Suo builder, aggiunga l'area di pagamento.

  • Gutenberg: aggiunga il blocco Toreador — Area di pagamento.
  • Elementor: trascini il widget Toreador — Area di pagamento.

L'area resta invisibile finché il modulo non viene inviato; il pannello di pagamento compare poi al suo interno. Può cambiarne il titolo e l'etichetta del pulsante.

Un modulo con la sua area di pagamento, prima e dopo il pagamento

Come viene confermato un pagamento

Toreador osserva la blockchain. Il Suo sito apprende l'esito in tre modi, perché nessun pagamento vada perso e nessuno venga contato due volte.

1

Una notifica in tempo reale

Toreador invia al Suo sito un messaggio firmato non appena il pagamento è confermato. Serve un indirizzo HTTPS pubblico; il plugin lo registra al collegamento.

2

La pagina stessa

Mentre il cliente attende, la pagina chiede lo stato ogni pochi secondi.

3

Una verifica in background

Ogni cinque minuti il plugin verifica i pagamenti ancora in attesa, anche se il cliente ha chiuso la pagina.

Su un sito senza indirizzo HTTPS pubblico, per esempio una copia locale, le notifiche in tempo reale sono disattivate e la schermata Toreador lo dice. Gli altri due modi continuano a funzionare.

La modalità di prova

  • Sotto il pulsante Collegare, il link «collegare in modalità sandbox» dà al sito una chiave di prova.
  • I pagamenti passano allora su reti di prova, con stablecoin di prova: nessun fondo reale si muove.
  • Prova e produzione sono separate: una chiave di prova non vede mai un pagamento reale. Per passare in produzione, scolleghi e ricolleghi con Collegare a Toreador.

I messaggi che può vedere

« La chiave API è stata revocata o non è più valida »

Perché — Il sito è stato scollegato da App collegate in Toreador, oppure la sua chiave è stata revocata.

Che cosa fare — Ricolleghi il sito. Nel frattempo, la crypto viene rimossa dal checkout.

« Questo wallet non è più nel Suo account Toreador »

Perché — Il wallet di ricezione impostato in WooCommerce o in un modulo è stato rimosso dal Suo account.

Che cosa fare — Scelga un altro wallet nelle impostazioni.

« Quota del piano raggiunta »

Perché — È stato raggiunto il numero di pagamenti confermati incluso nel Suo piano.

Che cosa fare — La crypto viene messa in pausa per un'ora; gli altri metodi di pagamento continuano a funzionare. Cambi piano per riprendere subito.

« Notifiche in tempo reale: inattive »

Perché — Il sito non ha un indirizzo HTTPS pubblico, oppure il Suo piano non include le notifiche in tempo reale.

Che cosa fare — Non si perde nulla: la pagina e la verifica in background continuano a confermare i pagamenti.

« Il pagamento crypto non è disponibile in questo momento »

Perché — È ciò che legge il cliente in uno dei casi qui sopra.

Che cosa fare — Può scegliere un altro metodo di pagamento. Apra la schermata Toreador per vederne la causa.

Per gli sviluppatori

Il plugin offre tre funzioni, uno shortcode e due hook. Le funzioni restituiscono un pagamento solo al cliente dell'ordine, salvo che il Suo codice server chieda diversamente.

  • toreador_order_payment( $order ) — Il pagamento di un ordine WooCommerce: stato, stablecoin, rete, importo, transazione, link all'explorer.
  • toreador_is_paid( $order ) — Vero una volta confermato il pagamento.
  • toreador_create_payment( $args ) — Crea una richiesta di pagamento dal Suo codice e restituisce la sua pagina di pagamento. L'indirizzo di ricezione deve essere un wallet del Suo account.
  • [toreador_order_payment id="123"] — Mostra al cliente di un ordine i dettagli del suo pagamento.
  • toreador_payment_completed — Si attiva quando un ordine è pagato.
  • toreador_payment_status_changed — Si attiva quando un pagamento di un modulo è pagato, scaduto o fallito.

PHP

// Si attiva quando un ordine è pagato.
add_action( 'toreador_payment_completed', function ( $order_id, $payment ) {
    // $payment['token'], $payment['chain'], $payment['amount'], $payment['tx']
}, 10, 2 );

// Crea una richiesta di pagamento dal Suo codice e restituisce la sua pagina di pagamento. L'indirizzo di ricezione deve essere un wallet del Suo account.
$request = toreador_create_payment( array(
    'amount'    => 50,
    'currency'  => 'USD',
    'recipient' => '0x…', // Wallet di ricezione
    'reference' => 'booking-1042',
) );
if ( $request['ok'] ) {
    wp_redirect( $request['pay_url'] );
}

Scollegare e disinstallare

  • Scollegare, nella schermata Toreador di WordPress, fa dimenticare al sito la sua chiave. Per revocare la chiave stessa, apra App collegate nella Sua dashboard Toreador e faccia clic su Scollegare.
  • Eliminare il plugin rimuove le sue impostazioni, la sua chiave e la sua attività pianificata. I Suoi ordini e le relative note di pagamento restano.
La Sua dashboard Toreador, App collegate

Che cosa invia il plugin a Toreador

Solo ciò che serve a un pagamento: l'importo, la valuta, il Suo indirizzo di ricezione, un riferimento dell'ordine e l'origine (WooCommerce o il costruttore di moduli). I dati personali dei clienti non vengono mai inviati.

Rispettiamo la Sua privacy

Utilizziamo cookie analitici per migliorare il nostro servizio. Questi cookie vengono attivati solo con il Suo consenso. I cookie essenziali (autenticazione, lingua ecc.) sono sempre attivi.