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