PLUGIN GESTPAY PRO V.1.4.0.0

Eeasy Nolo S.p.A.
Gruppo Banca Sella
p iva
02027040027
sede legale
Piazza Gaudenzio Sella,
1
13900 Biella
sede operativa
Piazza Adua, 12
13900 Biella
tel 015.2434640
+39.015.24.34.640 (dall'estero)
[email protected]
www.easynolo.it
PLUGIN GESTPAY PRO V.1.4.0.0
MANUALE DI INSTALLAZIONE E UTILIZZO DEL MODULO
Il modulo Plugin GestPay PRO consente di collegare la propria pagina di checkout di Magento con il
payment gateway GestPay di Banca Sella (www.sella.it). Il modulo implementato prevede 3 modalità di
integrazione:

Standard, l'utente dal Checkout dello store online viene redirezionato alla pagina di pagamento di
Banca Sella, con successivo ritorno al negozio online al termine della transazione;

IFrame, permette di integrare totalmente la pagina di pagamento al proprio sito web
personalizzando tutti gli aspetti di layout e lingua, con il vantaggio di lasciare la gestione dei dati
sensibili delle carte di credito direttamente a Banca Sella;

Token, è il servizio che permette di archiviare, sui server sicuri di Banca Sella, i dati della carte dei
propri clienti, permettendo di chiudere le operazioni di acquisto in un solo click (come operano ad
esempio i grandi store online). Al momento la funzionalità è integrata per la gestione dei Recurring
Profile Payment di Magento.
2
SOMMARIO
1. COMPATIBILITÀ .............................................................................................................................................. 4
2. INSTALLAZIONE .............................................................................................................................................. 4
3. CONFIGURAZIONE .......................................................................................................................................... 5
4. CONFIGURAZIONE GESTPAY .......................................................................................................................... 9
4.1 INDIRIZZI PER RISPOSTE ............................................................................................................................... 9
4.2 LINGUA ....................................................................................................................................................... 10
4.3 IFRAME ....................................................................................................................................................... 10
4.4 TOKEN ........................................................................................................................................................ 10
4.5 AUTORIZZAZIONE E MOVIMENTAZIONE DELLA TRANSAZIONE................................................................. 11
5. INTERNAZIONALIZZAZIONE .......................................................................................................................... 13
6. TERMINI E CONDIZIONI ................................................................................................................................ 13
6.1 RESPONSABILITÀ DI UTILIZZO .................................................................................................................... 13
7 CONTATTI ...................................................................................................................................................... 14
7.1 CREDITI ....................................................................................................................................................... 14
1. COMPATIBILITÀ
Il modulo nella versione 1.4.0.0 è compatibile e testato per le seguenti distribuzioni di Magento:

Community Edition 1.7.0.2

Community Edition 1.8.1.0

Community Edition 1.9.2.4

Magento Enterprise Edition 1.12

Magento Enterprise Edition 1.13

Magento Enterprise Edition 1.14
Il modulo è anche compatibile con le seguenti estensioni:

IWD One Step / Page Checkout
2. INSTALLAZIONE
Per installare il Plugin GestPay PRO è sufficiente copiare la cartella app del pacchetto del modulo nella
cartella principale dell'installazione di Magento. Nei sistemi Windows questo comporterà una richiesta di
sovrascrittura a cui occorre rispondere Sì. In altri sistemi accertarsi che la copia non cancelli i file le e le
cartelle originali ma si limiti ad aggiungere i contenuti del pacchetto del modulo. Se nello store è attiva
l’estensione IWD One Step / Page Checkout (IWD_Opc), sostituire il contenuto del file
EasyNolo_BancaSellaPro.xml all'interno di app/etc/modules con EasyNolo_BancaSellaPro.xml.Onepage.bak.
Questa operazione è necessaria per introdurre al modulo EasyNolo_BancaSellaPro.xml la dipendenza dal
modulo IWD_Opc, in maniera che funzioni correttamente l'integrazione fatta nel modulo EasyNolo Banca
Sella Pro.
Successivamente autenticarsi sul pannello di amministrazione di Magento e selezionare Sistema > Gestione
Cache ed aggiornare la cache. Per verificare che il modulo sia installato correttamente selezionare Sistema >
Configurazione > Avanzato > Avanzato e controllare che esista l'opzione EasyNolo_BancaSellaPro e che sia
impostata su Abilita.
4
3. CONFIGURAZIONE
Per utilizzare il modulo Banca Sella, autenticarsi sul pannello di amministrazione di Magento, selezionare
Sistema > Configurazione > Metodi di Pagamento ed espandere la voce Banca Sella Gestpay Pro attivando in
tal modo la scheda di configurazione mostrata di seguito:
Il significato delle diverse opzioni è illustrato di seguito:
Enabled
Se impostato su Sì rende il metodo di pagamento selezionabile dall'utente del negozio nella pagina di
finalizzazione dell'acquisto.
Title
È il titolo del metodo di pagamento che sarà presentato all'utente al checkout.
Description
Messaggio che viene mostrato nel Checkout prima che l’utente venga redirezionato alla pagina di
pagamento di Banca Sella.
Shop Login
Codice Esercente fornito da Banca Sella ed identifica il merchant che richiede il pagamento.
Test Environment
Se abilitato, le transazioni verranno inviate al gateway di test di Banca Sella (https://testecomm.sella.it). In
accordo a questa configurazione, va fornito un Codice Esercente di test, opportunamente creato sul portale
Banca Sella.
Payment Action
Permette di definire il tipo di pagamento che verrà effettuato col gateway di Banca Sella. Le scelte
disponibili sono:

Authorize only: viene effettuata solo la richiesta di autorizzazione della transazione a Banca Sella
(AUT);

Authorize and Capture: viene effettuata la richiesta di autorizzazione della transazione a Banca
Sella (AUT) e contestualmente la movimentazione della transazione (MOV), utilizzando le API S2S di
GestPay se l’impostazione “Use S2S Sales API for Capture, Void, Refund actions” è abilitata. Se la
movimentazione è impostata affinchè venga effettuata contestualmente all’autorizzazione della
transazione sul backend di GestPay, verrà effettuato il Capture Offline della transazione in
Magento, affinchè venga considerata chiusa la transazione anche sullo store online.
6
Use S2S Sales API for Capture, Void, Refund actions
Se abilitato, le funzionalità di Capture, Refund, Void di Magento per quanto riguarda la Fattura e la Nota
Credito di Magento sono direttamente integrate col gateway di GestPay, senza dover accedere al backend
di GestPay.
Enable iFrame Payment Page
Permette all'utente di effettuare il pagamento direttamente dal Checkout dello store, senza essere
reindirizzato sul sito di Banca Sella. L’impostazione
Enable Tokenization
Abilita la gestione del Token di Banca Sella per i pagamenti ricorrenti.
Gateway Language
La lingua che verrà utilizzata nella pagina di pagamento di Banca Sella.
Gateway Currency
La valuta da utilizzare nelle transazioni. Se la valuta dello store è diversa da quella impostata in questa
configurazione, l’importo della transazione verrà convertito nella valuta impostata, applicando il tasso di
cambio disponibile in Magento nella configurazione System -> Manage Currency -> Rates.
Status of order canceled by customer
Tramite questa opzione è possibile impostare quale debba essere lo stato di un ordine al termine della
procedura di pagamento annullata dall'utente che acquista.
Status of order canceled by Banca Sella
Tramite questa opzione è possibile impostare quale debba essere lo stato di un ordine al termine della
procedura di pagamento annullata da Banca Sella.
Status of order confirmed by Banca Sella
Tramite questa opzione è possibile impostare quale debba essere lo stato di un ordine al termine della
procedura di pagamento nel caso in cui tutto vada a buon fine.
Enable Anti-Fraud Check
Per il pagamento confermato da Banca Sella, viene verificato se l’importo della transazione coincide con il
totale dell’ordine di vendita. Se il pagamento non supera il controllo viene assegnato all’ordine di vendita lo
stato "Review Payment" e status "Fraud".
Payment from Applicable Countries
Filtro per nazioni. Se impostato a “Specific Countries” solamente le nazioni selezionate nella configurazione
“Paesi Autorizzati” potranno usare il metodo di pagamento.
Sort Order
Ordinamento del metodo di pagamento rispetto gli altri metodi attivi nel negozio.
Enable log
Se impostato su Sì abilita la registrazione di messaggi di log nel file EasyNolo_BancaSellaPro nella cartella
var/log dell'installazione Magento.
8
4. CONFIGURAZIONE GESTPAY
4.1 INDIRIZZI PER RISPOSTE
Affinché il dialogo tra Magento e GestPay di Banca Sella funzioni correttamente per tutte le integrazioni
gestite dal modulo, è necessario configurare i parametri relativi alle Risposte sul portale Banca Sella, come
mostrato di seguito:
In particolare, vanno impostati obbligatoriamente i seguenti parametri:
URL per risposta positiva
è l'URL a cui Banca Sella indirizza l'utente dopo il processo di
pagamento. Tramite questa URL viene notificato l'esito di
pagamento in caso di transazione andata a buon fine.
Deve essere nella forma seguente:
http://<your_domain>/bancasellapro/gestpay/result
URL per risposta negativa
è l'URL a cui Banca Sella indirizza l'utente dopo il processo di
pagamento. Tramite questa URL viene notificato l'esito di
pagamento in caso di transazione NON andata a buon fine. Deve
essere nella forma seguente:
http://<your_domain>/bancasellapro/gestpay/result
NB: se l'installazione Magento ha lo store code nell'url, riportare uno degli store code.
http://<your_domain>/it_it/bancasellapro/gestpay/result (lo store code è it_it)
Il modulo identificherà lo store su cui è stato effettuato l'acquisto automaticamente.
4.2 LINGUA
Affinché venga gestita correttamente l’impostazione “Seleziona la lingua” da GestPay, è necessario
aggiungere il campo "Language ID" come parametro per poter reindirizzare l'utente alla pagina di
pagamento di Banca Sella nella stessa lingua del negozio. Dal pannello di Banca Sella portarsi in Pagina
Pagamento > Campi & Parametri, selezionare la pagina di pagamento in uso, impostare il campo come
nell’immagine seguente e infine cliccare su Pubblica:
4.3 IFRAME
Dal backoffice di GestPay portarsi in Pagina Pagamento, selezionare la pagina di DEFAULT e pubblicarla. Se
la pagina non è presente, deve essere richiesta al call center di Banca Sella indicando il codice esercente in
uso.
4.4 TOKEN
Per gestire i pagamenti dei Recurring Payment Profile di Magento è necessario attivare i parametri della
Tokenization, in maniera che alla prima autorizzazione della carta di credito fornita Banca Sella associ un
codice univoco identificativo della carta. Tale codice verrà poi usato nelle iterazioni successive di rinnovo
fino alla scadenza della sottoscrizione.
10
Dal backoffice di GestPay portarsi in Pagina Pagamento > Campi & Parametri, selezionare la pagina di
pagamento in uso, impostare i campi come nell’immagine seguente e infine cliccare su Pubblica:
Attivare la gestione del Token è richiede la disattivazione dei protocolli di sicurezza 3D Secure (“Verified by
VISA”, “MasterCard Secure Code”). Tale disabilitazione permetterà al modulo di richiedere l'autorizzazione
sulla carta di credito del cliente per i pagamenti ricorrenti. Non è possibile utilizzare contemporaneamente
i protocolli di sicurezza e il servizio di pagamento ricorrente poi la transazione ricorrente avviene senza la
presenza online del cliente, necessaria per inserire i protocolli. La disattivazione del sistema 3D Secure deve
essere richiesta al call center di Banca Sella indicando il codice esercente in uso.
4.5 AUTORIZZAZIONE E MOVIMENTAZIONE DELLA
TRANSAZIONE
4.5.1 RICHIESTA DI AUTORIZZAZIONE
GestPay con la configurazione M.O.T.O. prevede la separazione tra la fase di autorizzazione e quella di
movimentazione della transazione di pagamento. Se attivata, la prima transazione sarà limitata alla
richiesta di autorizzazione altrimenti GestPay effettuerà la richiesta di autorizzazione e, in caso di risposta
positiva, provvederà ad effettuarne la movimentazione. Il plugin permette di lavorare in accordo a questa
configurazione, implementando le S2S API di GestPay per le operazioni di Movimentazione, Cancellazione e
Storno. Nel caso in cui non si utilizzino i servizi S2S è necessario procedere alla movimentazione,
manualmente, tramite Back Office.
4.5.2 MOVIMENTAZIONE
È l'operazione di conferma finanziaria della transazione di pagamento che può avvenire ad una precedente
trasazione di autorizzazione positiva. Può esistere solo per esercenti con una configurazione M.O.T.O. che
prevede la separazione tra la fase di autorizzazione e la fase di movimentazione. Se vi è una separazione
delle operazioni di Autorizzazione e di Movimentazione, Magento effettuerà alla creazione dell'ordine,
tramite la pagina di checkout una richiesta di blocco del denaro necessario per l'acquisto della merce
(l'esercente riceverà una email di conferma da Banca Sella). L'amministratore del negozio Magento
emetterà la Fattura. Poco prima di emettere la fattura il sistema richiederà la movimentazione del denaro a
Banca Sella (l'esercente riceverà una email di conferma da Banca Sella).
4.5.3 CANCELLAZIONE
È l'operazione di abbandono di una transazione autorizzata. Può essere effettuata solo in caso di
impostazione M.O.T.O. con fasi separate. Ovviamente, può essere effettuata solo su transazioni che non
state movimentate . Tale operazione viene effettuata dal backend di Magento attraverso il pannello di
controllo Vendite > Ordine e Vendite > Ordini, e all’interno della scheda di dettaglio dell’ ordine premendo il
bottone “Void”.
4.5.4 STORNO
E' l'operazione di annullo (totale o parziale) di una movimentazione. Contabilmente consiste nell'addebito
dell'esercente e conseguente riaccredito della somma sulla carta del compratore. Ovviamente, può essere
effettuata solo su transazioni già movimentate. Una transazione movimentata può essere stornata anche
più di una volta, per importi parziali, fino ad un totale pari alla somma per cui è stata movimentata. Tali
operazioni vengono effettuate da Magento attraverso il pannello di controllo Vendite > Ordini e Vendite >
Fatture > Nota di Credito.
12
5. INTERNAZIONALIZZAZIONE
Le etichette di questo modulo possono essere tradotte in qualsiasi lingua utilizzando il sistema di
traduzione di Magento basato su file CSV (Comma Separated Values).
Nel pacchetto sono già incluse le lingue elencate di seguito:

Inglese (Stati Uniti): en_US

Italiano (Italia): it_IT
6. TERMINI E CONDIZIONI
Di seguito sono riportati i termini e le condizioni di utilizzo applicabili ad ogni persona fisica o entità giurifica
che esegua il download di questo Plugin Gest- Pay Pro. Il download e l’utilizzo del Plugin implicano,
pertanto, l’accettazione espressa ed incondizionata degli stessi termini. Easy Nolo S.p.A. si riserva il diritto
di rivedere ed aggiornare i termini e le condizioni qui riportate. Poiché i termini, le condizioni e le loro
revisioni sono vincolanti per l’utilizzatore del Plugin, quest'ultimo tenuto a consultarli periodicamente per
prendere conoscenza degli aggiornamenti.
6.1 RESPONSABILITÀ DI UTILIZZO
Ai sensi della normativa in materia di diritto d'autore, non può essere fatto alcun uso del Plugin e dei suoi
contenuti da parte di terzi senza il preventivo consenso scritto di Easy Nolo S.p.A. È espressamente vietata
la riproduzione, con qualsiasi mezzo, anche elettronico, dei contenuti, nonché eventuali operazioni di
modifica, pubblicazione, traduzione, trasmissione, distribuzione o caricamento, in modo totale o parziale. I
soli download e utilizzi autorizzati sono quelli destinati esclusivamente per la propria attività, con espressa
esclusione dell’uso con qualsiasi finalità commerciale. L'accesso all’area download non implica pertanto
alcun diritto a copiare o a utilizzare copyright o proprietà intellettuali contenute nel Plugin stesso. Easy Nolo
S.p.A. non responsabile per qualsiasi malfunzionamento del Plugin dovuti ad errata configurazione,
incompatibilità con altri software installati o altre situazioni non verificabili direttamente da Easy Nolo
S.p.A..
7 CONTATTI
Per qualsiasi problema possibile rivolgersi all’assistenza diretta al numero 015-2434640 o all’indirizzo email
[email protected] per segnalare eventuali malfunzionamenti. Easy Nolo S.p.A. provvederà a verificare la
causa del problema. Per tutto ciò non espressamente dichiarato in Termini e Condizioni, ogni persona fisica
o entità giuridica che scarica ed utilizza il PLUGIN GESTPAY PRO V.1.4.0.0 deve attenersi a quanto definito
nel contratto di Licenza d’Uso GestPay sottoscritto con Easy Nolo S.p.A.
7.1 CREDITI
Il Plugin GestPay Pro appartiene e viene distribuito da Easy Nolo S.p.A. (https://www.easynolo.it) ed è stato
realizzato da Triboo Digitale (http://www.triboo.it).
14