Magento 2
Funzionalità
Il plug-In Ecommerce Sella per Magento 2 mette a disposizione le seguenti funzionalità che su necessità potranno essere personalizzate:
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
- 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
-
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
Premendo sul bottone Aggiungi Chiave.
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.
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
- Eseguire il comando "
composer require easynolo/ecommercesella"
Ora dovrebbe essere tutto pronto per la configurazione tramite pannello di amministrazione.
Configurazione plugin
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.
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:
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
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).
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.
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.
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.
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.
Selezionare le quantità dei prodotti che si desiderano rimborsare.
Infine, dopo aver deciso se rimborsare le spese di spedizione o altri dettagli, premere su "Storno", come mostrato di seguito.
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ò:
- Gestire lo stato Waiting(XX) ritornato da alcuni particolari metodi di pagamento, che non restituiscono immediatamente un OK o KO alla conferma d’ordine
- 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.