Risoluzione dei problemi di Adobe Commerce

Problemi di installazione

Durante la procedura di installazione con Composer, l’errore più comune è il seguente:

Composer package not found: Could not find a matching version of package stripe/stripe-payments

Per completare la procedura e mettere in sicurezza le tue credenziali di accesso, attieniti ai seguenti passaggi:

1. Ordina il modulo dal marketplace Adobe.
2. Elimina il file in ~/.composer/auth.json nel caso in cui tu abbia inserito le chiavi API Adobe Commerce errate.
3. Esegui di nuovo il comando Composer. Potrebbe essere necessario immettere un nome utente e una password. Assicurati di inserire le chiavi API di Adobe Commerce relative all’account che hai usato per effettuare l’ordine. Puoi ottenere le tue chiavi di autenticazione da Adobe Commerce.

Upgrade e problemi di memorizzazione nella cache

Se aggiorni il modulo, ma per qualche motivo non vedi le nuove modifiche, puoi cancellare manualmente la cache di Adobe Commerce eliminando una serie di directory. Nella documentazione ufficiale di Adobe Commerce vengono indicate le directory da eliminare per Adobe Commerce 2.3 e Adobe Commerce 2.4.

Dopo aver eliminato queste directory, esegui i seguenti comandi:

php bin/magento setup:upgrade
php bin/magento cache:flush

