Checkout rapido con Stripe: configurazione, offerta, verifica

1. Pulsante: nel carrello, il cliente seleziona un metodo di pagamento, ad esempio Apple Pay o Google Pay.
2. Portafoglio: nella finestra di pagamento, il cliente seleziona l’indirizzo di consegna e il metodo di spedizione. Il negozio calcola quindi le spese di spedizione e l’importo totale.
3. Verifica: dopo il pagamento, il negozio verifica con Stripe se il pagamento è andato a buon fine.
4. Ordine: solo a questo punto il negozio crea l’ordine. Se il cliente non torna sul sito dopo il pagamento, il negozio provvederà a creare l’ordine in un secondo momento.

Nel negozio

1. Aprire il modulo: in Impostazioni → Checkout → Metodi di pagamento, modificare il modulo «Stripe».
2. Attivare: attivare «Pagamento tramite Stripe» e inserire la «Chiave pubblica» e la «Chiave privata» del proprio account Stripe.
3. Selezionare i metodi di pagamento: la tabella «Metodi di pagamento», con il testo di aiuto «Selezionare qui i metodi di pagamento che si desidera offrire tramite Stripe», determina quali dei cinque metodi di pagamento riportati nella panoramica sottostante possono essere visualizzati dal pulsante Express. La stessa tabella determina anche i metodi di pagamento Stripe nel normale processo di ordinazione. Sono possibili più righe, ad esempio «Carte di credito, Apple Pay, Google Pay» e «PayPal».
4. Abilitare l’acquisto rapido: «Abilita Stripe Checkout (acquisto rapido)» rimane attivato, questa è l’impostazione predefinita. Se disattivato, non apparirà alcun pulsante in nessuna delle tre sezioni.
5. Abilitare i metodi di spedizione: nella scheda «Spedizione e pagamento» del modulo Stripe, abilitare i metodi di spedizione che il Wallet deve offrire, oltre a «Spedizione gratuita», anche se non offrite affatto questo metodo di spedizione. Se manca l’abilitazione per «Spedizione gratuita» o per la modalità di spedizione selezionata nel carrello (in assenza di selezione, viene scelta quella più economica), non compare alcun pulsante. Non abilitare per Stripe le modalità di spedizione presenti in «Le spese di spedizione vengono calcolate in un secondo momento (moduli di spedizione)» (Impostazioni → Checkout → Spedizione/Imballaggio): in tal caso, il Wallet addebiterebbe l’importo senza le spese di spedizione.
6. Salva: al momento del salvataggio, il negozio crea o aggiorna il proprio endpoint webhook su Stripe. Tramite il webhook viene informato dei pagamenti, anche se il cliente non torna sul negozio.

Su Stripe

• Registrazione del dominio: nella dashboard di Stripe, registrare ogni dominio su cui compaiono i pulsanti, compresi i sottodomini come www, anche in modalità di prova. Per Apple Pay è obbligatorio. Stripe prevede la registrazione anche per Google Pay, Link, PayPal e Amazon Pay. La registrazione avviene nella pagina «Domini dei metodi di pagamento» (istruzioni di Stripe). Il negozio non dispone di una funzione specifica a tal fine.
• Attivare i metodi di pagamento: i pulsanti visualizzati da Stripe dipendono anche dai metodi di pagamento attivi nel vostro account Stripe. Alcuni devono essere prima attivati lì.
• Klarna: la tabella «Metodi di pagamento» non gestisce Klarna nel pulsante Express. Se Klarna è attivo nel proprio account Stripe, Stripe può mostrarlo anche lì. L’ordine verrà quindi probabilmente generato, come nel caso di PayPal, solo dopo la conferma.
• Dispositivo del cliente: un pulsante Wallet appare solo se il browser, il dispositivo e la valuta supportano quel metodo di pagamento e se il cliente lo ha configurato. Ad esempio, se Google Pay non è configurato, Stripe non mostra il pulsante Google Pay.

Avviso al posto del pulsante

Con la procedura Express, il cliente salta i passaggi del normale processo di ordinazione, compresa la panoramica dell’ordine con i relativi consensi. Nel carrello off-canvas, nella pagina del carrello e nella pagina di accesso, al posto del pulsante Stripe compare quindi un avviso. da 4.10.0

