Vai al contenuto principale

Magento 2

Come integrare Scalapay in Magento 2

Aggiornato questa settimana

Scalapay mette a disposizione un’estensione pronta all’uso per i siti Magento 2.

Puoi trovare tutte le istruzioni per scaricare e installare il nostro plugin al seguente link:

📘 COMPATIBILITÀ

Il plugin di Scalapay è compatibile a partire dalla versione 2.2.2 di Magento.

❤ Installazione del plugin

Segui le istruzioni riportate di seguito per installare il plugin:

  1. Accedi via SSH al tuo server

  2. Vai alla root del tuo progetto Magento

  3. Abilita la modalità maintenance eseguendo php bin/magento maintenance:enable

  4. Scarica il modulo eseguendo composer require scalapay/scalapay-magento-2

  5. Abilita il modulo eseguendo php bin/magento module:enable Scalapay_Scalapay

  6. Applica gli aggiornamenti al database eseguendo php bin/magento setup:upgrade

  7. Esegui il deploy dei contenuti statici con php bin/magento setup:static-content:deploy

  8. Compila il codice sorgente con php bin/magento setup:di:compile

  9. Pulisci la cache eseguendo php bin/magento cache:clean

  10. Disabilita la modalità maintenance con php bin/magento maintenance:disable

❤ Configurazione del plugin

Per configurare e abilitare il plugin di Scalapay, segui il percorso:

Stores (menu laterale) → ConfigurationSalesPayment Methods.

Troverai una sezione a discesa dedicata a Scalapay.

❤ General settings

In questa sezione potrai gestire le impostazioni generali del plugin e inserire la Live API Key una volta che il plugin sarà correttamente installato, configurato e testato.

  • Enable/disable Scalapay in Live mode
    La Test API Key è presente di default e consente di testare il corretto funzionamento del plugin.
    Una volta completata la fase di test, ti verranno fornite la Live API Key e il Live Merchant Token, che potrai inserire per attivare il plugin in modalità Live.

  • Test API key
    Quando installi il plugin, la test API key generica è impostata di default: qhtfs87hjnc12kkos.

  • Test merchant token
    Quando installi il plugin, il test merchant token generico è impostato di default: 8KDS3SPEL.

  • Test merchant token
    Una volta completata la fase di test, ti verrà fornito il Live merchant token e potrai attivare il plugin in modalità Live. Troverai il tuo merchant token nel tuo Scalapay Merchant Portal, nella sezione "Sviluppatore".

  • Live merchant token
    Una volta completata la fase di test, ti verrà fornita la Live API key e potrai attivare il plugin in modalità Live. Troverai la tua Live API key nel tuo Scalapay Merchant Portal, nella sezione "Sviluppatore".

  • Enable/disable Delayed capture
    Il plugin include l’opzione Delayed capture: questa funzionalità può essere attivata per ciascun singolo prodotto.

Pay in 3 settings

❤ Payment configurations

Ecco l'elenco di tutte le configurazioni che ti permettono di impostare, testare e poi attivare il plugin in modalità Live.

  • Scalapay Minimum amount e Scalapay Maximum amount
    Questi campi ti permettono di modificare l’importo minimo e massimo predefinito, secondo i termini contrattuali.
    L’importo minimo per mostrare il plugin Scalapay e accettare pagamenti è fissato a 5€.

  • Disable Scalapay for specific countries
    Seleziona i paesi nei quali non desideri che Scalapay venga visualizzato.
    I paesi autorizzati sono: Austria, Belgio, Finlandia, Francia, Guyana francese, Germania, Guadalupa, Italia, Martinica, Mayotte, Paesi Bassi, Portogallo, Réunion e Spagna.

  • Disable Scalapay for specific categories
    Questo campo ti permette di selezionare le categorie di prodotto in cui non desideri che Scalapay venga visualizzato.

Payment configurations

❤ Widget configurations

Questa sezione ti consente di configurare e personalizzare il widget di Scalapay nelle pagine prodotto, carrello e checkout.

1. Product page settings

Le impostazioni in questa sezione ti permettono di personalizzare il widget di Scalapay nella pagina Prodotto.

  • Widget amount selectors e Widget position
    Questi campi sono impostati di default. Se il tuo tema è personalizzato, ti consigliamo di verificare i selettori corretti.

  • Hide widget
    Questo campo è disponibile, ma ne sconsigliamo l’uso poiché il widget di Scalapay è un elemento fondamentale per aumentare la conversione e il valore medio degli ordini.

Product page settings

📘 Price selectors

Il campo Price selectors viene utilizzato per aggiungere una classe o una combinazione di classi per ottenere il prezzo finale del prodotto al quale applicare le rate Scalapay.

Per identificare e impostare i selettori corretti, ispeziona l’elemento del prezzo per recuperare il nome corretto della classe del prezzo. È possibile aggiungere più selettori di prezzo separandoli con una virgola.

Per aggiungere un nuovo selettore CSS del prezzo, inserisci i nuovi selettori in ordine di priorità. Trova tutti i selettori di prezzo (prezzo normale, prezzo speciale, ecc.) e incollali nel campo, separati da una virgola.

2. Cart page settings

Le impostazioni in questa sezione ti permettono di personalizzare il widget di Scalapay nella pagina del carrello.

  • Widget amount selectors e Widget position
    Questi campi sono impostati di default. Se il tuo tema è personalizzato, ti consigliamo di verificare i selettori corretti.

  • Hide widget
    Questo campo è disponibile, ma ne sconsigliamo l’uso poiché il widget di Scalapay è un elemento fondamentale per aumentare la conversione e il valore medio degli ordini.

Product page settings

3. Checkout page settings

Le impostazioni in questa sezione ti permettono di personalizzare il widget di Scalapay nella pagina di Checkout.

  • Widget amount selectors
    Questo campo è impostato di default. Se il tuo tema è personalizzato, ti consigliamo di verificare i selettori corretti.

Product page settings

Go Live!

📘 REMINDER

Prima di andare Live con Scalapay, ti consigliamo di testare la tua integrazione effettuando almeno un ordine di test.

  1. Accedi allo Scalapay Merchant Portal: nella sezione Sviluppatore troverai la tua Live API key (inizia con sp_) e il tuo Live merchant token. Riceverai le credenziali di accesso via email dal tuo Integration Manager di Scalapay.

  2. Nel backend di Magento 2, vai su Stores (nel menu laterale) → ConfigurationSalesPayment Methods: disattiva la modalità di Test e clicca su Save Config.

Flag the Live mode and enter the Live merchant token and the Live API key

3. Abilita la modalità Live, inserisci il Production (Live) merchant token e la Production (Live) API key nei campi dedicati. Troverai entrambi nello Scalapay Merchant Portal, nella sezione "Sviluppatore".

Flag the Live mode and enter the Live merchant token and the Live API key

4. Clicca su Save Config e cotrolla il tuo sito!

Hai ricevuto la risposta alla tua domanda?