Nuova versione del plugin GestPay per nopCommerce 4.90.x
Il team LandLogic è lieto di annunciare la disponibilità della versione del nostro plugin GestPay Banca Sella compatibile con nopCommerce 4.90.x. Questo componente permette di integrare in modo semplice e sicuro i pagamenti con la piattaforma GestPay di Banca Sella all’interno del vostro negozio nopCommerce.
Panoramica del plugin
GestPay è uno dei gateway di pagamento più utilizzati in Italia. Il nostro plugin gratuito consente ai merchant di accettare pagamenti tramite GestPay direttamente dall’e‑commerce nopCommerce utilizzando il WebService WSCryptDecrypt nopcommerce.com. La release presente sul marketplace nopCommerce è stata creata da LandLogic nel 2016 e mantiene la compatibilità con numerose versioni della piattaforma (3.90, 4.20, 4.30, 4.40, 4.50, 4.60, 4.70, 4.80 e 4.90) nopcommerce.com.
Con l’aggiornamento di nopCommerce alla versione 4.90 abbiamo adattato il plugin e rilasciato la versione 1.61. Nel file plugin.json del progetto è indicato che il plugin appartiene al gruppo Payment methods, presenta il nome amichevole GestPay BancaSella e supporta le versioni 4.90 raw.githubusercontent.com.
Novità della versione 4.90.x
L’aggiornamento introduce tre operazioni fondamentali per la gestione dei pagamenti: Refund, Capture e Void. Queste funzioni permettono di rimborsare, acquisire definitivamente o annullare una transazione direttamente dall’area amministrativa di nopCommerce. L’implementazione si basa sull’API SOAP S2S (Server‑to‑Server) e garantisce piena compatibilità con l’infrastruttura esistente raw.githubusercontent.com.
-
Refund – restituisce l’importo al cliente in caso di reso o cancellazione dell’ordine.
-
Capture – consente di confermare un’autorizzazione di pagamento e di incassare l’importo solo in un secondo momento.
-
Void – annulla un’autorizzazione prima che venga acquisita la transazione.
Oltre a queste novità, il plugin continua a utilizzare la crittografia WSCryptDecrypt e a fornire i template di pagina di pagamento personalizzati, come nelle versioni precedenti.
Come installare il plugin
L’installazione del plugin GestPay per nopCommerce 4.90.x è molto semplice:
-
Scarica il pacchetto – potete ottenere il plugin dalla nostra repository GitHub o dalla pagina del marketplace nopCommerce nopcommerce.com.
-
Carica il pacchetto – accedete al pannello amministrativo di nopCommerce e navigate su Dashboard » Configuration » Local plugins, quindi caricate l’archivio ZIP del plugin.
-
Installa il plugin – una volta caricato il file, installate il plugin seguendo la procedura guidata.
Configurazione del plugin
Per utilizzare il gateway è necessario configurare le credenziali rilasciate da GestPay. Dopo l’installazione:
-
Aprite la pagina di configurazione del plugin GestPay.
-
Inserite le credenziali fornite da Banca Sella (shopLogin/Codice esercente).
-
Salvate la configurazione.
Setup della pagina di pagamento
GestPay utilizza parametri aggiuntivi (indirizzo email dell’acquirente, nome dell’acquirente e lingua) nella richiesta di crittografia. È fondamentale abilitare questi campi nel back‑office GestPay altrimenti la richiesta di Encrypt fallirà.
Per impostarli correttamente:
-
Accedete al back‑office GestPay e andate nella sezione Configurazione clienti » Campi & Parametri
-
Selezionate la pagina di pagamento pubblicata e verificate che i parametri Buyer E‑Mail, Buyer Name e Language siano attivi
Notifiche e URL di ritorno
Per far sì che GestPay notifichi correttamente l’esito del pagamento bisogna configurare gli URL di risposta. La notifica viene inviata tramite chiamata server‑to‑server alla pagina Plugins/PaymentGestPay/s2sHandler Il risultato dell’operazione viene mostrato all’acquirente come scontrino virtuale e, in seguito, il cliente viene reindirizzato alla pagina di successo o di errore configurata nel profilo esercente:
-
URL di successo:
…/Plugins/PaymentGestPay/EsitoGestPay/OK -
URL di errore:
…/Plugins/PaymentGestPay/EsitoGestPay/KO
Ambiente di test e produzione
Ogni esercente può gestire i profili GestPay da un pannello dedicato. L’ambiente di produzione è raggiungibile all’indirizzo https://dashboard.gestpay.net/BackOffice mentre l’ambiente di test è disponibile su https://sandbox.gestpay.net/BackOffice.
È consigliabile utilizzare l’ambiente di sandbox per tutte le verifiche prima di mettere online il gateway di pagamento.
Contributo aperto e supporto
LandLogic sviluppa e mantiene questo plugin come parte del suo impegno verso l’ecosistema open‑source nopCommerce. Il codice sorgente è disponibile su GitHub e può essere liberamente studiato o modificato. Se state usando una versione precedente di nopCommerce, trovate le release compatibili nella stessa repository (ramo master per 3.90/4.10/4.20, ramo nop4x per 4.90)raw.githubusercontent.com.
Per qualsiasi richiesta di supporto o integrazione personalizzata potete contattarci tramite l’apposito help desk sul sito LandLogic oppure scrivere a info@landlogic.it. Il nostro team vi assisterà nell’installazione, configurazione e personalizzazione della piattaforma nopCommerce per soddisfare le esigenze del vostro progetto e‑commerce.
