Vai al contenuto
QR code to Stripe paymentsDocumentazione QR2Stripe

← Tutte le guide

Configurare il plugin WordPress

Il plugin QR2Stripe Pay crea i pagamenti, mostra il codice QR e segna un pagamento come pagato quando Stripe lo conferma.

Temporary Stripe key La chiave A. Usata una sola volta dalla configurazione automatica di Stripe e non salvata.
Location name, Street, City, Postal code, Country (2 letters) L'indirizzo della Terminal Location. Il paese deve corrispondere al paese del vostro account Stripe.
Terminal Location ID L'ID della Terminal Location, inizia con tml_. Compilato dalla configurazione automatica.
Webhook signing secret Il segreto di firma del webhook Stripe, inizia con whsec_. Senza di esso i pagamenti non vengono mai segnati come pagati.
QR mode API (consigliata) o Inline. Vedere l'articolo sulla modalità API e inline.
Website Stripe key (API mode) La chiave B. Invece di salvarla qui potete definire QR2STRIPE_API_KEY in wp-config.php; in tal caso la chiave non è salvata nel database.
QR validity (minutes) Per quanto tempo un codice QR può essere pagato. Il valore predefinito è 10 minuti.
Default currency, Merchant name La valuta dei nuovi pagamenti e il nome dell'esercente mostrato sul telefono.

Installare il plugin: in WordPress aprite Plugin → Aggiungi nuovo → Carica plugin, caricate qr2stripe-pay-VERSION.zip e fate clic su Attiva. Viene creata automaticamente una pagina chiamata Payment con lo shortcode [qr2stripe_payment].

Configurazione automatica di Stripe: aprite QR2Stripe → Settings → Automatic Stripe setup, incollate la chiave A, compilate il nome e l'indirizzo della Location e fate clic su Set up Stripe. Il plugin crea la Terminal Location e il webhook e salva l'ID della Location e il segreto di firma del webhook. La chiave A viene usata una sola volta e non viene salvata. Eliminate subito dopo la chiave A in Stripe.

Scegliete la modalità QR. In modalità API incollate la chiave B in Website Stripe key (API mode) oppure definitela in wp-config.php (vedere il primo esempio). Salvate le impostazioni.

Gli avvisi gialli in cima alle pagine di QR2Stripe indicano cosa manca ancora. Quando scompaiono, il sito web è pronto.

Per eseguire a mano la parte Stripe, create la Location in Stripe (Terminal → Locations, copiate l'ID tml_) e un webhook (Developers → Webhooks → Add endpoint oppure Add destination) per gli eventi di Your account, l'unico evento payment_intent.succeeded e l'URL dell'endpoint del secondo esempio. Mostrate il segreto di firma e incollate l'ID della Location e il segreto nelle impostazioni del plugin. Un webhook non richiede permessi. Deve essere su HTTPS pubblico, localhost non funziona.

L'indirizzo del sito deve usare HTTPS e i permalink devono essere attivi (Impostazioni → Permalink, qualsiasi opzione tranne «Semplice»). Altrimenti l'indirizzo del QR contiene ?rest_route= e l'app lo rifiuta.

define('QR2STRIPE_API_KEY', 'rk_...');
https://YOUR-SITE/wp-json/qr2stripe/v1/stripe-webhook