Passa al contenuto principale
Magento

Plugin eCommerce Numia - Piattaforma eCommerce per Magento 2.X

1. Introduzione​

Il plugin eCommerce IGFS per Magento 2.X è una soluzione di pagamento che permette agli esercenti di gestire i pagamenti elettronici con carte di credito in maniera semplice e sicura.

Il plugin ha un unico modulo di configurazione ed è completamente integrato nelle interfacce della piattaforma Magento 2.X. Le transazioni avvengono in modo sicuro attraverso la Piattaforma eCommerce IGFS.

Servizi offerti​

  • Pagamento con carta in modalità “Authorize”
  • Pagamento in modalità “Capture”
  • Annulli (cancellazioni) di ordini effettuati con modalità “Authorize” non contabilizzati
  • Rimborsi parziali e totali degli ordini

2. Compatibilità​

Il plugin è testato per le versioni:

SoftwareVersioni supportate
Magento2.4.5, 2.4.6, 2.4.7
PHPVersione consigliata per la versione di Magento

Non si esclude la compatibilità con versioni precedenti o successive, ma non è garantita.

3. Carte e metodi di pagamento alternativi supportati​

È possibile utilizzare, per i pagamenti, le carte di credito dei circuiti più diffusi a livello internazionale.

Sono utilizzabili, inoltre, i principali metodi di pagamento alternativi supportati dal Payment Gateway.

Nota: per approfondimenti su carte e metodi supportati, rivolgersi al supporto tecnico.

4. Prima installazione​

Per la prima installazione del plugin seguire i passi descritti di seguito.

4.1 Creazione folder Plugin​

Creare la cartella Netsgroup all’interno della directory di sistema:

[magento root folder]/app/code/

Su Linux, ad esempio:

mkdir ./Netsgroup

Esempio:

$ pwd
/opt/magento/public_html/app/code/Netsgroup

4.2 Decompressione Plugin​

Decomprimere il file .zip del plugin dentro la cartella:

[magento root folder]/app/code/Netsgroup

Su Linux:

unzip netsgroup-module-igfs-payment-gateway-2.0.2-202105171649.zip

Dopo il comando dovrebbe apparire la cartella IgfsPaymentGateway:

$ pwd
/opt/magento/public_html/app/code/Netsgroup
$ ls
IgfsPaymentGateway "zipDelPlugin".zip

4.3 Installazione e compilazione Plugin​

Posizionarsi nella cartella root di Magento:

cd /opt/magento/public_html

Eseguire i seguenti comandi:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Il plugin usa cron task per allineare gli ordini non notificati. Se il sistema Magento non ha ancora un cron abilitato:

bin/magento cron:install

5. Aggiornamento Plugin​

Per l’aggiornamento del plugin:

  1. Sostituire i file del modulo nella cartella IgfsPaymentGateway.
  2. Ritornare nella cartella root di Magento.
  3. Eseguire:
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

6. Configurazione​

La schermata di configurazione si trova in Magento in:

STORES → SALES → Payment Methods → IGFS

Impostazioni generali​

CampoDescrizione
ID Venditore (Merchant ID)Identificativo esercente. Fornito dal supporto tecnico.
FirmaChiave di sicurezza per la firma elettronica cifrata delle transazioni. Fornita dal supporto tecnico.
URL del server di pagamentoIndirizzo del Payment Gateway utilizzato per colloquiare con il PGW. Fornito dal supporto tecnico.
Azione di pagamento- Autorizza: il pagamento viene autorizzato e poi confermato dall’esercente.- Acquisisci: il pagamento è autorizzato e concluso in un solo passo.
Verifica connessioneVerifica la connettività verso l’URL del server di pagamento.

Metodi disponibili​

CampoDescrizione
AbilitatoAbilita il metodo per lo store.
Configurazione API TypeCodice API specifico fornito per il metodo; determina il comportamento di elaborazione.
TitoloTitolo del metodo di pagamento mostrato al checkout.
Opzione immagine- Non mostrare: nessuna immagine. - Immagine custom: inserire il URL dell’immagine custom.
OrdinamentoOrdina i metodi di pagamento nel checkout.

Impostazioni avanzate​

CampoDescrizione
DebugSe impostato a YES, abilita la scrittura verbosa sul file di log.
Order state change (CANCELED)Se YES, imposta l’ordine in stato CANCELED se il pagamento è annullato dal cliente.
Order state change (REJECTED)Se YES, imposta l’ordine in IGFS_REJECTED se il pagamento non è autorizzato.

Al termine delle impostazioni, premere “Save Config”.

7. Checkout ordine​

Una volta creato il carrello e pronto l’ordine:

  1. Procedere al checkout.
  2. Selezionare il metodo IGFS configurato.
  3. Alla conferma, l’utente viene reindirizzato all’IGFS Payment Gateway per completare il pagamento.

In caso di problemi (es. carta non valida), comparirà un avviso di errore e il pagamento verrà annullato.

8. Rimborso ordine​

