--- title: "Magento 2" description: "Documentazione del plugin Magento 2 per Fabrick Payment Orchestra. Guida completa all'installazione, configurazione e gestione dei pagamenti tramite il plugin Ecommerce Sella per Magento 2." url: "https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/integration-methods/plugin/magento2/" language: "it" --- # Magento 2 [Apple Pay](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/apple-pay/ "Apple Pay")[Fabrick Pay by Bank](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/pay-by-bank/ "Fabrick Pay by Bank")[Google Pay](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/google-pay/ "Google Pay")[PayPal](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/paypal/ "PayPal")[Satispay](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/satispay/ "Satispay") ## Funzionalità Il plug-In Ecommerce Sella per Magento 2 mette a disposizione le seguenti funzionalità che su necessità potranno essere personalizzate: ### ✓ — S2S REST ✓ — 3DS2 – Authentication ✓ — Tokenizzazione ✓ — PayPal Seller Protection ✓ — Pay By Link ✓ — Wallet\&Click2Pay con Fabrick Payment ✓ — Sella RBA (Risk Based Authentication) ✓ — Fabrick Guaranteed payments ## Descrizione dettagliata delle funzionalità: - Modalità di configurazione semplice e veloce - Grande disponibilità di pagamenti alternativi - Gestione degli ordini e delle fatture tramite le chiamate server-to-server (ordini, storni, pre-autorizzazioni) - Gestione di pagamenti veloci grazie alla tokenizzazione della carta (modalità one-click) - Gestione di pagamenti veloci tramite il form disegnato sulla pagina checkout di Magento ![Magento 2](https://docs.fabrick.com/assets/images/magento2-pagina-pagamento-cde5f5b4dd33deb6a99f8d030901aed7.png) - Pay By Link: possibilità di generare un ordine dal backend di Magento, inviando al cliente una mail con il link per poter completare il pagamento (non tutti i metodi alternativi sono supportati) Esempio di mail ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-2-6818ac82930d3b20cef5b51d5c3e155b.png) - Sella RBA (Risk Based Authentication): è una soluzione che analizza in tempo reale il rischio di frode sulle transazioni e, in caso di rischio basso, attiva l’esenzione per TRA (Transaction Risk Analysis). - Fabrick Guaranteed payments: è una soluzione end-to-end di prevenzione frodi per esercenti online che sfrutta un sistema di intelligenza artificiale per valutare i livelli di rischio delle transazioni (Powered by Riskified). - Il plugin è compatibile con: - Adobe Commerce (cloud): 2.4 - Adobe Commerce (on-prem): 2.4 - Magento Open Source: 2.4 Tutti i test di compatibilità sono stati condotti sulle versioni più recenti di Adobe Commerce esistenti per le linee di release compatibili al momento della presentazione dell'estensione. ## Configurazione back-office merchant Nel **back-office merchant** messo a disposizione, è possibile recuperare credenziali, SHOP Login e API Key, da riutilizzare poi per configurare il plugin nel **back-office di Magento**. All'interno di *Configurazione > Sicurezza > APIKEY* si può creare il valore richiesto ![Magento 2](https://docs.fabrick.com/assets/images/magento2-configurazione-1-a3be625d4d1ae26223fa9e203db21b46.png) Premendo sul bottone *Aggiungi Chiave*. ![Magento 2](https://docs.fabrick.com/assets/images/magento2-gestione-apikey-20ef62a05e85ff3891cbef0e50b2d924.png) Bisogna poi premere il tasto di copia, evidenziato in figura, per copiare la chiave negli appunti, per usarla poi sul backend Magento. All'interno di Pagina di *Pagamento > Campi & Parametri* occorre abilitare in risposta il parametro `PaymentMethod`, in entrambe le pagine Flaggando le due voci visibili nella schermata successiva. ![Magento 2](https://docs.fabrick.com/assets/images/magento2-2-flag-1-6a5e07058c0fbefe0140de2e863c3709.png) ## Informazioni sulla installazione del Plugin ### Installazione tramite file Composer (tutte le versioni) L'installazione tramite Composer, metodo ufficiale di Adobe per l'installazione dei moduli. - Dal sito Adobe Commerce, aggiungere al carrello ed acquistare (acquisto gratuito) il modulo "Ecommerce Sella" [https://commercemarketplace.adobe.com/easynolo-ecommercesella.html](https://commercemarketplace.adobe.com/easynolo-ecommercesella.html) - Eseguire il comando "`composer require easynolo/ecommercesella`" Ora dovrebbe essere tutto pronto per la configurazione tramite pannello di amministrazione. ## Configurazione plugin > **note** > > Per utilizzare le funzionalità del plugin, è necessario richiedere al supporto Sella di attivare le seguenti feature sul codice esercente: > > - iFrame > - S2S API (Autorizzazione, Movimentazione, Storno, Interrogazione) Dopo aver installato il plugin, è necessario configurare le opzioni che vengono messe a disposizione tramite il **back-office di Magento**. Nella sezione dedicata **negozi → configurazione → vendite → metodi di pagamento** è presente il blocco "Sella" per la configurazione del plugin. ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-8-1-ca9e05cdf7cdf6d1ae7bae63b7c4f039.png) Nella prima sezione è possibile configurare: - **abilitazione plugin**: permette la visualizzazione dei metodi messi a disposizione da Sella in fase di checkout; - **abilitazione modalità di test**: permette di utilizzare la sandbox del gateway di pagamento usando relative SHOP Login e API Key di test; - **abilitazione Wallet\&Click2Pay**: permette di accedere ai servizi Apple Pay, Google Pay e carte di pagamento sulla nuova pagina Fabrick Payment; - **abilitazione tokenizzazione carta**: permette il salvataggio della carta di pagamento del cliente in modo sicuro per poi proporla nei pagamenti successivi; - **scelta tipologia di operazione con carte di pagamento**: identifica il metodo di contabilizzazione: se valorizzato con **"Autorizzazione e contabilizzazione"** la transazione, se autorizzata, viene anche contabilizzata in autonomia; mentre se valorizzato con **"Autorizzazione"** la transazione, se autorizzata, necessita di una operazione manuale per essere contabilizzata Ecco un esempio della sezione configurazione: ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-9-8cf99b47e3623854649f1c0870fd3a21.png) > **informazioni** > > Nel caso in cui si voglia usare la funzionalità **Wallet & Click2Pay** con **Fabrick Payment**, è necessario configurare nel back office merchant le URL per le risposte positive, negative e Server to Server in questo modo: > > - risposta positiva: `{dominio}/sella/back/success/` > - risposta negativa: `{dominio}/sella/back/failed/` > - Server to Server: `{dominio}/sella/back/walletclick2paypost/` > > Abilitare la funzionalità Wallet & Click2Pay comporta di mantenere su **NO** la sezione relativa a GooglePay (vedi capitoletto sottostante). > > Inoltre, è possibile configurare la visibilità dei singoli metodi di pagamento. Se necessario, viene messa a disposizione la possibilità tramite un bottone apposito di nascondere il metodo. ## Configurazione dei metodi di pagamento Nella prima sezione, sono presenti tre sotto sezioni per gestire delle configurazioni extra su metodi di pagamento specifici: - **Consel**, in cui, abilitando il metodo, è necessario specificare il **Merchant Promotional Code**; - **Google Pay**, in cui, abilitando il metodo, è necessario specificare l’**ID commerciante**; - **PayPal**, per il quale è possibile scegliere la tipologia di operazione: **autorizzazione e contabilizzazione** oppure **autorizzazione**. Nella seconda sezione sono presenti due campi specifici per l'inserimento delle credenziali **SHOP Login** e **API Key**. Al salvataggio della configurazione vengono validate le credenziali inserite. Se valide, il plug-in sincronizzerà tutti i metodi di pagamento attivi sul terminale per proporli in fase di check-out al cliente finale. Se vengono aggiornati i metodi di pagamento sul back-office merchant, è presente una procedura Magento che periodicamente sincronizza la lista. Nel caso in cui il merchant volesse sincronizzare i metodi di pagamento con effetto immediato, sarà necessario salvare nuovamente la configurazione del plug-in su Magento. Se la modalità Wallet\&Click2Pay è abilitata, non sarà necessario specificare i parametri per Google Pay in quanto questo metodo sarà gestito tramite Fabrick Payment, ed i parametri saranno specificati all’interno del back-office. ## Configurazione Fabrick Guaranteed Payments (Powered by Riskified) Per abilitare l’utilizzo dell’antifrode, bisogna mettere porre a “Sì” la seguente opzione: ## Informazioni per la gestione delle carte salvate (frontend) Se sul backend è attiva la possibilità di far salvare il token per le carte di credito, a frontend il buyer, all’atto del pagamento vedrà l’opzione per il salvataggio al momento di inserire i dati di carta ![Magento 2](https://docs.fabrick.com/assets/images/magento-img1-38b3dbe9752e025281139be2493637d8.png) Una volta salvata, quando effettuerà un ordine, come prima opzione di pagamento troverà i token salvati (ma potrà sempre decidere di usare un altro metodo di pagamento o inserire una nuova carta di credito). ![Magento 2](https://docs.fabrick.com/assets/images/magento-img2-d047f0e60dab93e2afdb376b25497c4b.png) In seguito, dal suo profilo, alla voce “Stored Payment Methods”, potrà vedere tutte la carte che ha salvato sul sito ed eventualmente cancellare quelle che preferisce. ![Magento 2](https://docs.fabrick.com/assets/images/magento-img3-a1c9e1f229c09c8ddaf19fa6f45cb509.png) ## Informazioni per la gestione degli ordini e delle transazioni ### Richiesta autorizzativa Con la configurazione M.O.T.O., Fabrick permette di separare le fasi di autorizzazione e movimentazione. Se attivata, la prima transazione viene limitata alla richiesta di autorizzazione, altrimenti Fabrick movimenta l'importo subito dopo l'autorizzazione. Il plugin funziona secondo la configurazione scelta e descritta nel paragrafo *Configurazione plugin*. ### Movimentazione Con l’operazione di movimentazione il totale autorizzato viene trasferito permanentemente sul conto corrente del merchant. Per usarla, è necessario configurare la funzione M.O.T.O. in modo che sia separata dall’autorizzazione. Con questa configurazione Magento crea un ordine e in fase di pagamento viene vincolato l’importo grazie all’operazione di autorizzazione (il merchant riceve un’e-mail da Fabrick). Quando viene richiesta la fattura, Magento richiede di movimentare la somma autorizzata ad Fabrick che provvede ed invia un’e-mail al merchant. L’operazione può essere effettuata tramite backend di Magento (da *Sales > Orders*), selezionando l’ordine interessato, premendo **View** e poi **Invoice** dal pannello in alto a destra. Nella finestra che si aprirà, selezionare **Capture Online** e poi **Submit Invoice**. ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-12-2-708335b231f09fb9e664b09794dd581d.png) ### Cancellazione La cancellazione può essere richiesta per una transazione autorizzata ma non ancora catturata (movimentata) e la funzione M.O.T.O. deve essere impostata con la separazione di autorizzazione e movimentazione. L'operazione può essere effettuata tramite backend di Magento (da *Sales > Orders*), selezionando l'ordine interessato, premendo **View** e poi **Cancel** dal pannello in alto a destra. ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-13-19cea554c37e4a03a8d59d1818fb50e5.png) ### Rimborso Può essere richiesto solo su pagamenti già catturati (movimentati). Da un punto di vista fiscale, prevede un addebito del merchant e un accredito sulla carta del compratore. Una transazione può essere rimborsata totalmente o parzialmente più volte, fino al totale del pagamento. Su Magento, un rimborso viene effettuato tramite backend (da *Sales > Orders*), selezionando l'ordine e premendo **View**. Successivamente, è sufficiente entrare nel menù **invoices** e selezionare la fattura collegata all'ordine. Dalla fattura, selezionare **Credit Memo**. ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-14-87853ef6470ab2ba9691a6ab9ed1968f.png) Selezionare le quantità dei prodotti che si desiderano rimborsare. ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-15-1-78e05754d637fa040c04bb340f1716ae.png) Infine, dopo aver deciso se rimborsare le spese di spedizione o altri dettagli, premere su "Storno", come mostrato di seguito. ![Magento 2](https://docs.fabrick.com/assets/images/magento-2-16-3716d286a9b474109acc6b4178b96ea2.png) ## Gestione del MOTO In base alla configurazione sul plugin o sul merchant back office di Fabrick, si possono avere queste tre possibilità: - Se si desidera che sia Fabrick a catturare la transazione, è necessario impostare **MOTO: contestuale** sul merchant back office di Fabrick. Lato Magento, l'azione da impostare è **Autorizzazione** e la Capture tramite pagina di ordine Magento può essere solo **offline** (per la sola generazione della invoice). - Se si desidera che sia Magento a catturare la transazione, si deve impostare **MOTO: separato** su Fabrick. Dopo aver fatto ciò ci sono due opzioni: - Lato Magento, l'azione da impostare è **"Autorizzazione"** se si vuole effettuare una Capture manuale tramite pagina ordine di Magento. In questo caso, la Capture tramite pagina di ordine Magento può essere **offline** (per la generazione della sola invoice senza però catturare finanziariamente la transazione), oppure, può essere **online** (per la generazione della invoice e per catturare finanziariamente la transazione). Nel caso di capture offline, la movimentazione finanziaria andrà fatta da dashboard Fabrick. - Lato Magento, l'azione da impostare è **"Autorizzazione e contabilizzazione"** se si vuole che Magento catturi finanziariamente la transazione immediatamente, e generi immediatamente la invoice. In questo caso, la Capture tramite pagina di ordine Magento **non deve** essere gestita perché la transazione è già catturata e invoice generata. ## File LOG I log delle operazioni svolte sono disponibili nel file **`debug.log`**, nel path **`/var/log`**. ## CRON Job Sfruttando il CRON Job già presente su Magento, il plug-In Ecommerce Sella può: 1. Gestire lo stato **Waiting(XX)** ritornato da alcuni particolari metodi di pagamento, che non restituiscono immediatamente un OK o KO alla conferma d’ordine 2. Gestire lo stato di attesa di **Riskified**, che in talune circostanze non approva o rifiuta immediatamente la transazione, ma richiede più tempo per l’analisi antifrode ## Versioni compatibili Il plugin è compatibile con: - Adobe Commerce (cloud): 2.4 - Adobe Commerce (on-prem): 2.4 - Magento Open Source: 2.4 Tutti i test di compatibilità sono stati condotti sulle versioni più recenti di Adobe Commerce esistenti per le linee di release compatibili al momento della presentazione dell'estensione.