# Utilizzare l'app Stripe per Adobe Commerce (Magento 2) Installare, aggiornare e disinstallare l'app Stripe per Adobe Commerce (Magento 2) > Ti consigliamo di testare il modulo prima di installarlo nel tuo ambiente di produzione. Se si verifica un problema di installazione, consulta la sezione [Risoluzione dei problemi](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md). ## Installare il modulo #### Dal marketplace (consigliato) 1. Effettua un ordine per il modulo tramite il [marketplace Adobe](https://marketplace.magento.com/stripe-stripe-payments.html). 1. Apri un terminale ed esegui il seguente comando nella directory di Adobe Commerce: ```bash composer require stripe/stripe-payments ``` A questo punto, potresti dover inserire il tuo nome utente e la password. Fornisci le tue [chiavi di autenticazione di Adobe Commerce](https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html). Puoi decidere di salvare le tue credenziali rispondendo al messaggio visualizzato da Composer. Se hai salvato le chiavi e visualizzi l’errore `Invalid Credentials`, aggiornale in `~/.composer/auth.json` o elimina questo file ed esegui nuovamente il comando. 1. Configura il modulo eseguendo i comandi seguenti: ```bash php bin/magento setup:upgrade php bin/magento cache:flush php bin/magento cache:clean ``` 1. Se esegui Adobe Commerce in modalità di produzione, devi anche compilare e distribuire i file statici del modulo. ```bash php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` #### Dal pacchetto grezzo 1. Scarica l’[ultima versione](https://github.com/stripe/stripe-magento2-releases/raw/master/stripe-magento2-latest.tgz) del modulo da Stripe. 1. Estrai il modulo nella directory di Adobe Commerce. ```bash tar -xvf stripe-magento2-latest.tgz ``` 1. Installa la libreria PHP di Stripe. ```bash composer require stripe/stripe-php:~17.6 ``` 1. Configura il modulo. ```bash php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento cache:flush ``` 1. Se esegui Adobe Commerce in modalità di produzione, devi anche compilare e distribuire i file statici del modulo. ```bash php bin/magento setup:di:compile php bin/magento setup:static-content:deploy ``` ## aggiorna il modulo Prima di eseguire l’upgrade: - Esegui il backup dei file e del database. - Inizia con il tuo ambiente sandbox. - Conserva una copia di tutte le personalizzazioni apportate al codice originale del modulo. - Dai un’occhiata al [REGISTRO DELLE MODIFICHE](https://github.com/stripe/stripe-magento2-releases/blob/master/CHANGELOG.md). Le versioni di patch (x.x.Y) sono retrocompatibili e non richiedono ulteriori interventi di sviluppo da parte dell’utente dopo l’aggiornamento. Le versioni secondarie e principali potrebbero aggiungere nuove funzioni o modificare il codice in modo incompatibile con le versioni precedenti. Se hai personalizzato il codice del modulo, dovrai trasferire queste personalizzazioni dopo l’aggiornamento e risolvere qualsiasi potenziale conflitto. #### Dal marketplace Esegui i seguenti comandi: ```bash composer remove stripe/stripe-payments composer require stripe/stripe-payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean ``` #### Dal pacchetto grezzo Esegui i seguenti comandi: ```bash php bin/magento module:disable --clear-static-content StripeIntegration_Payments rm -rf app/code/StripeIntegration/Payments tar -xvf stripe-magento2-latest.tgz php bin/magento module:enable StripeIntegration_Payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:flush php bin/magento cache:cleanStripeIntegration_Payments ``` ## Disinstallare il modulo Prima della disinstallazione: - Esegui il backup dei file e del database. - Conserva una copia di tutte le personalizzazioni apportate al codice originale del modulo nel caso in cui sia necessario reinstallarlo in seguito. #### Dal marketplace Esegui i seguenti comandi: ```bash composer remove stripe/stripe-payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean ``` #### Dal pacchetto grezzo Esegui i seguenti comandi: ```bash php bin/magento module:disable --clear-static-content StripeIntegration_Payments composer remove stripe/stripe-php rm -rf app/code/StripeIntegration/Payments php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:flush php bin/magento cache:clean ``` ## Criteri relativi al ciclo di vita La versione più recente del modulo supporta le seguenti versioni di Adobe Commerce: | Versione | Assistenza | | ---------------------------- | -------------------------------------------------------------------------------------------- | | Adobe Commerce 2.0 - 2.3.6 | Non più supportata, l’ultima versione compatibile è `stripe/stripe-payments:2.9.5`. | | Adobe Commerce 2.3.7 - 2.4.x | Attualmente supportato. Consulta la nostra politica sul ciclo di vita per maggiori dettagli. | Per `stripe/stripe-payments:4.5.x` e versioni successive, forniamo correzioni di bug e patch di sicurezza. Stripe consiglia di eseguire l’aggiornamento alla versione più recente pubblicata del modulo. Tutte le versioni sono disponibili nel marketplace Adobe e nel repository GitHub [stripe-magento2-releases](https://github.com/stripe/stripe-magento2-releases). ## Cronologia versioni Scopri le modifiche alla retrocompatibilità nelle versioni dell’app Adobe Commerce (Magento 2). ### Version 4.1 La versione 4.1.0 introduce modifiche per gestire situazioni in cui gli ordini potrebbero essere effettuati e fatturati senza riscuotere il pagamento. Questi scenari includono: - Acquisti di abbonamenti di prova. - Abbonamenti con date di inizio future. - Aggiornamenti o downgrade dei piani di abbonamento esistenti. In precedenza, il modulo rimborsava automaticamente e chiudeva questi ordini con una nota di credito offline. Ora, per migliorare la rendicontazione fiscale: - I rimborsi automatici sono obsoleti. - Gli articoli ordinati in questi scenari hanno un prezzo personalizzato pari a 0. - Questi articoli sono esclusi dal calcolo delle spese di spedizione. Ciò comporta ordini con subtotale, spese di spedizione e imposte pari a zero. Quando i prodotti normali vengono acquistati con abbonamenti, il subtotale, le spese di spedizione e le imposte riflettono solo gli articoli dell’ordine normale. Queste modifiche garantiscono che il totale complessivo dell’ordine corrisponda all’importo del pagamento riscosso alla data dell’ordine. Inoltre, la versione 4.1 cambia la modalità di gestione degli addebiti parziali e dei rimborsi: - In precedenza, le acquisizioni parziali o i rimborsi dalla dashboard Stripe creavano automaticamente fatture o note di credito in Magento. - In questi documenti non erano riportate le singole voci d’ordine, ma solo totali inseriti manualmente, eventuali rettifiche o rimborsi - Questo approccio ha causato problemi con la reportistica fiscale. Nella versione 4.1: - Solo gli acquisti completi e i rimborsi completi danno luogo a fatture automatiche o note di credito. - Per acquisizioni o rimborsi parziali, gli esercenti devono utilizzare il pannello di amministrazione Magento. - Ciò garantisce una corretta ripartizione fiscale sui documenti e una rendicontazione accurata all’API Stripe. ## See also - [Configurare l’app Stripe per Adobe Commerce](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/configuration.md) - [Usare il pannello amministratore di Adobe Commerce](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/admin.md) - [Risoluzione dei problemi](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md)