Per effettuare un rimborso (Refund):

  1. Dal menu Sales → Orders selezionare l’ordine.
  2. Cliccare View per aprire il dettaglio.
  3. Effettuare la nota di credito (Credit Memo) per il rimborso.

I rimborsi sono possibili per ordini effettuati sia in modalità “Authorize” che “Capture”.

8.1 Rimborso in modalità Authorize​

  1. Dall’ordine in “Processing”, compilare la Invoice e premere “Submit Invoice”.
  2. Dopo il completamento, dal menu comparirà la voce “Credit Memo”; cliccarla per aprire il form.
  3. Nel form, è possibile aggiungere Adjustment Refund e Adjustment Fee.

Rimborso parziale​

  • Inserire la quantità di articoli da rimborsare.
  • Se richiesto, spuntare “Return to Stock” per reinserire la merce in magazzino.
  • Premere “Update Qty’s” per aggiornare l’importo.
  • Premere “Refund” per confermare.

Per ulteriori rimborsi parziali successivi, generare una nuova Credit Memo fino all’esaurimento dell’importo.

Rimborso totale​

  • Lasciare le quantità invariate (rimborso di tutti gli articoli).
  • Se richiesto, spuntare “Return to Stock” per reintegrare l’intero inventario.
  • Premere “Refund”.

Alla restituzione totale, lo stato dell’ordine passa automaticamente da “Processing” a “Closed”.

8.2 Rimborso in modalità Capture​

Nella modalità Capture, l’ordine è già conciliato; il sistema:

  • Imposta lo stato “Processing”.
  • Rende disponibile il tasto “Credit Memo” senza bisogno di creare prima l’Invoice.

Il flusso operativo è identico a quello descritto per la modalità Authorize:

  • Selezionare gli articoli da rimborsare e, se necessario, “Return to Stock”.
  • Premere “Update Qty’s”.
  • Aggiungere, se richiesto, Adjustment Refund e Adjustment Fee.
  • Confermare con “Refund Offline”.

Per ulteriori rimborsi parziali, generare ulteriori Credit Memo fino all’esaurimento dell’importo.

9. Annullo di ordini in modalità "Authorize"​

È possibile cancellare un ordine solamente se:

  • Configurato in modalità “Authorize”.
  • Non ancora confermato / contabilizzato.

Procedura​

  1. Cambiare lo stato dell’ordine da “Pagamento accettato” a “Annullato”.
  2. Il sistema mostra un banner di conferma dell’annullamento.

FAQ – Domande frequenti​

Installazione e configurazione​

  • D: È possibile installare il plugin su versioni precedenti alla 2.4.5 di Magento? R: Il plugin è stato testato su 2.4.5, 2.4.6, 2.4.7; può funzionare su versioni precedenti, ma non è garantita la compatibilità o il supporto ufficiale.

  • D: Quali informazioni devo richiedere al supporto tecnico per configurare il plugin? R: ID Venditore (Merchant ID), Firma (chiave di sicurezza) e URL del server di pagamento.

  • D: Il plugin supporta ambienti multi‑store? R: Sì. Può essere configurato separatamente per ciascuna store view.

Pagamenti e transazioni​

  • D: Qual è la differenza tra “Authorize” e “Capture”? R:

    • Authorize: solo autorizzazione; conferma manuale da parte dell’esercente in un secondo momento.
    • Capture: autorizzazione e conclusione in un unico step.

  • D: È possibile accettare pagamenti in valute diverse dall’Euro? R: Il plugin è configurato principalmente per Euro. Per altre valute, contattare il supporto tecnico.

  • D: Come verifico che una transazione è andata a buon fine? R: Le transazioni riuscite si vedono in Magento con stato “Processing” o “Complete”, a seconda della configurazione.

Rimborsi e annulli​

  • D: È possibile effettuare rimborsi parziali? R: Sì, tramite Credit Memo selezionando la quantità specifica di articoli da rimborsare.

  • D: Posso annullare un ordine dopo che è stato completato? R:

    • Autorize non confermato: può essere annullato.
    • Authorize confermato o Capture: può solo essere rimborsato, non annullato.

Troubleshooting​

Problemi comuni di installazione​

  • Errore durante l’installazione → Verificare permessi delle directory e versione PHP compatibile con la versione di Magento.
  • Plugin non visibile dopo l’installazione → Eseguire bin/magento cache:clean e verificare che setup:upgrade e setup:di:compile siano stati eseguiti.
  • Errori di compilazione → Controllare i log in var/log/.

Problemi di configurazione​

  • Impossibile salvare la configurazione → Verificare di avere i permessi necessari nell’area admin.
  • Metodi di pagamento non visibili nel checkout → Controllare che il metodo sia abilitato e configurato con i dati corretti (ID Merchant, firma, URL gateway).

Problemi di transazione​

  • Errore durante il pagamento → Verificare che l’URL del server di pagamento sia corretto e i parametri validi.
  • Notifiche di pagamento non ricevute → Verificare che il cron Magento sia configurato e in esecuzione.

Riferimenti e supporto​

Per ulteriori informazioni o assistenza, contattare il supporto tecnico Numia®.