# Introduzione
Il modulo MonetaWeb di Setefi per [Magento](http://www.shinesoftware.it/wiki/magento-cos-e-magento.html#.WHf8JLbhAmI) è un software per le transazioni di pagamento online che sfrutta un Pos Virtuale gestito da Mercury UK Holdco Limited e sviluppato da SETEFI S.p.A e permette agli esercenti che possiedono un negozio on line [Magento](http://www.shinesoftware.it/wiki/magento-cos-e-magento.html#.WHf8JLbhAmI) di poter eseguire le transazioni di pagamento. E' possibile richiedere l'attivazione dal portale istituzionale o tramite una filiale del gruppo Intesa San Paolo.
### Introduzione
La società nasce con il nome di **Servizi Telematici Finanziari** per il Terziario - Setefi S.p.A. nel 1988 da un'iniziativa di Cariplo (35%), Banca di Roma (35%) e Finater (la finanziaria di Confcommercio, al 30%) scon l'intento di sviluppare un nuovo sistema di pagamento elettronico, promuovere una carta nazionale dei commercianti e ridurre le commissioni per gli esercenti.
Nel maggio del 2016 Mercury UK Holdco Limited, azionista di maggioranza dell'Istituto Centrale delle Banche Popolari Italiane, ha firmato un accordo definitivo per l'acquisizione di Setefi Services e Intesa Sanpaolo Card da Intesa Sanpaolo per un controvalore di un miliardo e 35 milioni di euro. Setefi Processing è la piattaforma italiana di processing di Intesa Sanpaolo, uno dei principali gruppi bancari in Europa e la prima banca commerciale italiana. Intesa Sanpaolo Card, invece, è la piattaforma di processing del gruppo per l'Europa centro-orientale e opera in nove paesi, tra cui Croazia, Slovenia, Ungheria e Romania. Insieme, le due piattaforme supportano un portafoglio completo di prodotti che comprende un'ampia gamma di carte di pagamento per i clienti finali di Intesa Sanpaolo.
## Banche aderenti a SETEFI & Mercury Payments
1. Intesa Sanpaolo Rete Banca Intesa (reti Banca Commerciale Italiana, Cariplo, Banco Ambrosiano Veneto)
2. Cassa di Risparmio di Parma e Piacenza
3. Banca Popolare FriulAdria
4. Banca di Trento e Bolzano
5. Cassa di Risparmio di Ascoli Piceno
6. Cassa di Risparmio della Provincia di Viterbo
7. Cassa di Risparmio di Foligno
8. Cassa di Risparmio di Spoleto
9. Cassa di Risparmio di Città di Castello
# 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.
# 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.
### Cattura
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. Lo storno può essere fatto anche parzialmente fino al raggiungimento dell'importo pagato dal 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.
# 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](/logging-debug-ed-errori-comuni)).
# Servizi Offerti
SETEFI 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 nella quale non viene richiesta l’autenticazione 3DSecure del titolare. che consente la richiesta diretta di addebito. Una soluzione su misura per ogni esercente.
* Hosted 3D Secure
* MyBank
* Masterpass Wallet
* Paypal
* Alipay Digital Wallet
* Server to Server 3D Secure
* Mo.To (Mail Order / Telephone Order)
**Opzioni**
* Pagamenti Ricorrenti con Wallet/Token
# Caratteristiche
Nato per le PMI il modulo SETEFI si è evoluto nel tempo offrendo alla clientela, sempre più esigente, un modo sempre più completo per effettuare i pagamenti nel proprio negozio online. Il modulo di pagamento è stato sviluppato per gestire in modo semplice l'integrazione con i vari servizi offerti dalla SETEFI. Dalla semplice soluzione Hosted 3D Secure alle più complesse ed estese soluzioni di pagamento. L'integrazione profonda con Magento permette il pieno controllo delle transazioni di pagamento nonchè delle transazioni on line presenti nei server della SETEFI.
Chi sceglie MonetaWeb avrà i seguenti benefici:
* Facilità di integrazione
* Flessibilità
* Gestione dei pagamenti online attraverso i principali circuiti internazionali. Potrà essere valutata, su richiesta del Cliente, un'eventuale estensione ai circuiti American Express, Diners e JCB;
* Sicurezza, grazie al rispetto degli standard di sicurezza definiti dai circuiti internazionali sul (Verified by Visa e Secure Code per il circuito Mastercard);
* Trasparenza , perché alla tradizionale rendicontazione cartacea si affianca una rendicontazione on line tramite il sito MonetaWeb 2.0 è una piattaforma di pagamento elettronico che mette a disposizione dei clienti una suite di protocolli e un set di metodi di pagamento a seconda delle specifiche esigenze.
Tutte le trasmissioni di dati sensibili che coinvolgano il commerciante, i sistemi di Setefi e il cliente finale, sono crittografate secondo il protocollo HTTPS, in linea con gli standard di sicurezza imposti dai Circuiti Internazionali. I Sistemi Setefi sono inoltre sottoposti a verifiche di sicurezza periodiche e costantemente aggiornati per garantire la protezione da eventuali vulnerabilità rilevate a carico dei protocolli standard.
# Generale
Il modulo di pagamento SETEFI per Magento consente di integrare in Magento dalla versione 1.9 la piattaforma di Moneta On Line Setefi al fine di offrire un sistema sicuro ed automatizzato di tutti i pagamenti processati. L'estensione supporta più di 10 tipi differenti metodi di pagamento offrendo un'integrazione ai sistemi di rischio per minimizzare i problemi dovuti alle transazioni di pagamento.
L'estensione si adatta al sistema integrato del negozio Magento 1 e Magento 2. Una certificazione relativa al Payment Card Industry Data Security Standard (PCI DSS) non è richiesta per le transazioni di pagamento con questa estensione. L'area di amministrazione di Magento offre una facile configurazione e amministrazione delle opzioni. Tutte le funzioni dell'estensione possono essere configurate per ogni singola esigenza di ogni singolo esercente. Il modulo SETEFI è stato sviluppato da programmatori certificati Magento & Zend Framework (framework di base del software). Questa estensione viene continuamente aggiornata seguendo gli aggiornamenti del POS Virtuale offerto dalla Mercury Ltd.
# Specifiche funzionali
## Pagamenti Supportati
Questa estensione supporta i seguenti metodi di pagamento attraverso la piattaforma messa a disposizione da SETEFI.
* VISA
* MASTERCARD
* VISA ELECTRON
* JBC
* American Express
* Diners Club
* Maestro
## Procedure di sicurezza supportate
* Verify By VISA
* Mastercard SecureCode
## Bonifici Online
* MyBank
## Portafogli Digitali (Digital Wallet)
* Paypal
* Alipay
* MonetaOnLine
* Masterpass
* Token (Magento 2.x)
## 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 SETEFI. Il cliente non noterà tale processo. Per i pagamenti con carta di credito, i dati sono trasferiti via API fornite da SETEFI attraverso tutta la fase di checkout dell'ordine per controllare e salvare le informazioni sensibili nei server della SETEFI con connessione sicura. Lo stato delle transazioni vengono inviate dalla SETEFI in un secondo momento, aggiornando lo status corrente dell'ordine mantenendo una sincronia fra i due sistemi (banca/magento).
## Payment Card Industry Data Security Standard (PCI DSS)
Quando viene utilizzata l'estensione di pagamento SETEFI per Magento, non è necessario fornire la certificazione PCI DSS. Le informazioni che vengono trasmesse con tecnologia AJAX, utilizzata dal client API della SETEFI 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 SETEFI. Le varie integrazioni offerte da SETEFI consentono un pieno controllo della sicurezza delegando proprio a quest'ultima la responsabilità della raccolta delle informazioni sensibili (Hosted Solution 3DSecure). Durante tale procedura, al cliente cliente verrà richiesta l'immissione del numero di carta di credito nel sito protetto della banca.
## Logging & Debug
Qualsiasi comunicazione con SETEFI 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 SETEFI ed i dati dei processi di pagamento integrati in cui viene richiesta la carta di credito sono esclusi da questo log.
## Configurazione e gestione delle opzioni dell'estensione
L'estensione offre un nuovo menù SETEFI nell'are amministrativa di Magento. 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.
# Requisiti Minimi
Negozio **Magento**:
* Magento CE > 1.9.3
* Magento CE > 2.1.x
**Estensioni richieste nel server:**
* simplexml
* mcrypt
* hash
* GD
* DOM
* iconv
* curl
* SOAP (per Webservices API)
# Configurazione Generale
## Impostazione dei cronjob
Al termine di una transazione di pagamento per un dato ordine, il modulo di pagamento prevede un continuo scambio di informazioni via API fra il negozio Magento e SETEFI che determinano lo status del pagamento. Per attivare tale funzionalità bisogna impostare il cronjob di Magento. Si consiglia di contattare il vostro servizio hosting.
Tale sezione, presente in tutti i metodi di pagamento, offre la possibilità di controllare lo status dell'ordine impostando semplicemente un cronjob. Il sistema recupera tutti gli ordini del tipo setefi\_\[method] e che hanno uno status "pending" ed interroga il server SETEFI per controllarne lo status sui server della banca.
Qualora l'ordine non sia stato pagato, lo status di quest'ultimo verrà impostato come cancellato. In caso contrario verranno indicate nelle note dell'ordine le informazioni ricevute dalla banca.
In ogni caso controllare sempre il file di log che contiene tutte le informazioni di ogni singola richiesta effettuata al server della SETEFI.
Per maggiori informazioni bisogna fare riferimento al [manuale Magento](http://devdocs.magento.com/guides/m1x/install/installing_install.html#install-cron).
# Magento 1
## Menu di Amministrazione
Per poter accedere alla sezione di configurazione del modulo SETEFI bisogna accedere all'area amministrativa di Magento protetta da password.
Dopo aver avuto accesso si potrà notare una nuova voce nel menù amministrativo di Magento come da foto:
## Pannello di Configurazione Soluzioni SETEFI
Il pannello di configurazione delle soluzioni di pagamento della SETEFI si mostra molto complesso a prima vista poiché le soluzioni di pagamento offerte sono moltissime. Il software Magento integra perfettamente tali soluzioni offrendo un metodo di visualizzazione delle configurazioni diviso in pannelli annidati.
# Magento 2
## Menu di Amministrazione
Per poter accedere alla sezione di configurazione del modulo bisogna accedere all'area amministrativa di Magento protetta da password.
Dopo aver avuto accesso si potrà notare a piè di pagina un link che indica **Powered by Mercury Payments**. Tale link invia l'esercente alla pagina dei metodi di pagamento. E' possibile accedere alla pagina dei metodi di pagamento anche attraverso il percorso: Store > Configuration > Sales > Payment Methods\
## Pannello di Configurazione Soluzioni
Il pannello di configurazione delle soluzioni di pagamento della SETEFI si mostra molto complesso a prima vista poiché le soluzioni di pagamento offerte sono moltissime. Il software Magento integra perfettamente tali soluzioni offrendo un metodo di visualizzazione delle configurazioni diviso in pannelli annidati.
# Magento 1
Dopo aver acquistato il modulo di pagamento riceverete il file compresso che contiene il modulo via email. Decomprimete il file ricevuto nel vostro computer ed inviate il contenuto della cartella scompattata, all'infuori del file di pdf, nella cartella di **root del vostro sito internet** via [FTP](https://it.wikipedia.org/wiki/File_Transfer_Protocol). 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** > **Setefi**
* Se si era già connessi nell'area amministrativa di magento disconnettersi e rieffettuare il login.
## Aggiornamento del modulo
Il nuovo modulo ufficiale della SETEFI 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 i file dentro la cartelle:
* /app/code/community/ShineSoftware
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 '%setefi%';
Se non si aggiornano anche i records collegati al metodo di pagamento si rischia un errore nella griglia ordini. Per far conoscere a Magento che il modulo è stato modificato eseguire la seguente query:
> UPDATE sales\_flat\_order\_payment set method = 'setefi\_hosted' WHERE method = 'setefi\_cc';
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.
## Permessi di Files e Cartelle
I permessi dei files e delle cartelle del modulo di pagamento devono seguire lo standard richiesto da Magento. L'utente proprietario dei files e delle cartelle deve essere lo stesso utente usato dal webserver (Apache / nGinx). Quindi, tranne nel caso in cui si effettua l'upload usando delle credenziali differenti da un utente riconosciuto dal sistema come proprietario del progetto del vostro negozio, non si dovranno impostare dei permessi specifici dopo il caricamento del modulo via FTP. Ad ogni modo i permessi da adottare per un progetto Magento sono ampiamente discussi nel sito internet della [Magento](http://devdocs.magento.com/guides/m1x/install/installer-privileges_after.html).
## Compilazione
Se il negozio magento ha la funzionalità di compilazione attivata, bisognerà ricompilare il codice e fare attenzione durante la compilazione affinchè tutti i file richiesti dal modulo siano stati correttamente spostati nella cartella /includes
## Configurazione & Cache
Durante la fase di configurazione, **Magento potrebbe ripresentare i vecchi dati di configurazione**. Bisogna fare molta attenzione alla Cache di Magento che mantiene tutti i dati di configurazione. Anche se il sistema presenta la gestione Cache disabilitata è consigliato un aggiornamento.
# Magento 2
Descrizione delle impostazioni generiche sul modulo che lo distinguono dalla versione per Magento 1
Installare il modulo SETEFI Mercury Payments nel vostro negozio Magento 2 è molto semplice ma bisogna tener presente alcuni passi necessari.
# Installazione
{% hint style="info" %}
Prima di ogni installazione e modifica strutturale di Magento, **è caldamente consigliato effettuare un backup dei dati e dei files** ed accertarsi di aver effettuato un backup corretto. Solo dopo tale operazione potrete effettuare l'**installazione prima nel vostro ambiente di sviluppo** e successivamente nel vostro ambiente di produzione.
{% endhint %}
### Installazione via Shell
Se si desidera installare il modulo via shell bisogna eseguire il seguente comando dalla root di Magento.
```
composer config repositories.core vcs git@bitbucket.org:shinesoftware/core.git
composer config repositories.mercury vcs git@bitbucket.org:shinesoftware/mercury.git
composer require shinesoftware/core:dev-master
composer require shinesoftware/mercury: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 %}
> Dopo aver copiato la chiave pubblica dovrete aprire una segnalazione su e richiederne la registrazione per il dominio indicato in fase di acquisto.
# 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/mercury
composer config --unset repositories.mercury
```
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 %}
# 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.
*I file template di successo e di fallimento vengono sovrascritti. Qualora vi fossero delle funzionalità integrate direttamente nei file di template delle suddette pagine, bisogna controllare se il metodo di "innesto" del codice personalizzato rispetti il sistema di layout di Magento. Se, ad esempio, un codice javascript **è stato "incollato" all'interno del template** della pagina di successo e/o fallimento del proprio tema/template, bisogna correggerne il metodo di inserimento via blocchi creando un'apposita estensione, così come indicato dalle linee guida di innesto dei blocchi statici di Magento.*
In questi casi basterebbe un controllo approfondito del template Magento accertandosi della correttezza delle path usate nel caricamento del layout.
## 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#).
# Negozi Multivaluta
Magento consente di gestire un negozio multi-valuta. Il modulo di pagamento consente di utilizzare una valuta differente dall'Euro durante la transazione sulla base delle specifiche della banca. All'interno del **pannello di controllo del negozio Magento** bisogna **impostare la valuta di base** che verrà presa come riferimento dal modulo per tutte le transazioni che avverranno nel negozio.
Il negozio può gestire anche più di 10 valute ma le valuta della transazione deve rientrare all'interno della lista proposta dalla banca.
Il POS SETEFI consente i pagamenti nelle seguenti valute:
* Euro
* Dollaro Statunitense
* Franco Svizzero
* Sterlina Inglese
Qualora il modulo non trovi una delle suddette valute impostate come valuta di base per i calcoli in Magento, **la valuta di default sarà l'Euro**.
**Attenzione**: Durante la fase di testing tale funzionalità è inibita. Solamente in produzione sarà possibile utilizzare valute differenti dall'Euro.
# Lingue & Traduzioni
per modificare la lingua in un negozio multiview dovreste impostare le varie view alle lingue presenti in Magento.
Ad esempio:
* Store A
* Italiano (View)
* Locale Italiano (Italia)
* Inglese (View)
* Locale English (United States)
In questo modo quando gli utenti selezioneranno la versione italiana o inglese il modulo riconoscerà la lingua assegnata alla view.
Ecco un esempio relativo all'impostazione della lingua inglese per la view dedicata alla versione inglese del negozio.
## Come tradurre il testo contenuto dentro il modulo?
Il modulo offre una traduzione in Italiano ed in Inglese utilizzando un file csv contenuto dentro la cartella app/locale/it\_IT/Shinesoftware\_NomeModulo.csv (magento 1.9.x) e app/code/Shinesoftware/NOME-MODULO/i18n/en\_US.csv (versione inglese per Magento 2.x).
Per aggiungere una lingua e/o aggiungere delle traduzioni basta creare/modificare i seguenti files:
* app/code/Shinesoftware/NOME-MODULO/i18n/**it\_IT**.csv (magento 2.x)
* app/locale/**it\_IT**/Shinesoftware\_NomeModulo.csv (Magento 1.9.x)
Per creare il file serve un semplice editor di testo come il blocco note di Windows o TextWrangler per Mac. Il file deve essere caricato sul server nella posizione su indicata. Il testo da tradurre deve essere così composto:
> "This text must be translated", "Questo testo deve essere tradotto"
Bisogna fare attenzione alle virgolette ed alla virgola separatrice. Ogni frase deve essere racchiusa fra le virgolette e separata con la virgola. Ogni frase deve essere su inserita in una linea differente.
Al termine dell'operazione bisogna aggiornare la cache di Magento.
Il testo da tradurre si trova sempre dentro i files .phtml a vostra disposizione dentro le seguenti percorsi:
* app/code/Shinesoftware/NOMEMODULO/view/frontend/templates/...
* app/design/frontend/base/default/template/NOMEMODULO/...
Aprire i file con un editor di testo e recuperare il testo da tradurre copiandolo nel file csv che avete precedentemente creato. Ad esempio, in un file \*.phtml di un modulo per Magento 1.9.x potreste trovare:
> \\_\_("If you are the store owner check the log files in your Magento store and contact the bank helpdesk") ?>
e nella versione Magento 2.x potreste trovare:
> \\_\_("If you are the store owner check the log files in your Magento store and contact the bank helpdesk.") ?>
Per tradurre le suddette frasi bisogna recuperare solamente ciò che appare fra le virgolette:
* If you are the store owner check the log files in your Magento store and contact the bank helpdesk
e riportare la frase nel file csv precedentemente creato:
> "If you are the store owner check the log files in your Magento store and contact the bank helpdesk.", "Se sei il proprietario del negozio controlla i file di log nel tuo negozio Magento e contatta il supporto della banca"
Come detto in precedenza, dopo aver caricato il file nella stessa posizione sul server, bisogna aggiornare la cache di magento e la traduzione apparirà.
Qualora non doveste riuscire a tradurre qualcosa, potete richiedere il servizio [Programmatore Magento](https://shinesoftware.it/programmatore-magento.html), ed un nostro tecnico creerà l'integrazione per voi.
# Soluzioni di Pagamento
La SETEFI offre una servizio di pagamento chiamato MonetaWeb. MonetaWeb è un POS virtuale di ultima generazione progettato per chi, tramite un sito internet, vuole vendere merci o servizi gestendo i pagamenti on line con carta di credito.
Chi sceglie MonetaWeb avrà i seguenti benefici:
* Facilità di integrazione
* Flessibilità
* Gestione dei pagamenti online attraverso i principali circuiti internazionali. Potrà essere valutata, su richiesta del Cliente, un'eventuale estensione ai circuiti American Express, Diners e JCB;
* Sicurezza, grazie al rispetto degli standard di sicurezza definiti dai circuiti internazionali sul (Verified by Visa e Secure Code per il circuito Mastercard);
* Trasparenza , perché alla tradizionale rendicontazione cartacea si affianca una rendicontazione on line tramite il sito MonetaWeb 2.0 è una piattaforma di pagamento elettronico che mette a disposizione dei clienti una suite di protocolli e un set di metodi di pagamento a seconda delle specifiche esigenze.
Tutte le trasmissioni di dati sensibili che coinvolgano il commerciante, i sistemi di Setefi e il cliente finale, sono crittografate secondo il protocollo HTTPS, in linea con gli standard di sicurezza imposti dai Circuiti Internazionali. I Sistemi Setefi sono inoltre sottoposti a verifiche di sicurezza periodiche e costantemente aggiornati per garantire la protezione da eventuali vulnerabilità rilevate a carico dei protocolli standard.
## Tipologie di connessioni
Setefi supporta molti tipi di pagamenti in una sola piattaforma. (vedi Servizi Offerti) Tali servizi, per poter essere attivati necessitano delle credenziali rilasciate dalle rispettive banche appartenenti alla SETEFI. Qui di seguito verranno mostrati i servizi per i quali si richiede un'autenticazione:
* Hosted 3D Secure
* MyBank
* Masterpass Wallet
* Paypal
* Alipay Digital Wallet
* Server to Server 3D Secure
* Mo.To (Mail Order / Telephone Order)
Se non si possiede già un account SETEFI, contattate il supporto bancario di riferimento. Per poter testare i vari metodi di pagamento potete utilizzare delle credenziali di test che aiuteranno a capire meglio quale soluzione è più adatta alle vostre esigenze.
# Hosted 3D Secure
Hosted 3DSecure prevede la possibilità di poter effettuare pagamenti in modalità sicura in tutte le fasi della transazione; infatti il protocollo permette di transare in rispetto dei più recenti protocolli di protezione (Verified by VISA e MasterCard SecureCode),che garantiscono la non ripudiabilità della maggior parte delle transazioni, e degli standard di sicurezza PCI (Payment Card Industry) DSS (Data Security Standards).
La pagina di pagamento di MonetaWeb è disponibile in versione Web o Mobile con riconoscimento automatico del device chiamante.
I sistemi operativi mobile supportati sono:
* iOS per iPad e iPhone delle versioni a partire dalla 4
* Android per dispositivi con versione 4 e successive
* Windows Phone per le versioni a partire dalla 7
## Configurazione
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Setefi > Configuration > Hosted 3D Secure. Il pannello di controllo del metodo Hosted 3D Secure si presenterà come da foto.
Nel pannello di controllo del metodo di pagamento selezionato vi sono tre sotto sezioni che consentono 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
* System Settings
Per poter utilizzare il metodo di pagamento Hosted 3D Secure 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.
## 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 | |
| ---------------- | ----------------------------------------------------- |
| New Order Status | Status iniziale dell'ordine prima del pagamento |
| Debug | Se vero, imposta il pos in modalità di test |
| Payment Method | Implicit / Explicit (vedi sez. Metodo di Pagamento) |
| Password | Credenziali fornite dalla banca |
| ID | 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.
| | |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 |
| Checkout option description | Descrizione pubblica del metodo di pagamento. |
| Forced Void Authorization | Rilascio forzato del platfond bloccato durante l'autorizzazione della transazione cliente in caso di annullamento |
| Payment description | Descrizione personalizzata presentata durante la transazione di pagamento a SETEFI. Se non impostata, verrà indicata una descrizione generica. |
| Auto Invoice | Fatturazione automatizzata e cattura diretta dell'importo . |
## System Settings
La sotto sezione "Impostazioni di Sistema" permette di controllare alcune opzioni a basso livello della comunicazione fra il modulo ed i server della SETEFI.
| | |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| TLSv1 Security | Abilita o disabilita la connessione via TLS utilizzata dal componente cURL. (vedi [specifiche funzionali](/specifiche-funzionali)) |
| Payment Cron Inquiry | Frequenza di richiesta di aggiornamento dello status dell'ordine inviato alla SETEFI |
## Integrazione
Il metodo di pagamento Hosted 3D Secure si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di controllare le transazioni di pagamento direttamente dallo stesso pannello di ordini.
# Notifica di Pagamento Hosted 3D
A fronte del corretto inserimento dei dati della carta di credito da parte del titolare, il pagamento viene processato da MonetaWeb e viene fornita al Commerciante una notifica dell’esito del pagamento stesso.
La notifica viene effettuata tramite una chiamata da parte del server della SETEFI. Tra i vari parametri ricevuti, vi è il securityToken rappresentato da una stringa di sicurezza generata da MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase di notifica dell’esito; per scopi di sicurezza, il modulo SETEFI verifica che il valore del securityToken ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente l’esito della transazione, il modulo risponde al messaggio di notifica, appena ricevuto da Monetaweb, con l’url della propria pagina di esito associando i parametri richiesti come il "paymentid".
**Attenzione**: una volta instaurata la connessione, i server della SETEFI attendono per 20 secondi di ricevere in risposta la URL per la redirezione finale. Allo scadere del timeout, la richiesta viene abbandonata. A tal proposito il frontend del negozio Magento **deve essere pubblicato ed accessibile da remoto senza alcuna password** di visualizzazione.
*Nel caso in cui il negozio sia protetto da un certificato self-signed o emesso da CA secondarie, è necessario fornire al supporto di MonetaWeb la catena completa in formato PEM codificati X509, pena, il fallimento della notifica dell'esito. Per eventuali import in ambiente di PRODUZIONE l'intervento andrà programmato con almeno un mese di anticipo.*
# MyBank (SEPA Credit Transfer)
MyBank è un servizio di pagamento online promosso da Eba Clearing e sostenuto dalle principali banche europee, tra cui Intesa Sanpaolo.
MyBank è una soluzione ideata per facilitare l’uso online degli strumenti di pagamento SEPA nelle operazioni di eCommerce ed e-government. Si basa su una modalità operativa che veicola le autorizzazioni elettroniche (e-authorization), relative ai pagamenti per l’e-commerce, tramite lo schema SEPA Credit Transfer.
MyBank consente al venditore online di avere subito la conferma dell’ordine di bonifico. I dettagli del pagamento relativo all'acquisto saranno automaticamente visualizzati sul sistema di online banking della propria banca e il cliente potrà confermare i dettagli della transazione autorizzando il bonifico. L’autorizzazione elettronica del cliente compratore sarà considerata irrevocabile consentendo da subito la spedizione della merce o la prestazione del servizio.
## Configurazione
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Setefi > Configuration > MyBank. Il pannello di controllo del metodo MyBank si presenterà come da foto.
Nel pannello di controllo del metodo di pagamento selezionato vi sono tre sotto sezioni che consentono 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
* System Settings
Per poter utilizzare il metodo di pagamento MyBank 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.
## 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 | |
| ---------------- | ----------------------------------------------------- |
| New Order Status | Status iniziale dell'ordine prima del pagamento |
| Debug | Se vero, imposta il pos in modalità di test |
| Payment Method | Implicit / Explicit (vedi sez. Metodo di Pagamento) |
| Password | Credenziali fornite dalla banca |
| ID | 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.
| | |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 |
| Checkout option description | Descrizione pubblica del metodo di pagamento. |
| Forced Void Authorization | Rilascio forzato del platfond bloccato durante l'autorizzazione della transazione cliente in caso di annullamento |
| Payment description | Descrizione personalizzata presentata durante la transazione di pagamento a SETEFI. Se non impostata, verrà indicata una descrizione generica. |
| Auto Invoice | Fatturazione automatizzata e cattura diretta dell'importo . |
## System Settings
La sotto sezione "Impostazioni di Sistema" permette di controllare alcune opzioni a basso livello della comunicazione fra il modulo ed i server della SETEFI.
| | |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| TLSv1 Security | Abilita o disabilita la connessione via TLS utilizzata dal componente cURL. (vedi [specifiche funzionali](/specifiche-funzionali)) |
| Payment Cron Inquiry | Frequenza di richiesta di aggiornamento dello status dell'ordine inviato alla SETEFI |
## Integrazione
Il metodo di pagamento MyBank si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di controllare le transazioni di pagamento direttamente dallo stesso pannello di ordini.
# Notifica di Pagamento MyBank
Una volta autenticatosi sull'home banking, il pagatore troverà un bonifico SEPA precompilato che potrà confermare. Ricevuto l'esito del bonifico dalla Banca, il pagatore, per proseguire, dovrà cliccare il pulsante predisposto dalla Banca e sarà rediretto su una pagina di transizione di MonetaWeb. A questo punto viene fornita al Commerciante una notifica dell’esito del pagamento stesso.
La notifica viene effettuata tramite una chiamata da parte del server della SETEFI. Tra i vari parametri ricevuti, vi è il securityToken rappresentato da una stringa di sicurezza generata da MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase di notifica dell’esito; per scopi di sicurezza, il modulo SETEFI verifica che il valore del securityToken ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente l’esito della transazione, il modulo risponde al messaggio di notifica, appena ricevuto da Monetaweb, con l’url della propria pagina di esito associando i parametri richiesti come il "paymentid".
**Attenzione**: una volta instaurata la connessione, i server della SETEFI attendono per 20 secondi di ricevere in risposta la URL per la redirezione finale. Allo scadere del timeout, la richiesta viene abbandonata. A tal proposito il frontend del negozio Magento **deve essere pubblicato ed accessibile da remoto senza alcuna password** di visualizzazione.
*Nel caso in cui il negozio sia protetto da un certificato self-signed o emesso da CA secondarie, è necessario fornire al supporto di MonetaWeb la catena completa in formato PEM codificati X509, pena, il fallimento della notifica dell'esito. Per eventuali import in ambiente di PRODUZIONE l'intervento andrà programmato con almeno un mese di anticipo.*
# Masterpass
MasterPass è la soluzione interoperabile per lo shopping online offerta da MasterCard che consente di fare acquisti in modo semplice, rapido e sicuro. Attraverso MasterPass il cliente avrà accesso ai wallet esposti dai principali Istituti Bancari.
1. Il titolare della carta effettua un acquisto sul sito del Commerciante, scegliendo MasterPass come strumento di pagamento;
2. Una volta autenticatosi nel wallet abilitato Masterpass il cliente visualizza il riepilogo dell' acquisto, sceglie la carta con cui pagare ed effettua il checkout.
3. Il cliente viene reindirizzato nel sito del Commerciante
## Configurazione
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Setefi > Configuration > MasterPass. Il pannello di controllo del metodo MasterPass si presenterà come da foto.
Nel pannello di controllo del metodo di pagamento selezionato vi sono tre sotto sezioni che consentono 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
* System Settings
Per poter utilizzare il metodo di pagamento Masterpass Wallet 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.
## 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 | |
| ---------------- | ----------------------------------------------------- |
| New Order Status | Status iniziale dell'ordine prima del pagamento |
| Debug | Se vero, imposta il pos in modalità di test |
| Payment Method | Implicit / Explicit (vedi sez. Metodo di Pagamento) |
| Password | Credenziali fornite dalla banca |
| ID | 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.
| | |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 |
| Checkout option description | Descrizione pubblica del metodo di pagamento. |
| Forced Void Authorization | Rilascio forzato del platfond bloccato durante l'autorizzazione della transazione cliente in caso di annullamento |
| Payment description | Descrizione personalizzata presentata durante la transazione di pagamento a SETEFI. Se non impostata, verrà indicata una descrizione generica. |
| Auto Invoice | Fatturazione automatizzata e cattura diretta dell'importo . |
## System Settings
La sotto sezione "Impostazioni di Sistema" permette di controllare alcune opzioni a basso livello della comunicazione fra il modulo ed i server della SETEFI.
| | |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| TLSv1 Security | Abilita o disabilita la connessione via TLS utilizzata dal componente cURL. (vedi [specifiche funzionali](/specifiche-funzionali)) |
| Payment Cron Inquiry | Frequenza di richiesta di aggiornamento dello status dell'ordine inviato alla SETEFI |
## Integrazione
Il metodo di pagamento Masterpass Wallet si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di controllare le transazioni di pagamento direttamente dallo stesso pannello di ordini.
# Notifica di pagamento Masterpass
A fronte del corretto inserimento dei dati della carta di credito da parte del titolare, il pagamento viene processato da MonetaWeb e viene fornita al Commerciante una notifica dell’esito del pagamento stesso.
La notifica viene effettuata tramite una chiamata da parte del server della SETEFI. Tra i vari parametri ricevuti, vi è il securityToken rappresentato da una stringa di sicurezza generata da MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase di notifica dell’esito; per scopi di sicurezza, il modulo SETEFI verifica che il valore del securityToken ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente l’esito della transazione, il modulo risponde al messaggio di notifica, appena ricevuto da Monetaweb, con l’url della propria pagina di esito associando i parametri richiesti come il "paymentid".
**Attenzione**: una volta instaurata la connessione, i server della SETEFI attendono per 20 secondi di ricevere in risposta la URL per la redirezione finale. Allo scadere del timeout, la richiesta viene abbandonata. A tal proposito il frontend del negozio Magento **deve essere pubblicato ed accessibile da remoto senza alcuna password** di visualizzazione.
*Nel caso in cui il negozio sia protetto da un certificato self-signed o emesso da CA secondarie, è necessario fornire al supporto di MonetaWeb la catena completa in formato PEM codificati X509, pena, il fallimento della notifica dell'esito. Per eventuali import in ambiente di PRODUZIONE l'intervento andrà programmato con almeno un mese di anticipo.*
# Paypal
Paypal è un servizio di trasferimento di denaro nato proprio per rendere più sicure le transazioni online sia per i compratori, sia per i venditori. E’ possibile spedire e ricevere denaro in tutta sicurezza non fornendo i numeri della carta di credito ma solamente l’indirizzo e-mail.
Cliccando su [Guida PayPal](https://www.monetaonline.it/monetaweb/static/Resources/PayPal-Setefi.pdf) è possibile scaricare la guida contenente le indicazioni per la configurazione del profilo e la pubblicazione del pulsante di pagamento, attività propedeutiche all'integrazione con Setefi MonetaWeb.
1. Il titolare carta effettua un acquisto sul sito del Commerciante, scegliendo PayPal come strumento di pagamento
2. Il modulo inizializza il pagamento verso PayPal
3. Il titolare carta inserisce le proprie credenziali PayPal, sceglie lo strumento di pagamento e l'eventuale indirizzo di spedizione e autorizza il pagamento.
4. Paypal redirige il titolare carta verso la pagina con la visualizzazione dell'esito finale.
## Configurazione
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Setefi > Configuration > Paypal. Il pannello di controllo del metodo Paypal si presenterà come da foto.
Nel pannello di controllo del metodo di pagamento selezionato vi sono tre sotto sezioni che consentono 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
* System Settings
Per poter utilizzare il metodo di pagamento Paypal Wallet 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.
## 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 | |
| ---------------- | ----------------------------------------------------- |
| New Order Status | Status iniziale dell'ordine prima del pagamento |
| Debug | Se vero, imposta il pos in modalità di test |
| Payment Method | Implicit / Explicit (vedi sez. Metodo di Pagamento) |
| Password | Credenziali fornite dalla banca |
| ID | 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.
| | |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 |
| Checkout option description | Descrizione pubblica del metodo di pagamento. |
| Forced Void Authorization | Rilascio forzato del platfond bloccato durante l'autorizzazione della transazione cliente in caso di annullamento |
| Payment description | Descrizione personalizzata presentata durante la transazione di pagamento a SETEFI. Se non impostata, verrà indicata una descrizione generica. |
| Auto Invoice | Fatturazione automatizzata e cattura diretta dell'importo . |
## System Settings
La sotto sezione "Impostazioni di Sistema" permette di controllare alcune opzioni a basso livello della comunicazione fra il modulo ed i server della SETEFI.
| | |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| TLSv1 Security | Abilita o disabilita la connessione via TLS utilizzata dal componente cURL. (vedi [specifiche funzionali](/specifiche-funzionali)) |
| Payment Cron Inquiry | Frequenza di richiesta di aggiornamento dello status dell'ordine inviato alla SETEFI |
## Integrazione
Il metodo di pagamento Paypal Wallet si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di controllare le transazioni di pagamento direttamente dallo stesso pannello di ordini.
# Notifica di pagamento Paypal
A fronte del corretto inserimento dei dati della carta di credito da parte del titolare, il pagamento viene processato da MonetaWeb e viene fornita al Commerciante una notifica dell’esito del pagamento stesso.
La notifica viene effettuata tramite una chiamata da parte del server della SETEFI. Tra i vari parametri ricevuti, vi è il securityToken rappresentato da una stringa di sicurezza generata da MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase di notifica dell’esito; per scopi di sicurezza, il modulo SETEFI verifica che il valore del securityToken ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente l’esito della transazione, il modulo risponde al messaggio di notifica, appena ricevuto da Monetaweb, con l’url della propria pagina di esito associando i parametri richiesti come il "paymentid".
**Attenzione**: una volta instaurata la connessione, i server della SETEFI attendono per 20 secondi di ricevere in risposta la URL per la redirezione finale. Allo scadere del timeout, la richiesta viene abbandonata. A tal proposito il frontend del negozio Magento **deve essere pubblicato ed accessibile da remoto senza alcuna password** di visualizzazione.
*Nel caso in cui il negozio sia protetto da un certificato self-signed o emesso da CA secondarie, è necessario fornire al supporto di MonetaWeb la catena completa in formato PEM codificati X509, pena, il fallimento della notifica dell'esito. Per eventuali import in ambiente di PRODUZIONE l'intervento andrà programmato con almeno un mese di anticipo.*
# Alipay
Alipay E-Payment Service è una soluzione di pagamento che consente agli acquirenti di pagare in valuta cinese (RMB) i beni venduti su siti internazionali.
Grazie all'integrazione con Alipay, MonetaWeb fornisce ai Commercianti l'accesso al crescente mercato cinese in maniera sicura ed efficiente.
1. Il Titolare dell'account di Alipay effettua un acquisto sul sito del Commerciante, scegliendo Alipay come strumento di pagamento
2. Il server del Commerciante redirige il titolare verso una pagina di appoggio di MonetaWeb
3. MonetaWeb redirige il titolare verso la login page di Alipay
4. Il titolare inserisce le proprie credenziali Alipay e autorizza il pagamento
5. Monetaweb redirige il titolare verso la pagina del negozio per la visualizzazione dell'esito finale.
## Configurazione
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Setefi > Configuration > Alipay Wallet. Il pannello di controllo del metodo Alipay Wallet si presenterà come da foto.
Nel pannello di controllo del metodo di pagamento selezionato vi sono tre sotto sezioni che consentono 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
* System Settings
Per poter utilizzare il metodo di pagamento Alipay Wallet 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.
## 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 | |
| ---------------- | ----------------------------------------------------- |
| New Order Status | Status iniziale dell'ordine prima del pagamento |
| Debug | Se vero, imposta il pos in modalità di test |
| Payment Method | Implicit / Explicit (vedi sez. Metodo di Pagamento) |
| Password | Credenziali fornite dalla banca |
| ID | 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.
| | |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 |
| Checkout option description | Descrizione pubblica del metodo di pagamento. |
| Forced Void Authorization | Rilascio forzato del platfond bloccato durante l'autorizzazione della transazione cliente in caso di annullamento |
| Payment description | Descrizione personalizzata presentata durante la transazione di pagamento a SETEFI. Se non impostata, verrà indicata una descrizione generica. |
| Auto Invoice | Fatturazione automatizzata e cattura diretta dell'importo . |
## System Settings
La sotto sezione "Impostazioni di Sistema" permette di controllare alcune opzioni a basso livello della comunicazione fra il modulo ed i server della SETEFI.
| | |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| TLSv1 Security | Abilita o disabilita la connessione via TLS utilizzata dal componente cURL. (vedi [specifiche funzionali](/specifiche-funzionali)) |
| Payment Cron Inquiry | Frequenza di richiesta di aggiornamento dello status dell'ordine inviato alla SETEFI |
## Integrazione
Il metodo di pagamento Alipay Wallet si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di controllare le transazioni di pagamento direttamente dallo stesso pannello di ordini.
# Notifica di pagamento Alipay
Lo stato di un pagamento Alipay può cambiare, in un momento successivo alla fase online, a seguito di verifiche interne e processi proprietari di Alipay. In tal caso, Alipay notificherà il cambio stato a MonetaWeb, la quale inoltrerà la notifica alla ipnUrl del Commerciante.
A fronte del corretto inserimento dei dati della carta di credito da parte del titolare, il pagamento viene processato da MonetaWeb e viene fornita al Commerciante una notifica dell’esito del pagamento stesso.
La notifica viene effettuata tramite una chiamata da parte del server della SETEFI. Tra i vari parametri ricevuti, vi è il securityToken rappresentato da una stringa di sicurezza generata da MonetaWeb e comunicata al Commerciante sia in fase di risposta alla inizializzazione, sia in fase di notifica dell’esito; per scopi di sicurezza, il modulo SETEFI verifica che il valore del securityToken ricevuto in fase di notifica corrisponda a quanto ricevuto in fase di inizializzazione.
Al fine di poter redirigere la sessione web del titolare verso una nuova pagina contenente l’esito della transazione, il modulo risponde al messaggio di notifica, appena ricevuto da Monetaweb, con l’url della propria pagina di esito associando i parametri richiesti come il "paymentid".
**Attenzione**: una volta instaurata la connessione, i server della SETEFI attendono per 20 secondi di ricevere in risposta la URL per la redirezione finale. Allo scadere del timeout, la richiesta viene abbandonata. A tal proposito il frontend del negozio Magento **deve essere pubblicato ed accessibile da remoto senza alcuna password** di visualizzazione.
*Nel caso in cui il negozio sia protetto da un certificato self-signed o emesso da CA secondarie, è necessario fornire al supporto di MonetaWeb la catena completa in formato PEM codificati X509, pena, il fallimento della notifica dell'esito. Per eventuali import in ambiente di PRODUZIONE l'intervento andrà programmato con almeno un mese di anticipo.*
# Digital Wallet (Token)
Il modulo SETEFI offre l'opzione Digital Wallet che consente di registrare una stringa nel database Magento chiamata token, collegata ad una carta di credito salvata nei server sicuri della SETEFI. Tale token consente di effettuare dei pagamenti ricorrenti direttamente da Magento senza aver bisogno di reinserire i dati della carta di credito. Viene spesso utilizzata per effettuare pagamenti ricorrenti per servizi che si ripetono nel tempo oppure per poter velocizzare il pagamento degli ordini in fase di checkout.
## Come funziona il sistema di Tokenization?
**Il cliente effettua il suo primo acquisto via metodo Hosted 3D Secure** offerto nel modulo. L'esercente deve impostare il profilo per la generazione dei TOKEN. Se non viene impostato tale profilo, non sarà possibile richiedere un token alla banca.
Durante la fase di checkout **il cliente decide di voler registrare la propria carta di credito sui server della banca**. Il modulo di pagamento invia la richiesta alla banca per la **generazione di un Token personalizzato**.
Il cliente inserisce i dati della sua carta di credito e completa il suo primo acquisto. **La banca crea il token ed associa la carta di credito a tale token e conferma all'esercente l'avvenuta creazione del token.**
Il cliente desidera comprare qualcos'altro nel negozio ed al checkout può avere diverse scelte:
* **Pagare con una nuova carta di credito.**
* Anche in questo caso può richiederne la registrazione.
* L'esercente può disabilitare tale opzione dal pannello di controllo del modulo obbligando il cliente ad usare il token. Se il cliente cancella il suo token apparirà nuovamente la possibilità di usare il metodo Hosted 3D Secure
* **Pagare con il Digital Wallet.**
* Il modulo invierà direttamente i dati dell'acquisto alla banca indicando anche il token da utilizzare per la transazione. **In base al profilo sottoscritto con la banca**, la transazione di pagamento avverrà velocemente senza la richiesta da parte del cliente di alcun dato della carta di credito.
# Magento 1
## Configurazione Digital Wallet (Token)
Il servizio di Digital Wallet di SETEFI offre la libertà di effettuare un pagamento in meno di due click in piena sicurezza sia per il cliente che per l'esercente. Per poter configurare il modulo in Magento basta far click sul menu Setefi > Configurazione > Digital Wallet dopo aver effettuato il login come amministratori di Magento.
La creazione ed il pagamento ricorrente tramite Digital Wallet ID necessita di credenziali differenti a seconda dell'operazione da effettuare. La creazione del Wallet ID avviene effettuando la richiesta di 10 centesimi a SETEFI utilizzando un coppia di ID/PASSWORD impostata nel pannello di controllo del modulo nella sezione **Creation Request Credentials**. Le richieste di pagamento ricorrenti utilizzeranno le credenziali impostate nella sezione **Recurrent Payment Credentials**.
## Digital Wallet & Checkout
Se l'opzione è attiva, ed il cliente ha già salvato nel suo profilo la carta di credito, Magento presenterà l'opzione Moneta Wallet, consentendo di pagare l'ordine usando il token.
### Pannello di Controllo Wallet IDs
Il cliente potrà in qualsiasi momento creare un nuovo Wallet ID e/o cancellare il Wallet ID precedentemente creato utilizzando il pannello di controllo utente standard di Magento. Una nuova voce apparirà nella colonna sinistra del layout standard di Magento favorendo l'accesso diretto alla gestione dei Wallet collegati alle carte di credito del cliente.
Una lista permetterà al cliente di visualizzare tutti gli Wallet registrati ed eventualmente cancellarli con un semplice click.
oppure creare un nuovo Wallet ID inserendo i dati della carta di credito direttamente in un modulo protetto. Tutti i dati sensibili inseriti dentro il modulo di registrazione del Wallet **NON SARANNO REGISTRATI** nell'archivio di Magento.
### Administrator Wallet Manager
L'opzione Digital Wallet permette di mantenere una lista di token direttamente nel pannello di controllo di Magento e di creare anche manualmente un token personalizzato per ogni cliente registrato all'interno dell'archivio Magento.
Per poter accedere all'area amministrativa del Digital Wallet bisogna essere amministratori di Magento e selezionare dal menù in alto: Setefi > Digital Wallet.
Una griglia con la lista dei Wallet disponibili apparirà:
In questa sezione è possibile, creare, modificare, esportare e cancellare i Digital Wallet usando l'interfaccia di Magento. Dopo aver registrato i dettagli nella scheda del cliente, l'amministratore potrà creare un Wallet ID richiedendo un'autorizzazione a SETEFI di 10 centesimi. Le informazioni sensibili inviate alla banca non verranno registrate in Magento in chiaro ma verranno mascherati. In questo caso si potrà controllare la scadenza delle carte di credito ed avvisare la clientela.
# Magento 2
## Configurazione Digital Wallet (Token)
Il servizio di Digital Wallet di SETEFI offre la libertà di effettuare un pagamento in meno di due click in piena sicurezza sia per il cliente che per l'esercente. Per poter configurare il modulo in Magento basta attivare l'opzione Token nel metodo di base Hosted.\
il metodo Digital Wallet click sul menu Store > Configuration > Sales > Payment Methods > Hosted 3D Settings > Hosted 3D Features > Token
**La creazione ed il pagamento ricorrente tramite Digital Wallet necessita di credenziali differenti a seconda dell'operazione da effettuare**. La creazione del Digital Wallet avviene effettuando la richiesta al primo acquisto da parte del cliente. Le richieste di pagamento ricorrenti utilizzeranno le credenziali impostate nella sezione **Wallet Settings**.
## Digital Wallet & Checkout
Se l'opzione è attiva, ed il cliente ha già salvato nel suo profilo la carta di credito attraverso il primo acquisto, Magento presenterà l'opzione Digital Wallet, consentendo di pagare l'ordine usando il token.
### Pannello di Controllo Cliente Digital Wallet
Il cliente potrà in qualsiasi momento cancellare il token precedentemente creato utilizzando il pannello di controllo utente standard di Magento. Una nuova voce apparirà nella colonna sinistra del layout standard di Magento favorendo l'accesso diretto alla gestione dei Wallet collegati alle carte di credito del cliente.
Una lista permetterà al cliente di cancellare il Digital Wallet registrato con un semplice click.
### Administrator Wallet Manager
L'opzione Digital Wallet permette la gestione di un token per cliente direttamente nel pannello di controllo di Magento..
Per poter accedere all'area amministrativa del Digital Wallet bisogna essere amministratori di Magento e selezionare dal menù in alto: Customers > All Customers > Selezionare il profilo del cliente desiderato > Account Information > **Token (SETEFI)**
L'amministratore può cancellare il token da Magento ma non direttamente dal server della banca. L'unico a poter cancellare il token dal server della banca è il cliente dal suo pannello di controllo.
# 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 SETEFI 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**; Setefi si riserva 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 l'opzione di creazione del [Wallet ID](/soluzioni-di-pagamento/digital-wallet-id) legato al cliente che ha richiesto l'ordine.
## Configurazione
Dopo aver avuto accesso nel pannello di controllo amministrativo di Magento bisogna far click nella voce di menu Setefi > Configuration > MO.TO (Mail Order / Telephone Order). Il pannello di controllo del metodo MO.TO si presenterà come da foto.
Nel pannello di controllo del metodo di pagamento selezionato vi sono tre sotto sezioni che consentono 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
* System Settings
Per poter utilizzare il metodo di pagamento MO.TO 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.
## 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 | |
| ---------------- | ----------------------------------------------------- |
| New Order Status | Status iniziale dell'ordine prima del pagamento |
| Debug | Se vero, imposta il pos in modalità di test |
| Payment Method | Implicit / Explicit (vedi sez. Metodo di Pagamento) |
| Password | Credenziali fornite dalla banca |
| ID | 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.
| | |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 |
| Checkout option description | Descrizione pubblica del metodo di pagamento. |
| Forced Void Authorization | Rilascio forzato del platfond bloccato durante l'autorizzazione della transazione cliente in caso di annullamento |
| Payment description | Descrizione personalizzata presentata durante la transazione di pagamento a SETEFI. Se non impostata, verrà indicata una descrizione generica. |
| Auto Invoice | Fatturazione automatizzata e cattura diretta dell'importo . |
## System Settings
La sotto sezione "Impostazioni di Sistema" permette di controllare alcune opzioni a basso livello della comunicazione fra il modulo ed i server della SETEFI.
| | |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| TLSv1 Security | Abilita o disabilita la connessione via TLS utilizzata dal componente cURL. (vedi [specifiche funzionali](/specifiche-funzionali)) |
## Integrazione
Il metodo di pagamento MO.TO si integra in Magento sfruttando tutte le funzionalità del CORE del software eCommerce al fine di controllare le transazioni di pagamento direttamente dallo stesso pannello di ordini.
# Contabilizzazione dei metodi di Pagamento
Le fasi delle transazioni di pagamento sono principalmente:
1. Autorizzazione
2. Annullamento (autorizzazione)
3. Cattura
4. Storno
## Contabilizzazione Implicita
Contestualmente alla fase di pagamento, ogni transazione autorizzata viene implicitamente confermata (catturata). Tale operazione permetterà la movimentazione del denaro dal circuito internazionale della carta di credito del cliente verso il conto collegato al POS Virtuale dell'esercente. E' bene ricordare che se l'impostazione del profilo POS Virtuale presso i server della banca viene impostato in modalità implicita non sarà possibile effettuare la cattura online dell'ordine poichè la movimentazione è già stata eseguita contestualmente all'autorizzazione. Bisogna richiedere alla banca di impostare il profilo in modalità esplicita così da poter utilizzare l'opzione del modulo: [Fatturazione Automatica](/fatturazione-automatica).
Se il profilo rimarrà in modalità implicita Magento non potrà eseguire la "Cattura Online" e genererà un errore di "Movimentazione già effettuata" che ricorderà all'esercente che l'autorizzazione è stata già movimentata. Infine non sarà possibile effettuare una nota di credito per mancanza di informazioni necessarie per lo storno.
## Contabilizzazione Esplicita
Dopo la fase di pagamento sarà necessario procedere alla conferma esplicita delle transazioni autorizzate che si desidera vengano contabilizzate e liquidate. Se si è interessati alla fatturazione immediata ed automatica con movimentazione del denaro contestualmente all'autorizzazione vedere il capitolo: [Fatturazione Automatica](/fatturazione-automatica).
La tabella seguente mostra per ciascun metodo di pagamento le modalità di contabilizzazione compatibili e gli eventuali limiti temporali, dal rilascio dell'autorizzazione, entro i quali processare la richiesta.
| | IMPLICITA | ESPLICITA |
| ----------------------------- | :-------: | :-------: |
| Carta di Credito / Masterpass | SI | 4 Giorni |
| MyBank | SI | NO |
| Paypal | SI | 29 Giorni |
| Alipay | SI | NO |
Se una transazione autorizzata non viene confermata, il plafond della carta di credito resterà bloccato per un importo pari a quello autorizzato. Dopo un certo numero di giorni l'autorizzazione e decadrà e l’importo bloccato tornerà disponibile; tale numero di giorni è variabile in base alla banca emittente della carta di credito utilizzata.
Se a seguito di una conferma si ha la necessità di riaccreditare l'importo del pagamento o parte di esso, occorre effettuare un'operazione di storno, a partire dal giorno contabile successivo alla data di conferma.
L'iter da seguire utilizzando Magento in modalità Esplicita è:
**Autorizzazione** (Acquisto) > **Cattura** (Fattura) > **Storno** (Nota di credito)
**Autorizzazione** (Acquisto) > **Annullamento** (Reimpostazione dello status dell'ordine come non pagato)
Tali operazioni possono essere eseguite dal pannello di controllo di Magento.
# Fatturazione automatica
Alcuni esercenti necessitano l'opzione della fatturazione automatica e la "cattura" dell'importo presente in fattura. La cattura (vedi [contabilizzazione dei metodi di pagamento](/contabilizzazione-pagamento)) permette di richiedere contestualmente il denaro indicato durante la fase di autorizzazione del pagamento. Tale opzione permetterà all'esercente di far generare in automatico la fattura a Magento e la conseguente "cattura online" dell'importo presente nell'ordine.
Per attivare tale opzione è possibile accedendo nella sezione Store > Configuration > Sales > Payment Method > Mercury > Common Options > Auto Invoice: Yes
Abilitando tale opzione il software Magento comunicherà al modulo di pagamento di effettuare una richiesta di movimentazione contestualmente alla generazione della fattura.
Attenzione! Tale opzione è disponibile solamente nella versione del modulo di pagamento Setefi - Mercury per Magento 2.
# Test & Live Mode
## Test & Live Mode
La SETEFI 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. Vi sono degli accorgimenti da adottare durante le fasi di test:
* non si può testare un modulo se 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. Quindi non è possibile testare le funzionalità in localhost. Tutte le transazioni verranno cancellate o genereranno un errore. Vedi sezione Testing di seguito.
* il negozio Magento deve essere accessibile (frontend) senza password (vedi htpasswd).
Alla sottoscrizione dei servizi POS Virtuali, la banca rilascerà le credenziali di test per effettuare alcuni test direttamente nel vostro negozio usando il modulo della Shine Software.
## Testing & Licenza
Per effettuare un testing completo del modulo rispettando le regole indicate in precedenza, bisogna creare un negozio di sviluppo in un sottodominio per il dominio licenziato. Ad esempio, dev.miodominio.it dove miodominio.it è il dominio licenziato. In caso venga installato un modulo licenziato per un altro dominio si riceverà un errore bloccante.
## BackOffice Setefi
Per poter accedere al backoffice di test usare il seguente link:
## 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. ID **99999999**
2. Password **99999999**
3. **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. ID (Ufficiale)
2. Password (Ufficiale)
3. **Debug: NO**
## Credenziali & Carte di Credito di Test
La SETEFI 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. Vi sono degli accorgimenti da adottare durante le fasi di test:
* non si può testare un modulo se 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.
Per le prove potete utilizzare una carta di credito valida: **Visa**, **MasterCard**.
| **TIPO** | **CARTA DI CREDITO** | **SCADENZA** | **CVV** | **SECURE CODE** |
| :--------: | -------------------- | :----------: | :-----: | :-------------: |
| VISA | 4349940199990739 | 08/2020 | 700 | valid |
| VISA | 4349940199990747 | 08/2020 | 243 | valid |
| MASTERCARD | 5398320199998163 | 08/2020 | 564 | valid |
### 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 SETEFI al numero fisso 0289137928 presentando il proprio ID o partita iva.[
](https://docs.setefi.shinesoftware.it/download--installazione.html)
# Logging, Debug ed Errori Comuni
## Logging, Debug ed Errori Comuni
Qualsiasi comunicazione con la SETEFI 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 SETEFI 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.
## 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 SETEFI 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 SETEFI potranno il motivo dell'errore.
* **SSL Connect Error**
* In questo caso il sistema cURL installato nel server non riconosce il protocollo https\:// indicato nell'URL di Endpoint indicato dalla banca. Contattare il proprio sistemista. Test: Provare a cancellare dal file config.xml il prefisso https\:// dall'elemento "urltest" e "urllive".
Prima di contattare i tecnici della BNL con l'opzione "[Helpdesk Support](/helpdesk-support)", di seguito descritto, è bene effettuare un controllo semplice utilizzando le informazioni riportate di seguito.
| 000 | Transazione Autorizzata |
| --- | ----------------------------------------- |
| 100 | Autorizzazione Negata (Generico) |
| 101 | Carta Scaduta o Data Scadenza Invalida |
| 102 | Sospetta Frode |
| 104 | Carta non Valida |
| 106 | Numero Tentativi PIN Superato |
| 109 | Merchant non Valido |
| 110 | Importo non Valido |
| 111 | Numero Carta non Valido |
| 115 | Funzione Richiesta non Supportata |
| 116 | Disponibilità Insufficiente |
| 117 | Codice Segreto Errato |
| 118 | Carta Inesistente |
| 119 | Operazione non Permessa al Titolare Carta |
| 120 | Operazione non Permessa al Terminale |
| 121 | Limite Importo Superato |
| 122 | Operazione non Permessa |
| 123 | Numero Pagamenti Superato |
| 124 | Operazione non Permessa |
| 125 | Carta Inattiva |
| 126 | PIN Block Invalido |
| 129 | Sospetta Carta Contraffatta |
| 182 | Errore Wallet |
| 200 | Autorizzazione Negata |
| 202 | Sospetta Frode |
| 204 | Carta Limitata |
| 208 | Carta Smarrita |
| 209 | Carta Rubata |
| 210 | Sospetta Carta Contraffatta |
| 888 | Pending (Alipay) |
| 902 | Transazione Invalida |
| 903 | Transazione Ripetuta |
| 904 | Errore di Formato |
| 906 | Cutover in Corso |
| 907 | Malfunzionamento Emittente |
# Helpdesk Support
## Helpdesk Support
Il modulo di pagamento SETEFI MonetaWeb Advanced permette registra all'interno di un file di log tutte le informazioni necessarie per effettuare una transazione di pagamento utilizzando i server della SETEFI. 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 > Setefi > Configurazione > General Options > Helpdesk è possibile inviare una richiesta completa agli operatori della SETEFI 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 SETEFI.
Sfruttando il sistema integrato per la gestione dei template email di Magento è possibile personalizzare il contenuto del messaggio inviato alla SETEFI seguendo le operazioni standard presenti nel manuale Magento.
## 
## 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.
# 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 SETEFI payment **v.2.0.0.0** method? Click here to learn more.
La versione del sotto-modulo si trova al fianco del nome.
**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.
| | Magento 1.9.x | Magento > 2.1.x | Magento > 2.2.x | Magento > 2.3.x |
| ---------------------------------- | ------------- | --------------- | --------------- | --------------- |
| Hosted 3D Secure | Incluso | Incluso | Incluso | Incluso |
| MO.TO (Mail Order Telephone Order) | Incluso | - | - | |
| MyBank | Incluso | Incluso | Incluso | Incluso |
| Masterpass | Incluso | Incluso | Incluso | Incluso |
| Paypal | Incluso | Incluso | Incluso | Incluso |
| Alipay | Incluso | Incluso | Incluso | Incluso |
| Digital Wallet | Incluso | Incluso | Incluso | Incluso |