Il cliente effettua quindi l’ordine seguendo la procedura standard. Questi sei motivi determinano la visualizzazione dell’avviso:

• Motivo non applicabile: se il cliente accede con il proprio account, l’opzione «Download senza account» non viene visualizzata. Se carica il file obbligatorio, l’opzione «Caricamento file» non viene visualizzata. Il pulsante ricompare non appena il motivo non è più valido.
• Prodotti personalizzati: non attivano l’avviso.
• Verifica nel negozio: il negozio decide prima di sapere quali portafogli offre il dispositivo. L’avviso compare quindi anche nei casi in cui il dispositivo non offrirebbe alcun portafoglio.
• Carrello modificato successivamente: se il carrello diventa soggetto a verifica solo dopo il caricamento del pulsante, il negozio rifiuta il pagamento prima dell’addebito e mostra l’avviso nella parte superiore della pagina del carrello.
• Altri pulsanti express: Amazon Pay e PayPal Checkout rimangono, poiché reindirizzano alla panoramica dell’ordine.

Pulsante mancante senza avviso

In questi casi, lo spazio del pulsante Stripe rimane vuoto:

• Modulo: «Pagamento tramite Stripe» è disattivato, non è stata inserita alcuna «chiave pubblica» oppure «Consenti Stripe Checkout (acquisto rapido)» è disattivato.
• Spedizione e pagamento: Stripe non è abilitato per la “Spedizione gratuita” o non è abilitato per il metodo di spedizione selezionato nel carrello (in assenza di selezione, viene applicato quello più economico).
• Metodo di pagamento non consentito: per il gruppo di clienti o per il singolo cliente, Stripe non è consentito come metodo di pagamento.
• Importo minimo dell’ordine: l’«Importo minimo dell’ordine» in Impostazioni → Generale → Valori minimi non è stato raggiunto.
• Disponibilità: l’opzione “Verifica disponibilità” in Impostazioni → Checkout → Disponibilità è attivata e un articolo non è disponibile.
• Caratteristiche: una combinazione di caratteristiche nel carrello non è ordinabile.
• Importo: il totale del carrello è pari a 0.
• Dispositivo: Stripe non offre nessuno dei metodi di pagamento abilitati su questo dispositivo.

Se entrambi gli interruttori sono attivati, il testo recita:

Le parti specificate dipendono da due opzioni presenti in Impostazioni → Checkout → Generale. La frase relativa all’obbligo di pagamento e il link alla dichiarazione sulla protezione dei dati sono sempre presenti.

Dove portano i link

• Condizioni generali di contratto: al «file PDF delle condizioni generali di contratto alternative», se si trova nella cartella files/, altrimenti alla pagina CMS delle condizioni generali di contratto, dal campo «Condizioni generali di contratto».
• Informativa sul diritto di recesso: al «file PDF alternativo sul diritto di recesso», altrimenti alla pagina CMS «Diritto di recesso».
• Dichiarazione sulla protezione dei dati: sempre alla pagina CMS «Protezione dei dati».

Si tratta delle stesse destinazioni presenti nella panoramica dell’ordine e tutti i link si aprono in una nuova scheda. I due file PDF si configurano in Impostazioni → Generale → Impostazioni di base.

• Visibilità: l’avviso legale appare solo se Stripe offre almeno un metodo di pagamento sul dispositivo. Laddove l’avviso relativo all’obbligo di verifica sostituisce il pulsante, esso non viene visualizzato.
• Testo personalizzato: in Strumenti → xoLanguage è possibile sovrascrivere il testo con un valore personalizzato (TEXT_EXPRESS_CHECKOUT_LEGAL_HINT e le varianti con _TERMS, _WITHDRAWAL e _PRIVACY). I segnaposto %1$s (Condizioni generali di contratto), %2$s (Informativa sul diritto di recesso) e %3$s (Informativa sulla privacy) indicano i link e devono essere mantenuti. Verificate l’informativa legale dopo ogni modifica cliccando sul pulsante: se manca un segnaposto, manca il link corrispondente, mentre i segnaposto scambiati rimandano alle pagine sbagliate. Scrivete il segno di percentuale come %%; un singolo % può nascondere o alterare l’informativa legale.