Se sei in modalità di produzione, devi compilare e distribuire le tue risorse statiche:

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Se stai utilizzando Varnish, devi riavviarlo dopo aver eliminato i file var/cache/*. Alcuni browser memorizzano nella cache anche le richieste Adobe Commerce. Se hai ancora problemi di memorizzazione nella cache, prova con un altro browser.

Nessun metodo di pagamento al completamento della transazione

The payment method might not show at checkout for a few possible reasons:

• You’re missing the Stripe PHP library or you’re using an old version. You can install this dependency by following step 3 of the installation instructions.
• Hai un altro modulo Stripe installato che usa una vecchia versione della libreria PHP di Stripe. Disabilita o disinstalla qualsiasi altro modulo Stripe attivo.
• You didn’t configure the Stripe API keys properly.
• Hai limitato la disponibilità del metodo di pagamento a determinati Paesi o valute.

Apple Pay o Google Pay non vengono visualizzati

If you configured the Payment Request button and it still doesn’t appear, try the following:

• Assicurati di aver abilitato Apple Pay e Google Pay nelle impostazioni dei metodi di pagamento.
• Per Apple Pay, usa Safari su un iPhone con iOS 10 o versioni successive.
• Per Google Pay, usa Chrome Desktop o Chrome Mobile da un account che ha effettuato l’accesso su Google.
• Assicurati di avere almeno una carta nel wallet.
  • Per aggiungere una carta in iOS, vai su Impostazioni > Wallet > Apple Pay.
  • Puoi aggiungere una carta in Chrome selezionando Impostazioni > Compilazione automatica > Metodi di pagamento > Aggiungi nuova carta di credito.
• Conferma che il tuo dispositivo iOS supporta Apple Pay.
• Conferma che il tuo dispositivo Android supporta Google Pay.
• Conferma che il tuo dominio è registrato e verificato.
• Se il dominio del tuo sito web inizia con www, assicurati che il dominio sia www.example.com e non example.com.
• Devi pubblicare il tuo sito web tramite HTTPS utilizzando un certificato TLS 1.2 valido. Puoi verificarlo dal browser o da SSL Labs.
• Assicurati che la tua pagina HTTPS non carichi immagini, CSS o JavaScript da URL non sicuri. Per eseguire questa verifica, fai clic sulla barra dell’URL nel browser.
• Assicurati di aver abilitato il pulsante Wallet nella sezione di configurazione del modulo.
• Assicurati di aver configurato un Paese di riserva predefinito (Negozi > Configurazione > Generale > Opzioni Paese > Paese predefinito.
• Verifica di non utilizzare una chiave API Stripe obsoleta. Apple Pay richiede una chiave API aggiornata, che inizia con pk_live_ o pk_test_. Puoi revocare la tua chiave pubblicabile nella sezione Sviluppatori della Dashboard.
• Se utilizzi un modulo OneStepCheckout, potresti dover configurare anche il modulo OSC per aggiornare il modulo di pagamento quando i clienti ospiti inseriscono il loro indirizzo di fatturazione. Nella maggior parte dei casi, questa operazione non è necessaria.

Se Apple Pay viene visualizzato al momento del pagamento, ma non compare nelle pagine di prodotto, può dipendere da altri motivi:

• Hai disabilitato i pagamenti degli ospiti dal pannello amministratore di Adobe Commerce.
• Il tuo sito web gestisce le pagine dei prodotti senza un certificato TLS 1.2 valido.
• Hai sovrascritto il modello del pulsante Aggiungi al carrello nel tema. Prova ad aggiungere del testo a app/code/StripeIntegration/Payments/view/frontend/templates/express/product_button.phtml. Se le pagine dei prodotti rimangono invariate, personalizza il tuo tema e integra i due modelli insieme.
• Si verificano errori JavaScript durante l’inizializzazione di Stripe.js. Verifica la presenza di errori JavaScript relativi a Stripe.js nella console del browser.

Ordine in sospeso bloccato

Un ordine appena creato si trova inizialmente nello stato Pending Payment, a indicare che l’autorizzazione del pagamento da parte della banca del cliente è ancora in sospeso. Per tutti i metodi di pagamento basati su reindirizzamento, Stripe invia una notifica al tuo sito web utilizzando i webhook quando viene concessa un’autorizzazione. Se lo stato dei tuoi ordini non passa da Pending Payment a Processing, è possibile che i webhook siano mancanti o non corretti.

Vai alle impostazioni webhook per verificare se esiste un endpoint del webhook con l’URL del tuo negozio. In caso contrario, puoi provare a crearlo manualmente eseguendo il seguente comando dalla directory radice di Magento:

bin/magento stripe:webhooks:configure

Se l’endpoint del webhook esiste già, controlla il Tasso di errore per identificare i webhook con errori. Fai clic sull’endpoint del webhook per visualizzare i messaggi di errore. Per ricevere assistenza su problemi del webhook non dovuti a una configurazione errata del server, contatta l’assistenza Stripe e condividi i dettagli degli errori che hai riscontrato.

Una volta risolto il problema del webhook, devi inviare nuovamente gli eventi charge.succeeded non consegnati correttamente sul tuo sito web. Il modulo fornisce tre comandi per inviare nuovamente un singolo evento, un intervallo di eventi o eventi all’interno di un intervallo di date:

bin/magento stripe:webhooks:process-event [-f|--force] <event_id>
bin/magento stripe:webhooks:process-events-range <from_event_id> <to_event_id>
bin/magento stripe:webhooks:process-events-date-range <from_date> [<to_date>]

Puoi visualizzare un elenco di tutti gli eventi charge.succeeded non riusciti nella sezione Sviluppatori della tua Dashboard Stripe e decidere quali inviare di nuovo utilizzando uno dei comandi sopra riportati.

Registrazione degli errori ed errori lato server (HTTP 500)

Adobe Commerce registra tutti gli errori e le eccezioni che incontra durante l’esecuzione dell’applicazione nella directory var/log. Puoi trovare questi errori nei due file seguenti:

var/log/system.log
var/log/exception.log

Se hai accesso tramite SSH, puoi filtrare i messaggi di errore con il seguente comando:

grep -i Stripe var/log/system.log

Puoi visualizzare gli errori in tempo reale nella console nel momento in cui si verificano (o quando aggiorni una pagina). Per monitorare gli errori, esegui il comando seguente per visualizzare il registro degli errori:

tail -f var/log/*

Se non hai accesso alla shell, puoi scaricare questo file e cercare gli errori Stripe con un editor di testo.