# Introduzione
Il modulo permette di **connettere un negozio Magento a Banca Sella** in diverse modalità. Il modulo presenta nella sezione pubblica del carrello un modulo di **inserimento dei dati della carte di credito oppure un opzione per il redirect sul sito della banca sella**. Nel primo caso la transazione viene eseguita **senza essere reindirizzati** nel sito della Banca Sella nel secondo caso vi è un reindirizzamento ad una pagina sicura di pagamento.
# Cosa è un POS?
Un POS virtuale è un’applicazione informatica che permette ai merchant di accettare pagamenti online tramite carta di credito. Quando entri in un negozio fisico spesso hai la possibilità di pagare con carta di credito o di debito usando un’apposita macchinetta, detta Point Of Sale (punto di vendita) o POS. Il POS virtuale funziona in modo simile, ma per i negozi online.
## POS virtuale: processo di pagamento
Quando un cliente effettua un ordine nel tuo negozio online, compila i campi richiesti e alla fine sceglie il metodo di pagamento. A questo punte viene reindirizzato alla pagina di un POS virtuale, dove inserisce i dati di pagamento.
Grazie al POS virtuale, tu merchant non hai accesso ai dati di pagamento dei tuoi clienti, perciò non devi preoccuparti di gestirli e di conformarti alle regole PCI DSS (Payment Card Industry Data Security Standard). Inoltre, i clienti potranno pagare con il loro metodo preferito nel tuo negozio online e tu potrai guadagnare la loro fiducia.
## Come fa il POS Virtuale ad inviare il denaro nel mio conto corrente?
Come precedentemente descritto, il POS virtuale non è altro che un software che ha dei parametri di configurazione da impostare nel suo pannello di controllo. Ogni POS Virtuale ha delle credenziali di accesso ai servizi POS rilasciati dalla propria banca. Tali credenziali sono registrate negli archivi della banca e vengono controllate ad ogni transazione eseguita con il POS virtuale.
Tali credenziali sono collegate ad un profilo POS il quale è connesso al vostro conto corrente bancario. Quindi al click sulla conferma d'ordine, il POS virtuale domanderà l'accesso al sistema sicuro della banca, inviando le credenziali precedentemente inserite e permetterà al cliente di visualizzare la pagina di pagamento sicura.
Il cliente inserirà i dati della propria carta di credito e l'istituto di credito (VISA, Mastercard, ecc...) invierà alla banca collegata al profilo POS virutale l'ammontare accreditato dal cliente.
## Perché usare un POS virtuale?
* I tuoi clienti possono pagare nel tuo negozio online con carta di credito
* Non devi essere PCI compliant
* Non devi gestire, salvare e conservare i dati di pagamento dei tuoi clienti
## POS virtuale: quali metodi di pagamento sono disponibili?
Un POS virtuale offre solo pagamenti online con le carte di credito e di debito, ma non con altri metodi. Normalmente sono accettati tutti i principali circuiti internazionali, come Visa, Mastercard, American Express e Maestro.
# Gestione degli Ordini
La gestione degli ordini in Magento è molto sofisticata e vi sono moltissime soluzioni che potrebbero essere adottate ma la domanda che ci si pone sempre è: **Generare l'ordine prima del pagamento ?** oppure **attendere il pagamento prima di creare un ordine?** Prima di tutto bisogna considerare cosa è un ordine dal punto di vista commerciale.
## Gli Ordini
La definizione della parola **Ordine in ambito commerciale è la richiesta di una merce o di un servizio**. Quindi un ordine commerciale è la richiesta di determinato prodotto nel negozio magento da parte di un "potenziale cliente". Consideriamo il richiedente un "**potenziale**" cliente **poichè non lo è ancora, visto il mancato pagamento della merce o del servizio**. Quindi un ordine potrebbe esistere ma non aver alcun valore finchè il "potenziale cliente" o il "richiedente" non effettua il pagamento.
Al momento della conferma dell'ordine in Magento, il richiedente esprime la sua volontà nell'interesse di un determinato servizio o merce e Magento può "riservare o mantenere la disponibilità" di tale prodotto per un determinato periodo e/o dopo un'azione personalizzata da parte del gateway di pagamento.
Magento ha diverse funzionalità legate alla gestione degli ordini e noi **ci focalizzeremo sulla gestione dello status prima e dopo il pagamento dell'ordine**.
Abbiamo detto che il richiedente ha espresso il proprio interesse nell'acquisto di un determinato prodotto o servizio al click di conferma d'ordine che può reindirizzare il richiedente al gateway sicuro della banca.
Vi sono moltissimi modi di effettuare un pagamento, ma noi ci soffermeremo sui **pagamenti con redirect** chiamati **Hosted** (pagamenti ospitati nel server della banca).
Durante il redirect verso il server sicuro della banca, **Magento DEVE creare un ordine per mantenere "la richiesta" che il cliente ha generato durante l'uso del carrello in archivio**, poichè il reindirizzamento verso un sito differente **cancella i dati temporanei del carrello** perdendo definitivamente le informazioni. In questo determinato istante l'ordine viene creato e registrato in archivio con un codice ordine univoco e con uno status della transazione in "Pending Review" o "Pagamento in revisione" **inviando una notifica al cliente relativa all'ordine generato**. **La notifica non alcun valore fino al ricevimento del documento commerciale più importante: la Fattura.**
Ecco i casi più frequenti riscontrati:
1. il cliente effettua il pagamento e ritorna sul sito internet dell'esercente
* un messaggio lo avviserà dell'avvenuto pagamento. Magento imposterà un nuovo status "In Elaborazione" (Processing)
2. il cliente non effettua il pagamento e ritorna sul sito internet dell'esercente
* un messaggio lo avviserà sull'errore generato. Magento creerà un nuovo carrello con i vecchi prodotti scelti dal cliente e cancellerà il vecchio ordine mantenendo traccia della transazione annullata da parte del cliente.
3. il cliente effettua il pagamento e chiude il browser
* il server della banca contatterà il negozio Magento inviando una notifica sull'esito del pagamento (solo in live mode). Magento imposterà un nuovo status "In Elaborazione" (Processing)
4. il cliente non effettua il pagamento e chiude il browser
* il server della banca contatterà il negozio Magento inviando una notifica sull'esito del pagamento (solo in live mode). Magento imposterà un nuovo status "Cancellato" (Canceled)
Seguendo quanto detto in precedenza, in tutti i casi su riportati Magento mantiene traccia di ciò che il cliente ha ordinato e sarà possibile conoscere ciò che è successo durante la fase di acquisto attraverso i log del modulo di pagamento (vedi[ Logging, Debug](https://github.com/shinesoftware/banca-sella-advanced-2-0-magento/tree/79bf80d26395c42f01e17fcfe331d083254767c5/logging-debug-ed-errori-comuni.md)).
L'invio dell'email di notifica d'ordine al cliente disposto da Magento, è necessario a seguito della conferma dell'ordine da parte del cliente. Qualora non venisse corrisposto un pagamento per tale ordine il cliente e l'esercente potrebbero risalire alla richiesta. Ad ogni modo il cliente può controllare lo status dell'ordine direttamente dal suo pannello di controllo Magento in cui sarà ben evidente il mancato pagamento dell'ordine sottoscritto.
# Transazioni con carta di credito
## Come funzionano le transazioni con carta di credito?
Conoscere il funzionamento del flusso del processo della transazione di pagamento della carta di credito aiuta a comprendere anche l'iter utilizzato da Magento e dai moduli di pagamento. Le azioni di base del ciclo di vita delle transazioni sono:
* Autorizzazione (Authorization)
* Addebito (Capture)
* Storno (Refund)
* Annullamento (Void)
Queste azioni di flusso sono suddivise in operazioni più specifiche che possono essere chiamate in modo differente in base al gateway di pagamento. Di seguito sono riportati alcuni elementi di base rilevanti:
### **Autorizzazione**
E’ un blocco temporaneo di un importo specifico su una carta di credito. Questa operazione non genera nessun tipo di movimento bancario sul conto corrente del cliente perchè non viene contabilizzato, quindi, **non è un addebbito**. L’autorizzazione viene rilasciata dalla banca di riferimento, oppure dal gestore del circuito di carte di credito. L'autorizzazione permette quindi di “prenotare” un importo prima che l’operazione venga effettivamente effettuata. In questo modo è garantita in ogni caso la disponibilità dell’importo al momento della prenotazione definitiva. L'operazione di autorizzazione ha una validità di 30gg.
### Addebito
La cattura di un importo può avvenire direttamente oppure dopo l'autorizzazione. In questo caso la banca o l'istituto di credito sbloccherà la "prenotazione" qualora vi fosse stata una precedente autorizzazione e addebiterà al cliente l'importo richiesto. Tale operazione genera un vero e proprio movimento del denaro dall'istituto di credito verso la banca dell'esercente che ha richiesto il pagamento di un bene o servizio.
### Storno
L'operazione di storno può essere effettuata solamente dopo una cattura e mai dopo l'autorizzazione. In questo caso la banca o l'istituto di credito movimenterà il denaro dal conto dell'esercente al conto del cliente.
### Annullamento
L'annullamento della transazione avviene solamente se vi è un'autorizzazione attiva non addebitata. In questo caso l'autorizzazione precedentemente richiesta verrà annullata senza generare alcun movimento del denaro.
## Magento States & Status
Magento gestisce gli status degli ordini attraverso due parametri fondamentali :
* **States**
* **nuovo**: L'ordine è nuovo, non processato e non preso in carico da un gateway di pagamento o altro.
* **In attesa del pagamento**: Il pagamento è in corso attraverso il gateway selezionato dal cliente. Gli elementi presenti nell'ordine sono stati già eliminati dall'inventario di Magento.
* **In Elaborazione**: La fattura è stata creata, l'ordine è pronto per essere processato.
* **Completo**: La spedizione è completata.
* **Chiuso**: L'ordine è chiuso prima che la fattura sia stata creata. Gli elementi ritornano in stock.
* **Cancellato**: Una nota di credit è stata effettuata
* **In Attesa**: State manuale per mantenere in sospeso un ordine.
* **Revisione Pagamento**: In attesa di un'integarzione di informazioni da parte del payment gateway: Utilizzato spesso dal modulo di Paypal.
Ogni States di Magento può essere mappato in più Status. Gli Status possono essere impostati manualmente dal proprietario del negozio Magento. I gateway di pagamento di solito hanno la capacità di impostare lo status diverso dal parametro predefinito dall'utente. I gateway di pagamento introducono talvolta nuovi status e non utilizzano quelli di default.
# Servizi Offerti
Banca Sella offre a tutti i commercianti una soluzione di pagamento completa in ogni suo dettaglio. Si rivolge a tutti i tipi di commercianti, dai semplici e piccoli negozi delle PMI italiane alle grandi multinazionali offrendo una soluzione di pagamento all'avanguardia che spazia dalla semplice Hosted 3D Secure alla versione più completa MO.TO, che consente la richiesta diretta di addebito. Una soluzione su misura per ogni esercente.
## Procedure di sicurezza supportate
* Verify By VISA
* Mastercard SecureCode
## Integrazione con il checkout (Interfacce)
L'estensione di pagamento si adatta al sistema integrato del carrello del negozio Magento. La comunicazione fra il server dell'esercente e la banca avvengono attraverso il sistema API della Banca Sella. Il cliente non noterà tale processo. Per i pagamenti con carta di credito, i dati sono trasferiti via API fornite da Banca Sella attraverso tutta la fase di checkout dell'ordine per controllare e salvare le informazioni sensibili nei server della Banca Sella con connessione sicura. Lo stato delle transazioni vengono inviate dalla Banca Sella in un secondo momento, aggiornando lo status corrente dell'ordine mantenendo una sincronia fra i due sistemi (banca/magento).
## Configurazione e gestione delle opzioni dell'estensione
L'estensione offre un nuovo menù Banca Sella nell'are amministrativa di Magento all'interno del menù Vendite > Metodi di Pagamento > Banca Sella. Questo contiene l'accesso a tutte le configurazioni ed opzioni del modulo, così come l'impostazione degli account di accesso, dei file di log ed altre informazioni.
# Pagamenti Supportati
Questa estensione supporta i seguenti metodi di pagamento attraverso la piattaforma messa a disposizione da Banca Sella.
* VISA
* MASTERCARD
* VISA ELECTRON
* JBC
* American Express
* Diners Club
* Maestro
# Caratteristiche
La modalità server to server consente di avere un modulo di inserimento della carta di credito direttamente nella pagina di checkout di Magento e permettere ai clienti di inserire i propri dati sensibili durante la fase di checkout. Il proprietario del negozio Magento dovrà fornire alla propria banca dietro richiesta da parte della Banca Sella un documento che attesti il rispetto delle regole indicate nel prospetto di sicurezza delle transazioni on line PCI DSS. La banca può in qualsiasi momento interrompere il servizio di POS Virtuale ritenendo responsabile di qualsiasi danno alla banca stessa nonchè alla clientela il proprietario del negozio.
Durante la fase di checkout il negozio Magento dovrà offrire garanzie ai visitatori attraverso una politica di sicurezza di alto livello, offrendo una connessione sicura SSL ed un supporto tecnico ai visitatori/acquirenti.
# Requisiti Minimi
## Compatibilità e Requisiti minimi
L’utilizzo di GestPay e quindi anche del webservice GestPayS2S è riservato alle aziende che abbiano stipulato gli **appositi contratti con EasyNolo** e **Banca Sella**, per la gestione delle transazioni con carta di credito online e siano quindi diventate “**Esercenti convenzionati**”. Un esercente convenzionato GestPay è riconosciuto da un codice identificativo detto “Shop Login” ed ha diritto ad utilizzare l’ambiente di Back Office tramite uno o più operatori registrati al portale Sella.it (almeno un operatore, con la qualifica di Amministratore, è necessario per l’attivazione del servizio). Per sottoscrivere il servizio di Banca Sella bisogna far click su
GestPay, inoltre, accetterà le chiamate solo se **provenienti da un indirizzo IP associato allo Shop Login** dell’esercente chiamante.**E’ quindi necessario, sempre dal Back Office (sezione indirizzi IP), inserire l’indirizzo IP del server che eseguirà le chiamata al web service GestPayS2S**.
Infine bisogna richiedere al proprio hosting provider un certificato SSL per poter proteggere le comunicazioni della propria clientela. Vedi nella sezione **certificato SSL**.
## Requisiti Software
Negozio **Magento**:
* Community dalla release 1.9.x
* Enterprise 1.x
* Community dalla release 2.x
**Estensioni richieste nel server:**
* simplexml
* SOAP (per Webservices API)
* mcrypt
* hash
* GD
* DOM
* iconv
* curl
# Magento 1
Il modulo per la versione 1 è molto simile alla versione 2 ma strutturalmente è realmente diverso. In questa sezione discuteremo della versione Magento 1.9.x.
{% hint style="info" %}
Vi consigliamo di integrare le informazioni mancanti nella versione Magento 2 con quelle presenti in questa sezione al fine di non replicare due volte le stesse informazioni sul modulo.
{% endhint %}
# Installazione e Aggiornamento
Dopo aver installato Magento ed acquistato il modulo di pagamento riceverete il file compresso contenente il modulo via email. Decomprimete il file nel vostro computer ed inviate la cartella **app** nella cartella di **root del vostro sito internet** via FTP. Entrate nell'area amministrativa di Magento (se eravate già dentro l'area amministrativa scollegatevi e ricollegatevi).
* Svuotare la **Cache di Magento**
* Accedete a: **Sistema > Configurazione** > **Metodi di Pagamento** , troverete il nuovo modulo installato oppure a **Vendite** > **Metodi di Pagamento** > **Banca Sella**
* Se si era già connessi nell'area amministrativa di magento disconnettersi e rieffettuare il login.
## Aggiornamento del modulo
Il nuovo modulo ufficiale del Banca Sella richiede un'attenta pulizia del sistema dal vecchio modulo presente nel vostro negozio Magento. Per disinstallare il modulo bisogna prima di tutto preparare una **copia di backup** del sito internet (**files/database**) e successivamente cancellare le seguenti [cartelle e files](https://gist.githubusercontent.com/shinesoftware/16e349f5fc45aa70a3cb1d5df23c4d12/raw/6cb88b543acbd9f2a3a42b59612b524151468d16/banca-sella-1.3.0.txt) e cancellare all'interno della tabella core\_config\_data i records legati al modulo. Bisogna fare attenzione al prefisso delle cartelle di Magento usato in fase di installazione del software e modificare la query proposta di seguito con il proprio prefisso.
Ecco la query per comodità:
> DELETE from core\_config\_data where path like 'payment/bancasella%';
La Shine Software offre un servizio dedicato all'aggiornamento dei dati e dei moduli Magento. Se qualcosa non dovesse andare per il verso giusto, ripristinate il database ed i file all'ultimo backup e chiedete la nostra assistenza.
La richiesta di assistenza tecnica per qualsiasi errore riscontrato durante la fase di installazione, configurazione, uso del modulo avrà un **costo di un'ora di** [**Assistenza Tecnica Magento**](http://www.shinesoftware.com/programmatore-magento.html) per il controllo, la correzione e la riconfigurazione del modulo. Per qualsiasi richiesta di assistenza usare il gestore delle segnalazioni.
## Reset Configurazione
Per azzerare la configurazione del modulo di pagamento basta eseguire la seguente query direttamente nel database del negozio Magento.
> DELETE from core\_config\_data where path like 'payment/bancasella%';
## Cache System
Prima di ogni operazione sui files di template di Magento bisogna accertarsi che nel negozio non sia attiva alcun tipo di cache. Quindi disabilitare tutte le cache attive come ad esempio:
* Cache interna di Magento
* Cache APC o Varnish, xCache, ecc...
* Compilazione del codice sorgente di Magento
## Avvertenze
Tutte le operazioni di installazione, Configurazione e Aggiornamento del modulo e le conseguenti modifiche ai records presenti nel database richiedono una **copia di backup sempre prima di eseguire l'operazione dispositiva** nel proprio archivio. La Shine Software non si assume alcuna responsabilità sull'operazione eseguita sul negozio Magento da parte di terzi.
# Disinstallazione
La disinstallazione di un modulo dentro Magento 1.x è molto semplice: basta cancellare i files che compongono il modulo. Partendo dalla struttura dei files presente nel pacchetto compresso ricevuto dopo l'acquisto, bisogna accedere via FTP e cancellare i singoli file e cartelle. Successivamente aprire il proprio database collegato a Magento e cancellare le occorrenze legate alla configurazione del modulo per rendere il proprio archivio pulito.
{% hint style="info" %}
**DISCLAIMER**: Non consigliamo di eseguire le query se non si è esperti di archivi! La Shine Software non si assume alcuna responsabilità sulle prassi adottate dai clienti per eseguire operazioni direttamente nel database.
{% endhint %}
Per cancellare i dati presenti dentro il database basta eseguire i seguenti comandi facendo sempre molta attenzione alla risposta da parte del MySQL.
{% hint style="info" %}
**ATTENZIONE: Prima di ogni operazione sull'archivio consigliamo di effettuare un Backup dei dati!**
{% endhint %}
**Query per Magento 1.9.x**
> DELETE from eav\_attribute where attribute\_code = 'house\_extension'; DELETE from eav\_attribute where attribute\_code = 'housenumber'; DELETE from eav\_attribute where attribute\_code = 'streetnumber'; DELETE from eav\_attribute where attribute\_code = 'social\_security\_number'; ALTER TABLE sales\_flat\_quote\_address DROP 'streetnumber'; ALTER TABLE sales\_flat\_quote\_address DROP 'housenumber'; ALTER TABLE sales\_flat\_quote\_address DROP 'house\_extension'; DROP TABLE bancasella\_token; DROP TABLE bancasella\_mybank; DELETE from core\_config\_data where path like 'payment/bancasella%';
# Soluzioni di pagamento
Per semplificare le attività di realizzazione dell’interfaccia al “**Payment Gateway**”, Banca Sella ha studiato degli specifici plug-in che vengono forniti al Merchant e che consentono una rapida integrazione delle funzioni di pagamento all’interno del proprio sistema. Sfruttando il modulo di pagamento della Shine Software l'esercente potrà integrare velocemente il metodo di pagamento in pochi minuti e disporre di un POS Virtuale.
## Terminali Abilitati
L'istituto Banca Sella attiva i servizi di pagamento Server to Server a tutte le Banche, le quali ne richiedano l'attivazione per conto dell'esercente. Il codice di accesso ai servizi viene chiamato Terminale. Più avanti durante la configurazione del modulo si noterà un parametro da impostare chiamato **Terminal ID**.
Il parametro Terminal ID è il codice identificativo del terminale attivato nei server della Banca Sella. Alla sottoscrizione del servizio POS Virtuale potrebbe capitare che un terminale non sia stato attivato oppure il codice inserito non presente negli archivi generando un codice di errore durante la transazione.
Il servizio Server to Server è un profilo che offre la diretta connessione con i server della banca. Tutte le comunicazioni inviate al server della banca vengono elaborate dal modulo di pagamento di Magento generandone un log (vedi [Logging & Debug](https://github.com/shinesoftware/banca-sella-advanced-2-0-magento/tree/79bf80d26395c42f01e17fcfe331d083254767c5/logging-and-debug.md)).
Il modulo Magento della Shine Software rende disponibile un completo sistema di **Back office** in cui è possibile visualizzare la propria operatività ed effettuare la gestione amministrativa delle transazioni, ad esempio la richiesta di addebito del Titolare della carta al momento dell’evasione dell’ordine o di riaccredito in caso di reso.\
Le funzioni amministrative sono automatizzate interfacciando il sistema Magento al “Payment Gateway”, con l’interfacciamento diretto.
# Server to Server
La modalità **server to server** prevede l’autorizzazione on line della richiesta di pagamento, con invio da parte dell’Azienda venditrice dei dati relativi alla carta di credito. Questa modalità è utilizzata anche per la richiesta dei pagamenti relativi ad ordini ricevuti tramite gli altri canali di vendita (ad esempio corrispondenza o telefono, m-commerce, etc.).
La soluzione **server to server** sfruttata dal modulo Magento permette al cliente di effettuare il pagamento immediato inserendo i dati della propria carta di credito direttamente nella pagina protetta del negozio Magento.
## Modulo di Pagamento
Osservando il modulo di pagamento in dettaglio possiamo scoprirne alcune utili funzionalità come la selezione automatizzata della carta di credito ed ai suggerimenti relativi al codice di verifica. La grafica standard è perfettamente integrata allo stile di Magento ed al modulo One Step Checkout.
Ecco un esempio di visualizzazione della sezione del metodo di pagamento direttamente all'interno di uno dei moduli Magento più famosi: "**One Step Checkout**".\
## Integrazione
Il metodo di pagamento si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di eseguire i pagamenti onsite.
# Configurazione Server to Server & MO.TO
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Banca Sella > Configuration > eCommerce 3D Secure - Server to Server > Settings. Il pannello di controllo del metodo si presenterà come da foto.\
Nel pannello di controllo del metodo di pagamento selezionato vi è una sezione che consente una configurazione più semplice delle opzioni consentite.
L'opzione principale si trova proprio sotto tutte le opzioni:
* **Abilitato**
Per attivare il modulo l'opzione "Abilitato" deve essere attiva.
Il pannello di configurazione del metodo di pagamento è diviso in tre sotto sezioni:
* Required Settings
* Base Settings
Per poter utilizzare il metodo di pagamento nella propria installazione Magento bisogna disporre delle credenziali fornite dalla banca di test e/o di produzione. Senza tali informazioni non sarà possibile attivare il metodo di pagamento. Per delle credenziali di test generiche è possibile utilizzare le credenziali della Shine Software presenti nel documento.
## Required Settings
Le impostazioni richieste minime si trovano in questo pannello. Configurando questo pannello, il modulo sarà funzionante sia nell'area amministrativa di Magento che nell'area pubblica. Di seguito una foto della sezione.
| | PARAMETRI |
| -------------------- | -------------------------------------------------------------- |
| Use CVV Verification | Controllo formale del codice CVV inserito dal cliente |
| Credit Card Types | Lista delle carte di credito attivabili. Vedi contratto banca. |
| Shop Login | Credenziali fornite dalla banca |
| Title | Titolo visibile nell'area di checkout dalla clientela |
## Base Settings
La sotto sezione "Impostazioni di Base" offre una serie di parametri che permetteranno all'esercente di personalizzare il comportamento del modulo durante le fasi operative.
| TITOLO | DESCRIZIONE |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Show Banca Sella Logo | Mostra il logo di banca sella nella pagina del catalogo con un link al sito di banca sella. |
| Hide Credit Card | Nasconde il modulo dei dati della carta di credito durante il checkout solo se il servizio Token è attivo |
| Disabel Email Notification from the Bank | Disabilità la notifica via email al cliente da parte della banca |
| Sort Order | Impostazione dell'ordine di visualizzazione pubblica del metodo di pagamento. |
| Payment to applicable countries | Paesi di provenienza nel quale il metodo di pagamento sarà visibile |
# MO.TO. (Mail Order/Telephone Order)
Con la parola MO.TO. (Mail Order/Telephone Order) indichiamo i pagamenti effettuati in modalità Server to Server, nei quali **non viene richiesta l’autenticazione 3DSecure** del titolare.
In questi casi, la fase di pagamento si esaurisce con l’invio verso Banca Sella di una richiesta di pagamento contenente tutti i dati necessari per effettuare il pagamento e la ricezione di una risposta in modalità sincrona contenente l’esito del pagamento stesso. Nei casi in cui è previsto che il titolare sottoponga i dati relativi alla propria carta di credito direttamente al sistema del Commerciante, **lo stesso è soggetto alle normative PCI-DSS**; Banca Sella e le banche ad essa collegate si riservano la possibilità di richiedere un documento che ne attesti la certificazione.
## Creazione Ordine Amministrazione MO.TO
Nell'area amministrativa degli ordini di Magento è possibile realizzare un ordine usando in combinazione al metodo MO.TO al fine di effettuare un pagamento diretto sfruttando la tecnologia Magento ed il POS Virtuale della Banca Sella. Tale funzionalità è prevista solamente per contratti in cui l'esercente potrà effettuare Autorizzazioni dirette senza il sistema 3D Secure. Contattare la propria banca per ulteriori dettagli.
# Hosted 3D Secure
La soluzione Hosted 3D Secure offre agli esercenti **un modo semplice, veloce e sicuro per ricevere i pagamenti con carta di credito, e digital wallet**, dai loro clienti utilizzando un redirect durante la fase di pagamento al sito sicuro della banca.
Tale soluzione **non richiede alcuna certificazione di sicurezza PCI-DSS** poichè la sicurezza della transazione di pagamento viene delegata all'istituto Banca Sella. Il cliente si troverà in **un sito internet protetto e sicuro** in cui potrà indicare le informazioni sensibili quali carta di credito e/o password ai servizi Digital Wallet.
La pagina visualizzata dal cliente viene chiamata "**Hosted Payment Page**", il cui cliente dovrà **selezionare la modalità di pagamento preferita**. Le soluzioni offerte della Banca Sella sono disponibili alla pagina "[Pagamenti Supportati](/pagamenti-supportati)".
## Magento Checkout
Durante la fase di checkout del carrello in Magento, ed in particolare durante la selezione del metodo di pagamento attivo nel negozio, il cliente visualizzerà il nome del metodo di pagamento, una descrizione scelta dall'esercente ed un avviso di reindirizzamento alla conferma dell'ordine.
Durante il reindirizzamento al server della banca, il cliente visualizzerà temporaneamente una pagina personalizzabile in cui verrà avvisato del reindirizzamento. Il reindirizzamento avverrà automaticamente e qualora vi fosse un'impostazione differente del browser che non consente l'uso di javascript, il cliente potrà manualmente accedere alla pagina di pagamento effettuando un click al link indicato nella pagina.
Al caricamento dell'interfaccia semplice e sicura della banca, l'utente dovrà selezionare il metodo di pagamento desiderato.Dopo aver inserito le informazioni richieste dalla banca come i dettagli della carta di credito da usare per effettuare il pagamento della merce desiderata, il cliente dovrà far click sul bottone di conferma presente nella pagina ed attendere il completamento della transazione di pagamento.
Al termine del pagamento il server della banca reindirizzerà l'utente nella pagina di conferma del negozio Magento solamente se la transazione è avvenuta correttamente. In tutti gli altri casi il cliente verrà avvisato dell'avvenuto fallimento della transazione offrendo la possibilità di ritentare il pagamento.
Se tutte le operazioni di installazione e configurazione del modulo sono state effettuate correttamente, al termine del pagamento del cliente, quest'ultimo verrebbe reindirizzato al sito dell'esercente nella pagina di successo. Il cliente riceverà via email la notifica di avvenuta creazione dell'ordine ed il carrello verrebbe correttamente svuotato.\
Tutte le operazioni vengono registrate dal modulo nel proprio file di LOG (vedi [Logging & Debug](https://github.com/shinesoftware/banca-sella-advanced-2-0-magento/tree/79bf80d26395c42f01e17fcfe331d083254767c5/logging-and-debug.md\)\)).
# Configurazione Hosted
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Banca Sella > Configuration > Hosted 3D Secure > Settings. Il pannello di controllo del metodo si presenterà come da foto.\
{% hint style="info" %}
Attenzione: tutte le immagini sono rappresentative. I continui aggiornamenti ne possono modificare l'aspetto e potreste non trovar alcuni parametri inseriti successivamente alla creazione dello screenshot presente nella guida.
{% endhint %}
Nel pannello di controllo del metodo di pagamento selezionato vi è una sezione che consente una configurazione più semplice delle opzioni consentite.
L'opzione principale si trova proprio sotto tutte le opzioni:
* **Abilitato**
Per attivare il modulo l'opzione "Abilitato" deve essere attiva.
Il pannello di configurazione del metodo di pagamento è diviso in tre sotto sezioni:
* Required Settings
* Base Settings
Per poter utilizzare il metodo di pagamento nella propria installazione Magento bisogna disporre delle credenziali fornite dalla banca di test e/o di produzione. Senza tali informazioni non sarà possibile attivare il metodo di pagamento. Per delle credenziali di test generiche è possibile utilizzare le credenziali della Shine Software presenti nel documento.
## Required Settings
Le impostazioni richieste minime si trovano in questo pannello. Configurando questo pannello, il modulo sarà funzionante sia nell'area amministrativa di Magento che nell'area pubblica. Di seguito una foto della sezione.
| | PARAMETRI |
| ---------------- | ----------------------------------------------------------------------------------------------------------------- |
| Debug | Impostazione della modalità da utilizzare durante le transaz. |
| New Order Status | Status dell'ordine prima del reindirizzamento del cliente |
| Transaction Type | Tipologia di transazione da richiedere alla banca |
| Shop Login | Codice identificativo del terminale esercente rilasciato dallabanca alla sottoscrizione del servizio POS VIRTUALE |
| Title | Titolo visibile nell'area di checkout dalla clientela |
## Base Settings
La sotto sezione "Impostazioni di Base" offre una serie di parametri che permetteranno all'esercente di personalizzare il comportamento del modulo durante le fasi operative.
| | PARAMETRI |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sort order | Posizione metodo di pagamento nella pagina di checkout |
| Language Redirection | Se impostato l'utente verrà reindirizzato nel sito sicuro nella lingua della store view selezionata. Importante impostare sul sito di Banca Sella il parametro di Input in caso contrario si riceverà un errore. |
| Payment to applicable countries | Paesi di provenienza nel quale il metodo di pagamento saràvisibile |
| Checkout option description | Descrizione personalizzata visibile nel checkout al cliente |
# Digital Wallet Token
Tutti i clienti con la funzionalità Token possono attivare l'opzione dal pannello di controllo del modulo e più di preciso nella sezione dedicata: Sistema > Configurazione > Metodi di Pagamento > Banca Sella >Digital Wallet > Attivo > Yes.
Non apparirà niente nell'area pubblica finchè il cliente non sceglie di registrare la sua carta di credito usando l'opzione presente nel modulo di pagamento in cui viene inserita la carta di credito:
Il primo pagamento dovrà essere effettuato l'inserimento dei dati della carta di credito. Dal successivo pagamento il sistema di checkout visualizzerà un nuovo metodo di pagamento, come da figura.
L'utente non dovrà modificare, inserire o selezionare nulla e procedere con la conferma dell'ordine. Le operazioni di cattura, storno e annullamento rimarranno invariate.
## Pannello di Configurazione
Per impostare il Digital Wallet basta indicare lo Shop Login fornito dalla banca con l'opzione Tokenization attiva e l'opzione Debug che consente di impostare il metodo di pagamento in modalità di test o di produzione.\
# Template Personalizzato
I file di stile ed i file di layout standard del modulo sono posizionati nella cartella
* /app/design/frontend/base
* /app/design/adminhtml/default
Qualora il template installato nel negozio non rispetti la gerarchia del Core di Magento il modulo potrebbe non mostrare le interfacce grafiche non generando un errore visibile. Controllare i file system.log ed exception.log per comprendere dove il vostro template si aspetta di trovare i files.
Il modulo ha in sè alcune porzioni di template presenti dentro la cartella /app/design/frontend/**base** come indicato sopra. La path base indica che se Magento non dovesse trovare i file dentro al template personalizzato risalirebbe al "**template base**" nel quale vi sono tutti i files di template del core di Magento compresi anche i files del modulo.
In questi casi basterebbe un controllo approfondito del template Magento accertandosi della correttezza delle path usate nel caricamento del layout.
E' possibile richiedere assistenza all'installazione del modulo ai tecnici della Shine Software scegliendo il servizio Installazione e Configurazione Moduli Magento presente nel sito internet [www.shinesoftware.it](http://www.shinesoftware.it/).
## Personalizzazione del Redirect
E' possibile conoscere tutti i blocchi generati dal modulo dal file di layout che si trova in */app/design/frontend/base/default/layout/nomemodulo.xml*
Le pagine di redirect sono definite sotto l'elemento: "**\[nomemodulo]\_\[metododipagamento]\_redirect**". E' possibile creare un blocco statico ed aggiungerlo usando un innesto del blocco nel file xml.
Quindi ricapitolando:
1. Creare il blocco statico in Magento
2. Modificare il file di layout precedentemente creato inserendo il blocco statico con il comando indicato di seguito
3. Aggiornare la cache di Magento
> \\
> \\page/1column.phtml\\\
> **\**\
> **\**\
> **\your\_block\_id\_1\**\
> **\**\
> **\**\
> \
In questo modo durante la creazione della pagina di redirect magento intercetterà che bisognerà includere il nuovo blocco statico.
## Cache System
Prima di ogni operazione sui files di template di Magento bisogna accertarsi che nel negozio non sia attiva alcun tipo di cache. Quindi disabilitare tutte le cache attive come ad esempio:
* Cache interna di Magento
* Cache APC o Varnish, xCache, ecc...
* Compilazione del codice sorgente di Magento
E' possibile richiedere assistenza all'installazione del modulo ai tecnici della Shine Software scegliendo il servizio Installazione e Configurazione Moduli Magento presente nel sito internet [www.shinesoftware.it](https://www.gitbook.com/book/shinesoftware/consorzio-triveneto/edit#).
# Transazioni Magento
Il modulo di pagamento per Magento offre un completo supporto alle transazioni di pagamento connesse al sistema Server to Server della Banca Sella.
L'amministratore del negozio Magento potrà, attraverso il pannello di controllo ordini, gestire tutte le transazioni di pagamento come:
* **Autorizzazione**
* **Cattura**
* **Storno** (anche parziale di una fattura)
* **Annullamento** dell'Autorizzazione
## Movimentazione / Cattura
E’ l’operazione di conferma finanziaria che può seguire una 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).
## Storno / Refund / Rimborso
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.
## Lista Transazioni
Il modulo genera una lista di transazioni in cui vengono inseriti tutti i parametri delle richieste sui server.
E' possibile conoscere l'esito dell'operazione immediatamente dopo l'esecuzione stessa. L'amministratore non dovrà accedere al pannello di backoffice del Banca Sella per conoscere gli esiti, ma far click semplicemente nella singola transazione e visualizzare la risposta della richiesta "Server to Server".\
# Logging & Debug
Qualsiasi comunicazione con Banca Sella viene registrata in un file di log e può essere utilizzato per il supporto, il test e operazioni di debug dai tecnici del negozio Magento. Le richieste di status delle transazioni di pagamento inviate via API a Banca Sella ed i dati dei processi di pagamento integrati in cui viene richiesta la carta di credito sono esclusi da questo log.
## Magento Log
Per attivare il sistema di registrazione log di Magento bisogna accedere alla sezione amministrativa di Magento e dal menù:
Sistema > Configurazione > Avanzate > Sviluppatore > Impostazioni Log > Abilitato > Si\
Dopo aver attivato il sistema di log e salvato la configurazione, il software magento creerà uno o più file di testo con estensione .log all'interno della cartella del progetto /var/log. La cartella /var/log deve avere i permessi di scrittura per poter creare i file. Per ulteriori informazioni contattare il servizio assistenza del piano hosting.
## Payment Log
Per scaricare il file di Log, crearne una copia di backup basta effettuare un semplice click sul bottone creato appositamente nel pannello di controllo del modulo: **Download Log file**.\
Per generare un file di log pulito e con una sola transazione basta eseguire queste operazioni:
1. Fare click su Clear Log file
2. Eseguire un test di acquisto su Magento
3. Fare click su Download Log file
In questo modo il file precedentemente creato verrà conservato in una copia di backup dentro la cartella dei log di Magento e verrà creato un file pulito. Questa operazione è possibile usarla quando si desidera inviare un file di log alla banca per un supporto tecnico (vedi capitolo [Helpdesk Support](/magento-1/helpdesk-support)).Errori Comuni
Durante la connessione ai servizi potrebbe capitare di visualizzare i seguenti codici di errore. I codici di errore sono inviati dal server della Banca Sella al vostro negozio e non provengono dal modulo. Il modulo li interpreta, li trascrive nel file di log ed attraverso il file di log i tecnici della Banca Sella potranno il motivo dell'errore. Prima di contattare i tecnici della Banca Sella con l'opzione "[Helpdesk Support](/magento-1/helpdesk-support)", di seguito descritto, è bene effettuare un controllo semplice utilizzando le informazioni riportate di seguito.
### Mastercard BIN 2 Series
MasterCard ha aggiunto una nuova serie di numeri di carte di credito di recente, la serie 2. In passato, i numeri BIN di MasterCard sono sempre iniziati con un 5 (come 5424-0000-0000-0015), ma ciò non sarà più vero. A partire da quest'anno, MasterCard emette carte nell'intervallo 22-27 (range 222100-272099) ad esempio 2223000010089800.
Il nostro modulo è già abilitato per supportare le due serie di numeri ma **Magento necessita di una modifica.** Per risolvere il problema tecnico basta seguire la seguente guida: oppure richiedere un nostro preventivo di assistenza tecnica magento. Per i dettagli sul nostro servizio di assistenza Magento ([link](https://shinesoftware.it/programmatore-magento.html)).
# Helpdesk Support
Il modulo di pagamento Banca Sella registra all'interno di un file di log tutte le informazioni necessarie per effettuare una transazione di pagamento utilizzando i server della Banca Sella. Oltre alle richieste di inizializzazione delle richieste vengono registrate anche tutti i parametri di risposta del server, consentendo di effettuare un controllo approfondito del funzionamento del modulo di pagamento.
Al fine di velocizzare qualsiasi operazione di supporto tecnico, nell'area amministrativa del modulo Sistema > Banca Sella > Configurazione > General Options > Helpdesk è possibile inviare una richiesta completa agli operatori della Banca Sella via email automaticamente con un semplice click sul bottone **Request Helpdesk Support**.
Tale opzione permette di inviare un'email contenente tutte le informazioni necessarie per un "debug" veloce da parte dello staff tecnico della Banca Sella.\
Il file di log inviato all'helpdesk si trova nella cartella di Magento /var/log/shinesoftware\_bancasella.log
Di seguito un estratto del file di log:
## Cosa fare se si riscontra un problema?
Prima di inviare alla Banca Sella una richiesta di assistenza si consiglia di svuotare il file di log attraverso la funzione "Clear Logs" presente nel pannello di controllo del modulo nella sezione "Payment module options". Il file originale verrà duplicato come file di backup ed il file originale verrà svuotato.\
Dopo aver pulito il file di log, eseguite l'operazione di acquisto di un prodotto fino a riprodurre il problema riscontrato durante il pagamento. A questo punto, il file di log ha registrato le operazioni eseguite ed è pronto per essere inviato all'helpdesk della Banca Sella.
## Assistenza Tecnica
Il modulo ha superato centinaia di controlli ed è installato in moltissimi negozi Magento sparsi nel territorio nazionale. Viene aggiornato costantemente per mantenere uno standard alto di qualità del servizio offerto dalla Shine Software. La richiesta di assistenza tecnica per qualsiasi errore riscontrato durante la fase di installazione, configurazione, uso del modulo avrà un **costo di un'ora di** [**Assistenza Tecnica Magento**](http://www.shinesoftware.com/programmatore-magento.html) per il controllo, la correzione e la riconfigurazione del modulo. Per qualsiasi richiesta di assistenza usare il gestore delle segnalazioni allegando il file di log generato dal modulo.
# Magento 2
Descrizione delle impostazioni generiche sul modulo che lo distinguono dalla versione per Magento 1
# Installazione e Aggiornamento
### Installazione via Shell
Se si desidera installare il modulo via shell bisogna eseguire il seguente comando dalla root di Magento.
```
composer config repositories.bancasella vcs git@bitbucket.org:shinesoftware/bancasella.git
composer config repositories.core vcs git@bitbucket.org:shinesoftware/core.git
composer require shinesoftware/core:dev-master
composer require shinesoftware/bancasella:dev-master
```
All'esecuzione del comando il software composer avvierà la procedura di recupero del repository presso bitbucket.org.
{% hint style="info" %}
Per poter installare il modulo bisogna avere la licenza attiva per ogni dominio configurato in Magento.
{% endhint %}
Per poter connettere il vostro composer al repository ufficiale serve una chiave SSH valida che permetterà al sistema Bitbucket.org di inviarvi il pacchetto.
{% hint style="info" %}
Per poter recuperare la chiave pubblica in un server unix-like dovrete eseguire il seguente comando nel terminale linux:
cat \~/.ssh/id\_rsa.pub
{% endhint %}
###
# Disinstallazione
La disinstallazione di un modulo dentro Magento 2.x è molto semplice: basta cancellare i le righe che sono state inserite dentro il file composer.json oppure eseguire i seguenti comandi:
```
composer remove shinesoftware/bancasella
composer config --unset repositories.bancasella
```
Bisogna anche pulire il proprio database e per poterlo fare eseguite quanto riportato qua in basso.
{% hint style="info" %}
Aprire il proprio database collegato a Magento e cancellare le occorrenze legate alla configurazione del modulo dentro la cartella **core\_config\_data** per rendere il proprio archivio pulito.
{% endhint %}
# Configurazione Gestpay
Per utilizzare i servizi di Banca Sella bisogna configurare il pannello di controllo della banca nel servizio chiamato Gestpay.
Il pannello di controllo fornisce agli esercenti un vero e proprio cuscotto di funzionalità pre-abilitate dalla banca solo DOPO un CONTRATTO. Durante la fase di test potete chiedere di attivare nel vostro account tutte le specifiche opzioni necessarie senza sottoscrivere alcun contratto.
I servizi quali il pagamento con carta di credito on site, il controllo del Verify by VISA o Mastercard Secure Code, oppure il servizio MyBank necessitano di alcuni parametri attivi nel pannello Gestpay per poter essere utilizzati dal modulo di Magento.
L'assenza di tali parametri o la cattiva configurazione bloccherà il vostro account o non sarà possibile connettersi al servizio richiesto. Quindi prima di tutto bisogna contattare la Banca Sella e chiedere un account di test che rispecchi le impostazioni del contratto attivato dall'esercente, successivamente si necessita di una corretta configurazione dei parametri del pannello gestpay ed infine bisogna impostare il pannello di controllo del modulo di pagamento Banca Sella dentro Magento.
Il vantaggio del nostro modulo è il file di LOG generato che contiene tutti i dati inviati e ricevuti dai server della Banca Sella. Tale file può essere inviato al reparto tecnico della Banca Sella per capire come mai il vostro profilo non funziona correttamente.
Di seguito la lista dei servizi della Banca Sella per i quali è indispensabile una configurazione:
1. **Starter** (Non necessita di configurazione)
2. **Professional**
3. **Unlimited**
## Creazione Profilo (Shop Login)
Il modulo per poter funzionare correttamente necessita di un profilo Banca Sella di Test ed un profilo Banca Sella Ufficiale. Per creare un profilo di test basta far click nel presente link: e registrarsi.\
Al termine della procedura riceverete delle credenziali via email. Per accedere al **pannello di configurazione di TEST** della Banca Sella bisogna far click sul seguente link:
Successivamente bisogna selezionare il profilo creato e configurarlo come indicato nella prossima immagine. Le schermate presentate sono puramente a titolo di esempio. I parametri sono mostrati di seguito.
## Indirizzi IP
Dopo il login bisogna impostare gli indirizzi IP del proprio nome a dominio per poter essere riconosciuti dal server durante le richieste effettuate dai potenziali clienti.
## Risposte Server
Dopo aver effettuato la transazione di pagamento, la Banca Sella chiama l'url indicato nella sezione delle risposte. Tale impostazione è valida per i profili Starter e Professional e non per la versione Unlimited.
* **URL risposta positiva**
* (Magento 1.x)
* [https://www.vostrodominio.it/bancasella/\*\***hosted**\*\*/notify](https://www.vostrodominio.it/bancasella/**hosted**/notify) (Magento 2.x)
* **URL risposta negativa**
*
* [https://www.vostrodominio.it/bancasella/\*\***hosted**\*\*/notify](https://www.vostrodominio.it/bancasella/**hosted**/notify) (Magento 2.x)
* **URL Server to Server**
* (Magento 1.x)
* [http://www.vostrodominio.it/bancasella/\*\***hosted\*\***/s2s](https://legacy.gitbook.com/book/shinesoftware/banca-sella-advanced-2-0-magento/edit#) (Magento 2.x)
Per gli esercenti che utilizzano Magento 2.x bisogna notare la parola hosted presente nell'url di notifica e di risposta che indica il tipo di metodo utilizzato durante la transazione.
## **Email di Notifica**
Inserire gli indirizzi email per ricevere la notifica di pagamento o gli eventuali errori sulle transazioni.
# Starter
Il modulo permette di **connettere un negozio Magento a Banca Sella** anche in modalità "**Webservice**" per un profilo Starter oppure Professional. Il modulo presenta nella sezione pubblica del carrello (checkout) solamente l'informazione di reindirizzamento verso il server sicuro della Banca Sella. La transazione viene eseguita dopo **essere stati reindirizzati** nel sito della Banca Sella.
Questo profilo risulta essere il più semplice dei tre mostrati in precedenza poichè **non vi è alcuna impostazione da effettuare** nel pannello di controllo della banca.
Attenzione! **Non è possibile aggiungere i parametri personalizzati dal pannello della Banca Sella!**
# Professional
Il modulo permette di **connettere un negozio Magento a Banca Sella** anche in modalità "**Webservice**" per un profilo Professional. Il modulo presenta nella sezione pubblica del carrello (checkout) solamente l'informazione di reindirizzamento verso il server sicuro della Banca Sella. La transazione viene eseguita dopo **essere stati reindirizzati** nel sito della Banca Sella.
Questo profilo richiede la configurazione dell'URL di risposta.
## URL di Risposta
Per poter ricevere le notifiche dello status della transazione di pagamento Banca Sella richiede degli URL che puntino al proprio negozio Magento. Nel caso del modulo Banca Sella Professional bisogna impostare i seguenti URL con le dovute modifiche in base al vostro dominio:
#### MAGENTO 1.x
* **URL per risposta positiva:**
* **URL per risposta negativa**
* **URL Server to Server**
#### Magento 2.x
Per quanto riguarda Magento 2 i link sono differenti. Bisogna indicare il nome del gateway utilizzato dentro il link. I nomi dei gateway sono:
1. hosted
2. masterpass
3. moto
4. mybank
5. paypal
* **URL per risposta positiva:**
* **URL per risposta negativa**
* **URL Server to Server**
# Tokenization
Per attivare l'opzione di Tokenization aggiuntiva bisogna attivare il metodo [Digital Wallet](/magento-1/soluzioni-di-pagamento/digital-wallet-token) che consente di registrare un token assegnato al cliente al primo acquisto. Tale "Borsellino Elettronico" è possibile usarlo solamente se la Banca Sella ha attivato l'opzione nel profilo assegnato ed anche solamente previa impostazione dei parametri di risposta web service:
* Token (parametro)
* TokenExpiryMonth
* TokenExpiryYear
**Se tale opzione è attiva e l'utente ha un token a disposizione, il metodo Hosted verrà nascosto per favorire l'uso del Token anzichè la carta di credito.** Se il cliente desidera usare una nuova carta di credito deve cancellare il vecchio Token dalla pagina presente nel suo profilo.
# Unlimited
Il profilo Banca Sella Unlimited offre la **possibilità di far pagare i clienti direttamente nel negozio** durante la fase di checkout dell'ordine senza alcun reindirizzamento verso l'esterno. La sua configurazione deve essere corretta al fine di evitare problemi di connessione e/o parametri incorretti e/o mancanti. Qui di seguito riportiamo l'immagine del pannello di configurazione della banca in un profilo Unlimited.
## Ambiente di Configurazione
Bisogna fare sempre molta attenzione all' "ambiente di configurazione" posto in alto a sinistra (vedi freccia rossa) in cui si deve selezionare NO DISPLAY. La pagina NO DISPLAY si riferisce al servizio senza un redirect. In pratica si dice alla banca sella che durante la connessione con lo Shop Login indicato in alto a destra GESPAY58910 (nostro codice di test) non bisognerà reindirizzare gli utenti nel sito sicuro poichè l'inserimento dei dati della carta di credito avverrà direttamente nel sito internet.
## Parametri Carta di Credito
Per poter inviare i parametri di carta di credito ai server della banca bisogna indicare che tali parametri devono essere ricevuti dal sistema pena non comprensione della richiesta. Ecco come la lista dei parametri:
* **Currency**
* **ShopTransactionId**
* **BuyerName**
* **BuyerEmail**
* **LanguageId**
## Gestione delle transazioni
Il modulo Banca Sella Unlimited della Shine Software consente di gestire le transazioni finanziarie direttamente dentro la gestione degli ordini di Magento. Le varie [operazioni finanziarie](/transazioni-con-carta-di-credito) possono essere totalmente gestite usando il sistema interno di Magento che registrerà i parametri restituiti dalla banca sella per effettuare a catena le successive fasi. Ad esempio:
* **Autorizzazione** (richiesta dal cliente al checkout)
* L'operazione genererà una transazione (record) dentro Magento (Autorisation / Autorizzazione) in cui appariranno i parametri per le successive fasi.
* **Annullamento** dell'Autorizzazione (richiesta dall'esercente)
* L'operazione genererà una transazione (record) dentro Magento (Void / Annullamento) in cui appariranno i parametri per le successive fasi.
* **Cattura** dell'Autorizzazione (richiesta dall'esercente)
* L'operazione genererà una transazione (record) dentro Magento (Capture / Prendi) in cui appariranno i parametri per le successive fasi.
* **Storno** della Cattura (richiesta dall'esercente)
* L'operazione genererà una transazione (record) dentro Magento (Refund / Storno) in cui appariranno i parametri per le successive fasi.
Impostare la modalità MO.TO nel sito di Banca Sella, per una maggiore libertà di gestione tramite Magento durante le fasi contabili di fatturazione.
## Cattura Immediata
Se si desidera ricevere il pagamento (cattura) direttamente alla richiesta di una transazione di autorizzazione bisogna impostare la **Contestualità tra Autorizzazione e Conferma Finanziaria**. Il modulo eseguirà un'autorizzazione e la banca sella trasferirà il denaro del cliente direttamente nel conto dell'esercente "contestualmente all'autorizzazione". Nella configurazione del modulo POS della Shine Software non bisognerà impostare nessun parametro. Tale impostazione escluderà il workflow del modulo precedentemente indicato.
# Riskified
Riskified e ReD sono servizi di protezione dalle frodi. Per quanto riguarda Riskified, la banca riceve i dati dell'ordine dal commerciante e vengono inviati a **Riskified (azienda in outsourcing)** con ulteriori informazioni provenienti dal carrello generato dal cliente e viene restituita una risposta di controllo sull'ordine (**Approvato** o **Rifiutato**). Vedi [Security Shield](https://github.com/shinesoftware/banca-sella-advanced-2-0-magento/tree/79bf80d26395c42f01e17fcfe331d083254767c5/security-shield.md).\
Questa opzione dà al commerciante uno strumento di prevenzione della frode legata a ogni transazione, fornito da [**RISKIFIED**](https://www.riskified.com/).
Dal pannello di controllo del modulo di pagamento i due sistemi possono essere attivati facilmente.\
Per ogni ordine è possibile inserire nel xml una serie di parametri che consentono Riskified la possibilità di valutare il rischio di frode legato all'ordine questi parametri sono presenti nel tag ORDERDETAILS. Maggiori informazioni sono fornite a Riskified, più accurata è la valutazione del rischio. Il modulo invia tutti i dati presenti in Magento ed inseriti dal cliente in fase di acquisto.
Nella scheda dell'ordine il modulo scriverà, se il controllo antifrode è stato superato oppure non ha passato i controlli di sicurezza di Riskified.
I **parametri aggiuntivi** da impostare per il servizio Riskified nel pannello di controllo della Banca Sella sono:
* **OrderDetails**
* **Risk Response Code**
* **Risk Response Description**
## Riskified Beacon ID
Durante la navigazione del sito internet verrà creato un codice chiamato BeaconID che invierà alcune informazioni al sistema di sicurezza Riskified che controllerà la provenienza della transazione. Per attivare questo script bisogna fare attenzione alla struttura del proprio template Magento. Lo script Beacon verrà installato nel footer del template di Magento.
### Personalizzazioni
Vista la molteplicità di personalizzazioni dei template magento è pressocchè impossibile controllarne tutte le opzioni di ogni singolo negozio Magento. Proprio per questo motivo, se lo script non fosse presente durante la normale navigazione del negozio Magento, bisogna controllare o richiedere un controllo approfondito nella struttura grafica del layout di Magento all'azienda che ha realizzato il template accertandosi che la sezione di layout footer presente nel layout standard di magento sia presente nel proprio template.
# Token
Il Token è un'opzione che consente di registrare in un archivio sicuro un codice esadecimale che corrisponde ad una carta di credito. Il cliente dopo aver acquistato la prima volta nel negozio, avrà la possibilità di utilizzare un codice al posto della sua carta di credito. La gestione del Token è attivabile dal pannello di controllo del modulo Banca Sella Unlimited.
L'attivazione dell'opzione del Token necessita di una configurazione del pannello di controllo della Banca Sella in cui alcuni parametri dovranno essere restituiti dalla banca al momento dell'avvio della transazione. Ecco il pannello di Gestpay Banca Sella e la sua configurazione per la gestione del Token.
Sarà necessario configurare all'interno della **Pagina No Display** del menu **Pagina di pagamento** > **Campi e Parametri**, i **parametri di Risposta a VERO**:
* Token
* Token Expiry Month
* Token Expiry Year
Il token può essere restituito anche se il pagamento prevede l'autenticazione al servizio 3D secure.
## Checkout
Al checkout dell'ordine in Magento, il cliente che precedentemente ha già acquistato nel negozio usando la sua carta di credito, troverà oltre all'opzione di inserimento del numero di carta di credito anche la possibilità di selezionare un Token precedentemente creato per velocizzare la fase di acquisto. Il cliente quindi potrà:
* Reinserire nuovamente una carta di credito (anche uguale alla precedente, verrà creato un nuovo token)
* Inserire una nuova carta di credito dei circuiti attivi
* Selezionare un token dalla lista proposta nella fase di scelta del modulo di pagamento
Alcune transazioni potrebbero necessitare di un controllo 3DSecure e la conseguente autenticazione da parte del compratore. In questi casi si può impostare il modulo affinchè utilizzi un codice esercente con il sistema 3D Secure per ottenere la prima volta il Token dalla Banca Sella e successivamente far pagare i futuri acquisti con un codice esercente in cui il servizio 3DSecure è disattivato.
# MO.TO (Mail Order/Telephone Order)
È, inoltre, possibile utilizzare il metodo di pagamento con addebito diretto (autorizzazione) per le cosiddette operazioni MO.TO (Mail Order/Telephone Order) in Magento. Tale operazione risulta molto utile per le aziende che ricevono le richieste di acquisto via telefono o via email da parte dei clienti.
**L'esercente può richiedere per via telefonica al cliente i dettagli della sua carta di credito ed accedendo nell'area amministrativa di Magento può creare un ordine e addebitarlo al cliente**. Tale operazione di "autorizzazione" blocca il denaro del cliente finchè non verrà richiesta la "cattura" dell'importo indicato nel totale dell'ordine usando la funzionalità "Cattura On Line" di Magento.
Per poter utilizzare la funzionalità MO.TO **l'esercente dovrà impostare la Separazione delle richieste per Autorizzazione e Movimentazione e richiedere alla Banca Sella la disattivazione del sistema 3D Secure**.
Tale disabilitazione permetterà al modulo di richiedere l'autorizzazione sulla carta di credito del cliente. Non è possibile utilizzare il servizio 3D secure ("Verified by VISA", "MasterCard Secure Code") poichè l'esercente non può richiedere al cliente la chiave di sicurezza della carta di credito. Tale opzione, come indicato in precedenza, deve essere richiesta al call center della Banca Sella indicando il codice utente impostato nella configurazione del modulo di pagamento.
Se attivata la funzionalità Token, verranno registrate le carte di credito dei clienti (in chiaro oppure protette), con la possibilità della sovrascrittura della maggior parte delle cifre della carta di credito ai fini della sicurezza dei dati, ed ottenere un Token per poter offrire alla clientela un servizio veloce di sottoscrizione dei prodotti e/o servizi proposti nel proprio negozio Magento.
La funzionalità MyBank, qualora attiva, non può essere utilizzata nella sezione amministrativa di Magento poichè non è possibile richiedere le credenziali di un conto corrente ad un cliente durante la fase di acquisto on line.
# ReD Shield
[Red Shield](https://www.aciworldwide.com/) è una soluzione di prevenzione delle frodi in tempo reale, su misura per le esigenze dei commercianti e-commerce, servizi di pagamento fornitori (PSP) e di organizzazioni indipendenti di vendita (ISOs). La soluzione è progettata per consentire attività di proteggere i ricavi, sostenere la crescita e migliorare l'esperienza del cliente. Fornito come servizio gestito attraverso un esperto team di analisti del rischio esperti, Red Shield fornisce decisioni immediate (accettare / controversia / negare) sul commercio elettronico e le transazioni mCommerce.
Il profilo di Banca Sella deve essere impostato al fine di riconoscere lo stream di dati inviato dal modulo recuperando i dettagli durante la sessione di acquisto del visitatore. Senza una corretta configurazione del modulo, i server della Banca Sella rifiuteranno la transazione indicandovi che alcuni parametri, senza specificare quali, sono necessari e non sono stati ancora impostati nel pannello di controllo della banca.
Contattate lo staff tecnico della Banca Sella per ulteriori informazioni.
Se il metodo di prevenzioni ReD Shield è attivo apparirà un'icona all'interno del metodo di pagamento Server to Server esposto nella sezione di checkout di Magento.
E' possibile nascondere il logo utilizzando l'opzione "Show Logo" presente nel pannello di controllo nella sezione Sistema > Configurazione > Metodi di Pagamento > Banca Sella > "Security Settings" > Shoe Logo > NO
# Servizi Aggiuntivi
**Profili richiesti**: *Profesisonal o Unlimited*
Il modulo permette di connettersi direttamente ai servizi esterni della Banca Sella semplicemente utilizzando il pannello di controllo presente all'interno della sezione Sistema > Configurazione > Metodi di Pagamento > Banca Sella Advanced 2.x
Tutti i servizi necessitano di una configurazione attenta della sezione Campi & Parametri presente nell'area amministrativa di Banca Sella. Ecco uno screenshot della sezione indicata.
# Paypal
**Profilo richiesto**: *Professional o Unlimited*
Banca Sella ha una convenzione con il più grande pos virtuale on line: Paypal. Tale convenzione permette di reindirizzare un utente in una pagina di comodo della banca al termine della procedura di acquisto nella pagina di checkout di Magento.
Tale opzione escluderà la gestione Server 2 Server del piano Banca Sella Unlimited. La commissione di transazione bisogna sempre trattarla con Paypal anche se vi è una convenzione fra le due società, poichè tale convenzione è meramente tecnica con Banca Sella. Banca Sella permetterebbe al cliente attraverso una pagina web di scegliere se pagare con una carta di credito o con un account di Paypal.
Dopo aver [creato il proprio Shop Login](/configurazione-gestpay), **bisogna chiedere al reparto tecnico della Banca Sella di attivare l'opzione Paypal e configurare i parametri obbligatori**.
I **parametri aggiuntivi** da impostare per il servizio Paypal nel pannello di controllo della Banca Sella sono presentati nella seguente immagine.
# MyBank
**Profilo richiesto**: *Professional o Unlimited*
MyBank è una soluzione di autorizzazione elettronica che consente ai consumatori di **effettuare in modo sicuro pagamenti online e autenticazioni dell’identità digitale usando il servizio di online banking delle propria banca**.
**MyBank crea un collegamento diretto online tra il conto corrente bancario del cliente e la banca dell’esercente**, evitando di richiedere e memorizzare dati personali. **L’identità digitale del cliente e i suoi dati sensibili sono sempre protetti.** L’autorizzazione immediata dei pagamenti riduce il rischio di frodi e ri-addebiti. Grazie a MyBank le transazioni online avvengono con più fiducia e serenità.
MyBank e-payment consente di ottenere, **in tempo reale**, **un’autorizzazione per il trasferimento di fondi dal conto bancario del cliente a quello dell’esercente online**, utilizzando un bonifico SEPA.
Dopo aver [creato il proprio Shop Login](/configurazione-gestpay), **bisogna chiedere al reparto tecnico della Banca Sella di attivare l'opzione MyBank**. L'operatore abiliterà il profilo all'uso di MyBank.
Parametri da configurare nel pannello di controllo della banca:
1. **PaymentTypeDetail**
2. **PaymentTypes**
Testing
Per effettuare un test utilizzando il sistema MyBank bisogna prima di tutto inserire un prodotto a carrello e procedere verso il chekout di Magento. Selezionare il metodo di pagamento Banca Sella MyBank
## Visualizzazione della Cache MyBank
Al fine di velocizzare il caricamento della pagina di Checkout di Magento è stata realizzata una cache della lista delle banche aderenti al servizio MyBank. Il modulo controllerà periodicamente se vi sarà una modifica alla lista delle banche rilasciata da Banca Sella. E' possibile impostare un'operazione pianificata Cron direttamente dal pannello di controllo utilizzando la [sintassi cron](http://crontab-generator.org/). E' consigliabile aggiornare la lista almeno una volta al mese. La tabella nel database che mantiene la cache si chiama: "mybank".
# Klarna
**Profilo richiesto**: *Professional o Unlimited*
Klarna, uno dei principali provider di pagamenti digitali, ha annunciato in questi giorni un re-design della propria immagine che punta a “scardinare” il look istituzionale degli operatori finanziari. Klarna è un player a livello globale, attivo in 18 mercati, con 1500 dipendenti, 60 milioni di clienti e 70.000 merchant che utilizzano le sue soluzioni di pagamento.
Uno dei problemi che rallentano l’avanzata dell’e-commerce rimane ancora la diffidenza degli utenti all’acquisto di beni che non possono vedere né toccare con mano. In aiuto arriva l’idea di una startup svedese. Si chiama Klarna, che significa limpido, trasparente, opera nel commercio elettronico in ormai 15 Paesi europei (Italia esclusa, per ora) e promette di diventare un fenomeno globale.
Gli analisti parlano già di un nuovo modello di e-commerce, semplice ma a cui nessuno aveva ancora pensato: consentire al cliente di pagare dopo aver ricevuto la merce. Sia il cliente sia il venditore sono tutelati dall’intermediazione di Klarna, che di fatto si assume tutti i rischi di un’eventuale insolvenza calcolando l’indice di rischio grazie a un algoritmo e negando l’eventuale acquisto nel caso di rischio troppo elevato. Per ogni cliente e ogni nazione esiste un coefficiente di solvibilità: per esempio per la Svezia, patria di Klarna, il coefficiente era molto basso, ma quando la soluzione si è diffusa in Germania gli analisti hanno dovuto tararlo su altri valori, constatando nella nazione tedesca una maggiore frequenze di frodi e truffe. Il software inoltre è capace di vedere se ci sono stati precedenti di quel cliente che ne limitano l’affidabilità e in generale di valutarne la solvibilità. E a quel punto, se non esistono particolari impedimenti, Klarna rischia al posto del venditore, trattenendo ovviamente una percentuale del guadagno in nome del rischio sotto forma di abbonamento.
Dopo aver [creato il proprio Shop Login](/configurazione-gestpay), **bisogna chiedere al reparto tecnico della Banca Sella di attivare l'opzione Klarna**. L'operatore abiliterà il profilo all'uso di Klarna.
## Documentazione
Per conoscere in dettaglio le condizioni per l'uso di Klarna riportiamo il link ufficiale della Banca Sella:
E' possibile un'anteprima video del funzionamento del modulo in un ambiente di test Magento 1.9.3.x al link
## Testing
Per effettuare un test utilizzando il sistema Klarna bisogna prima di tutto inserire un prodotto a carrello e procedere verso il chekout di Magento. Selezionare il metodo di pagamento Banca Sella Klarna.
**Attenzione**: Il servizio Klarna non è disponibile in tutti i paesi ma solamente nei seguenti:
* Austria
* Danimarca
* Finlandia
* Germania
* Olanda
* Norvegia
* Svezia
Un altro parametro da considerare è l'ammontare totale del carrello che **non deve superare 10 EURO**. In tutti gli altri casi, il messaggio Pagamento non effettuato riguarda un problema di configurazione dei parametri o delle funzioni presenti nel profilo di Banca Sella.
E' bene creare un profilo di test che corrisponda alle seguenti caratteristiche:
> Nome: Testperson-se\
> Cognome: Approved\
> Telefono: 0765260000\
> **Social Security Number**: 410321-9202
>
> Indirizzo: Stårgatan 1\
> **Street Number**: 100\
> **House Number**: 10\
> **House Extension**: 1\
> Città: Ankeborg\
> Paese: Svezia
I campi in grassetto vengono generati durante l'installazione del modulo Banca Sella per la gestione del metodo Klarna. Tali campi potrebbero non essere visibili se il template del degli indirizzi è stato sovrascritto da qualche personalizzazione. Contattare il vostro tecnico esperto magento per ulteriori informazioni.
# Testing Mode
## Credenziali & Carte di Credito di Test
La Banca Sella mette a disposizione degli esercenti un accesso diretto ai metodi di pagamento offerti usando delle credenziali di test che permettono di controllare il corretto funzionamento delle varie soluzioni. E' possibile inoltre simulare le transazioni di pagamento in un ambiente protetto ed identico all'ambiente di produzione usando alcune carte di credito di test.
Il modulo per poter funzionare correttamente necessita di un profilo Banca Sella di Test ed un profilo Banca Sella Ufficiale. Per creare un profilo di test basta far click nel presente link: e registrarsi.
I dati necessari per accedere all'area di test di Banca Sella () devono essere:
* **Codice Esercente**
* **Chiave(pin)**
* (Password amministrativa banca sella)
Questi parametri di accesso **saranno inviati via email** dopo la registrazione del profilo.
Vi sono degli accorgimenti da adottare durante le fasi di test:
* non si può testare un modulo con credenziali di test con vere carte di credito finchè non si è in fase di produzione. La fase di produzione viene impostata dalla banca con un nuovo profilo esercente.
* non si può testare il modulo se la banca non riesce a connettersi al dominio in cui è installato il modulo. Il dominio deve essere accessibile pubblicamente.
* L'indirizzo IP del server deve essere registrato nel pannello di configurazione della banca sella
* il negozio Magento deve essere accessibile (frontend) senza password (vedi htpasswd).
## Test Credit Cards
Qui di seguito una lista di carte di credito di prova che permetteranno all'esercente di testare il proprio negozio durante la fase di pagamento delle merci o dei servizi.
1. VISA 4775718800002026 05/27 Always authorize with every amount
2. VISA 4775718800003024 05/27 Always reject: Authorization denied
3. VISA 4012001037141112 05/20 Trx full 3d: the card is enabled and the authentication is OK
4. MASTERCARD 5412388800004012 05/27 Always authorize with every amount
5. MASTERCARD 5412388800006017 05/27 Always reject: Authorization denied
**Mastercard 2 Bin Series**: Vedi sezione [Logging & Debug](/magento-1/l-ogging-and-debug)
## Configurazione per la modalità di TEST
Per impostare il negozio Magento in modalità di test bisogna impostare i seguenti parametri necessari per la connessione corretta al server di test:
1. **ShopLogin:** [Realizzato nel pannello di controllo della Banca Sella](/configurazione-gestpay)
2. **Debug: YES**
## Configurazione per la modalità LIVE
Per impostare il negozio Magento in modalità di LIVE bisogna impostare i seguenti parametri necessari per la connessione corretta al server LIVE:
1. **ShopLogin** (Ufficiale)
2. **Debug: NO**
Attenzione! Se la password risulta scaduta, l'accesso al servizio POS verrà inibito generando un errore di NEGOZIO NON RICONOSCIUTO vedi capitolo: [Logging, Debug, Errori Comuni](https://docs.constriv.shinesoftware.it/logging-and-debug.html)
### Avvertenze
Alcune volte i **server di test** degli istituti di credito (VISA, MASTERCARD, AMERICAN EXPRESS) possono subire delle **modifiche dovute ad aggiornamenti e/o a verifiche** che comportano ad un temporaneo disservizio. Questi comportamenti non devono allarmare l'esercente che potrà in ogni caso rivolgersi per assistenza al servizio tecnico di helpdesk della Banca Sella al numero fisso 0152434640 presentando il proprio ShopLogin e partita iva.[ ](https://docs.setefi.shinesoftware.it/download--installazione.html)
# Common Errors
**Impostazione CSP**
```
shinesoftware.it
```
# Sicurezza e PCI DSS
## Payment Card Industry Data Security Standard (PCI DSS)
La sicurezza è uno degli elementi fondamentali per le vendite a distanza e, in particolare, su Internet, considerata la criticità dei dati trattati. Banca Sella ha da sempre posto una particolare attenzione alla sicurezza nell’erogazione dei propri servizi, come attestato dalle importanti certificazioni ottenute (**PCI-DSS e ISO27001**), e dalla costante attenzione alle normative di sicurezza proposte dai circuiti di pagamento.
Quando viene utilizzata l'estensione di pagamento Banca Sella per Magento, potrebbe essere necessario fornire la certificazione PCI DSS. Le informazioni che vengono trasmesse con tecnologia AJAX, utilizzata dal client API della Banca Sella assicura che il negozio Magento non sia a diretto contatto con i dati relativi alla carta di credito, perchè il cliente trasferirà i dati relativi alla carta di credito direttamente dal suo client a Banca Sella.
## Sicurezza
La piattaforma “Payment Gateway” rende disponibili alle Aziende operanti in Internet, i più aggiornati protocolli di autenticazione proposti dai circuiti internazionali: **Verified by VISA** e **MasterCard SecureCode**, uniti alla verifica del codice di controllo presente sulla carta. L’utilizzo di questi protocolli tutela l’Azienda venditrice dal disconoscimento delle transazioni da parte del titolare della carta di credito o prepagata, garantendo, nella maggior parte dei casi, il buon esito del pagamento.
# Versioni & Changelog
In questa pagina racchiudiamo tutte le modifiche effettuate al modulo e dei suoi sottomoduli ed i loro rilasci. La versione del proprio modulo è visibile nella sezione in alto del pannello di configurazione dei metodi di pagamento:
> Are you ready to use the Banca Sella payment **v.2.0.0.0** method? Click here to learn more.
La versione del sotto-modulo si trova al fianco del nome. Ecco uno screenshot della sezione precedentemente indicata:\
**Attenzione**: Il modulo è in continua evoluzione e per questo motivo vi invitiamo a seguirci su Twitter ed a pubblicare una recensione al primo utilizzo per ricevere oltretutto uno sconto alla scadenza dell'assistenza tecnica direttamente al link:.
## Versioni
Magento è in continua evoluzione così come le estensioni realizzate dalla Shine Software. Le funzionalità vengono analizzate, programmate, sviluppate e testate. Di seguito le funzionalità esposte dal metodo di pagamento ed integrate nelle versioni di Magento.
| Funzionalità | Magento 1.9.x | Magento > 2.x |
| ---------------- | ------------- | ------------- |
| Hosted 3D Secure | Incluso | Incluso |
| MyBank | Incluso | Incluso |
| Masterpass | Incluso | Incluso |
| Alipay | Incluso | Incluso |
| Klarna | Incluso | |
| Paypal | Incluso | Incluso |
| Wallet | Incluso | |
# Copyright
L'importanza della sicurezza in ambito informatico commerciale è fondamentale in questi contesti poichè i moduli di pagamento trasmettono dati sensibili dal negozio verso il server della banca e viceversa. A tal fine tutti il codice del modulo Banca Sella non è leggibile e/o decodificabile senza ledere la proprietà intellettuale e la licenza commerciale ed incorrere a malfunzionamenti imprevisti. A tal fine la Shine Software si impegna a supportare tecnicamente gli esercenti ed i tecnici per eventuali nuovi aggiornamenti e/o nuove funzionalità.
Il Cliente si impegna a difendere, risarcire e tenere indenni la Shine Software, i suoi impiegati, sub-contraenti, agenti ed associali, da qualunque ed ogni responsabilità, costi e spese, comprese ragionevoli spese legali, inerenti o dovuti a:
* qualunque inadempimento da parte del Cliente;
* uso improprio del servizio di POS Virtuale;
* atti o omissioni del Cliente (o di terzi usati dal Cliente) in rapporto all'installazione, manutenzione, presenza, uso o rimozione del modulo di pagamento;
* qualunque rivendicazione da parte di terzi che comunque derivi dai servizi che saranno forniti dal Cliente a terzi;
* azioni per violazione di qualunque diritto di proprietà appartenente a terzi, compresi diritti d'autore, brevetti, segreti industriali e marchi, causata dall'uso di qualunque servizio, apparecchiatura e software non forniti da Shine Software oppure dall'uso scorretto di servizi, di apparecchiature o software forniti da Shine Software;
* qualunque perdita o danno a qualunque proprietà, o lesione personale o morte di qualunque persona, dovuti ad atto volontario o omissione del Cliente, di suoi impiegati, sub-contraenti o agenti.