• Account cliente anziché ospite: se in Impostazioni → Checkout → Dettagli cliente su always_account o always_account_and_guest_checkbox è selezionato «Registrazione obbligatoria durante la procedura d’ordine», Express crea un account cliente e invia i dati di accesso via e-mail. Ciò vale solo se non esiste ancora un account cliente associato a quell’indirizzo e-mail.
• Numero di telefono: il Wallet lo richiede solo se in Impostazioni → Checkout → Dettagli cliente su mandatory è selezionato «Numero di telefono».

• Modalità di spedizione: se il cliente seleziona un indirizzo nel Wallet, il negozio calcola le relative modalità di spedizione. Se il cliente non ha effettuato l’accesso, il calcolo viene effettuato in base al CAP, alla città e al Paese di tale indirizzo; per i clienti registrati, invece, viene utilizzato l’indirizzo di consegna presente nell’account cliente. Vengono offerte solo le modalità di spedizione per le quali Stripe è abilitato nella sezione “Spedizione e pagamento”; il Wallet mostra il nome e il prezzo.
• Preselezione: viene preselezionata la modalità di spedizione presente nel carrello, altrimenti la prima nell’ordine dei moduli di spedizione.
• Importo: il negozio effettua il calcolo, come al momento della prenotazione, tenendo conto di spese di spedizione, supplementi, sconti, commissioni e tasse. Ad ogni modifica della modalità di spedizione, il calcolo viene ricalcolato.
• Nessuna modalità di spedizione adeguata: se per l’indirizzo non è disponibile alcuna modalità di spedizione o se non è possibile calcolare l’importo totale, il Wallet rifiuta l’indirizzo. Il messaggio relativo proviene dal Wallet, non dal negozio.

Verifica dopo la prenotazione

Dopo la creazione dell’ordine, il negozio confronta l’importo incassato con l’ordine. Se il pagamento non copre l’ordine, questo riceve lo stato da «Stato dell’ordine (pagato in modo asincrono)» o, in assenza di tale impostazione, il proprio stato predefinito anziché lo stato da «Stato dell’ordine (pagato immediatamente)», oltre a una nota interna.

Se l’importo differisce di oltre 1 centesimo o se l’ordine non contiene articoli, il negozio le invia inoltre un’e-mail; veda «E-mail all’operatore». 4.10.0

Ritiro (Click & Collect)

• Selezione filiale: se nel modulo «Click & Collect» la «Selezione filiale» è impostata su « required », il Wallet non offre il ritiro finché il cliente non ha precedentemente selezionato una filiale nel negozio. da 4.10.0
• Metodi di pagamento del punto vendita: se un punto vendita dispone di metodi di pagamento propri senza Stripe, anche in questo caso il ritiro tramite il Wallet non è disponibile.

Le modalità di spedizione si configurano in Impostazioni → Checkout → Modalità di spedizione; per ulteriori informazioni, consultare la guida Spedizione e consegna.

In questi casi lo stato del pagamento non è chiaro:

• Stripe segnala il pagamento come in elaborazione o solo come riservato.
• Al momento non è possibile verificare lo stato, ad esempio in caso di interruzione della connessione o di malfunzionamento di Stripe.
• Il completamento dell’ordine viene interrotto dopo che il denaro è già stato trasferito.
• Il denaro è stato trasferito per il pagamento senza che sia stato generato un ordine, ad esempio in seguito a un reindirizzamento a PayPal o Amazon Pay oppure se la scheda è stata chiusa.

Cosa vede il cliente

Dopo un'interruzione nella finestra di pagamento, il cliente viene reindirizzato alla pagina del carrello. In alto compare uno dei seguenti messaggi:

Dopo il reindirizzamento a PayPal o Amazon Pay, il cliente non torna alla pagina del carrello. I clienti registrati vedono il messaggio corrispondente nella pagina «Informazioni di pagamento», mentre gli ospiti vengono reindirizzati alla pagina di registrazione senza alcun messaggio. Per loro, il messaggio appare non appena tentano nuovamente di pagare con Stripe.

Come funziona il blocco

• Nessun secondo pagamento con Stripe: il negozio rifiuta un nuovo tentativo di pagamento Express prima dell’addebito. Il normale percorso di ordine con Stripe, invece di portare alla pagina di pagamento di Stripe, reindirizza al carrello con il messaggio.
• Pagamento verificato: se un pagamento Express è stato effettuato e verificato, ma non ancora registrato, un nuovo tentativo porta direttamente al completamento dell’ordine anziché a un secondo pagamento.
• Fine del blocco: il blocco termina quando Stripe segnala il pagamento come non effettuato, se esiste un ordine associato al pagamento o, al più tardi, dopo 24 ore.
• Ambito di applicazione: il blocco si applica a Stripe nella sessione del cliente. Non blocca altri metodi di pagamento né altri dispositivi.

1. Notifica: Stripe segnala un pagamento andato a buon fine per il quale il negozio non ha alcun ordine. Il negozio prende nota della notifica.
2. Tempo di attesa: l’ordine viene creato al più presto dopo il tempo specificato in «Ripristino ordine – Ritardo (minuti)». Il valore predefinito è 30 minuti, ma sono consentiti valori compresi tra 5 e 180. Il tempo di attesa impedisce che venga effettuato un doppio ordine nel caso in cui il cliente torni immediatamente.
3. Fattore scatenante: il negozio elabora i messaggi memorizzati quando arriva il successivo webhook da Stripe. Nei periodi di calma, ciò può quindi richiedere molto più tempo rispetto al tempo di attesa impostato.
4. Ordine: la base è l’istantanea del carrello. Al momento del pagamento, il negozio salva al suo interno il contenuto e gli importi del carrello.

Una successiva conferma di pagamento da parte di Stripe imposta lo stato di un ordine Stripe su «Stato dell’ordine (pagato immediatamente)» solo se Stripe conferma l’addebito e l’importo copre la somma addebitata. Un ordine con copertura insufficiente mantiene il proprio stato.

Cosa vedete nell’ordine

• Nota interna: ogni ordine ripristinato riporta nella cronologia una nota che il cliente non vede. Inizia con „Diese Bestellung wurde automatisch vom XONIC Shopsystem restauriert“ e vi invita a verificare la correttezza dell’ordine e l’assenza di duplicati prima di inviare al cliente una conferma d’ordine.
• Nessuna conferma d’ordine: il ripristino non invia al cliente alcuna conferma d’ordine, pertanto il cliente non ha ancora ricevuto nulla dal negozio. Dopo la vostra verifica, provvedete voi stessi a inviarla tempestivamente.

Cosa fare

1. Confronto: per gli ordini con la nota «Importo, articolo, rimborso e contestazione», confrontate i dati con il pagamento nella dashboard di Stripe.
2. Verifica dei duplicati: se esiste già un ordine regolare relativo allo stesso carrello, controllate nella dashboard di Stripe se sono stati ricevuti due pagamenti. Solo in tal caso l’ordine ripristinato costituisce un duplicato. Impostare lo stato su “Annullato”; con la funzione “Storno automatico” attivata nel modulo Stripe, il negozio provvederà a rimborsare il pagamento.
3. Aggiungere: inserire gli articoli mancanti nell’editor degli ordini, vedere Modifica ordini.
4. Conclusione: solo a questo punto impostare lo stato e inviare la conferma d’ordine: nell’editor degli ordini attivare “Invia conferma d’ordine” e cliccare su “Aggiorna”.

• Cosa viene eliminato: l’impostazione consentiva di scegliere tra legacy, il vecchio pulsante Payment Request di Stripe, e new, l’elemento Express Checkout.
• Cosa fa l’aggiornamento: imposta automaticamente l’opzione su new, anche nei casi in cui singoli domini nel Multishop abbiano un proprio valore. Non è necessario modificare l’impostazione stessa.
• Negozi con legacy: dopo l’aggiornamento mostreranno l’elemento Express Checkout, così come le installazioni precedenti prive di questa impostazione. A seconda della selezione nel modulo Stripe, accanto ad Apple Pay e Google Pay appariranno anche Link, PayPal e Amazon Pay.
• PayPal e Amazon Pay: se il vostro negozio utilizzava legacy e nella tabella «Metodi di pagamento» è presente una riga con «PayPal», «Amazon Pay» o «Tutti i metodi di pagamento» (ad esempio per la pagina di pagamento di Stripe), dopo l’aggiornamento questi metodi di pagamento appariranno per la prima volta nel pulsante Express. Non esiste una selezione specifica solo per il pulsante Express. Provate questi metodi di pagamento dopo l’aggiornamento, consultate la sezione «Insidie».
• Modelli personalizzati: non è necessaria alcuna modifica.