Manuale di Installazione e Utilizzo Modulo Key Client Il modulo Key Client consente di abilitare in Magento la modalità di pagamento attraverso le carte di pagamento del circuito Key Client (www.keyclient.it). Il metodo di integrazione implementato prevede la direzione dell'utente alla pagina del portale di pagamento Key Client e successivo ritorno al negozio on-line al termine della transazione. Versione: 1.0 Requisiti di sistema Magento v 1.3.2.x Magento v 1.4.0.x Se la versione sulla quale si desidera installare il modulo non è elencata non significa che il modulo non funzionerà. Se si necessita di installare il modulo su una versione non elencata potete chiederci di testare il modulo sulla versione che desiderate:. è un servizio che offriamo gratuitamente per soddisfare le vostre esigenze. Indice generale Installazione...2 Utilizzo...3 Internazionalizzazione...5 Condizioni e responsabilità...5 Condizioni di utilizzo...5 Limitazioni di responsabilità...5
Installazione Per installare il modulo Key Client è sufficiente copiare la cartella app del pacchetto del modulo nella cartella principale dell'installazione di Magento. Nei sistemi Windows questo comporterà una richiesta di sovrascrittura a cui occorre rispondere Sì. In altri sistemi accertarsi che la copia non cancelli i file le e le cartelle originali ma si limiti ad aggiungere i contenuti del pacchetto del modulo. Successivamente autenticarsi sul pannello di amministrazione di Magento e selezionare Sistema\Gestione Cache ed aggiornare la cache. Per verificare che il modulo sia installato correttamente selezionare Sistema Configurazione Avanzato Avanzato e controllare che esista l'opzione Webgriffe_KeyClient e che sia impostata su Abilita. Pag. 2
Utilizzo Per utilizzare il modulo Key Client, autenticarsi sul pannello di amministrazione di Magento, selezionare Sistema Configurazione Metodi di Pagamento ed espandere la voce Portale di Pagamento Key Client attivando in tal modo la scheda di configurazione mostrata di seguito. Il significato delle diverse opzioni è illustrato di seguito: Abilitato Se impostato su Sì rende il metodo di pagamento selezionabile dall'utente del negozio nella pagina di finalizzazione dell'acquisto. Pag. 3
Modalità di Test Abilitata Se impostato su Sì permette di utilizzare il metodo di pagamento esclusivamente per effettuare dei test. In questa modalità il valore dell'importo comunicato al portale Key Client sarà sempre equivalente a 0,01 indipendentemente dal reale importo dell'acquisto. Attenzione: si sconsiglia di utilizzare la modalità di test in un ambiente di produzione. La modalità di test è da utilizzare solo per verificare la corretta impostazione dei parametri di configurazione e il corretto dialogo tra il negozio online e il portale dei pagamenti Key Client. Titolo È il titolo del metodo di pagamento che sarà presentato all'utente del negozio nella pagina di finalizzazione dell'acquisto. Stato di un Nuovo Ordine ordine al momento della conferma di acquisto ma prima che la procedura di pagamento sia conclusa. Stato di un Ordine con Pagamento Non Autorizzato o Annullato ordine al termine della procedura di pagamento non autorizzata da Key Client o annullata dal cliente. Stato di un Ordine con Pagamento Autorizzato ordine al termine della procedura di pagamento autorizzato da Key Client. Alias/Insegna del Negozio L'insegna del negozio è un valore fisso comunicato da Key Client nella fase di attivazione del contratto con il Merchant. Se la modalità di Test è abilitata, è possibile utilizzare il valore payment_testm_urlmac. Chiave segreta per il calcolo del codice MAC Il MAC (Message Code Authentication) è un valore calcolato sui dati della transazione e utilizzato nel dialogo tra il negozio del Merchant e il Portale di Pagamento Key Client per verificare che i dati inviati non siano stati manipolati durante l'invio. La Chiave segreta, utilizzata per calcolare il MAC, è comunicata da Key Client nella fase di attivazione del contratto con il Merchant. Se la modalità di Test è abilitata, è possibile utilizzare il valore esempiodicalcolomac. URL della Pagina di Pagamento di Key Client Rappresenta l'url della pagina di pagamento a cui l'utente del negozio viene direzionato per concludere la fase d'acquisto ed effettuare il pagamento. Questo valore è preimpostato e non dovrebbe cambiare salvo comunicazioni da parte di Key Client. Pag. 4
Internazionalizzazione Le etichette di questo modulo possono essere tradotte in qualsiasi lingua utilizzando il sistema di traduzione di Magento basato su file CSV (Comma Separated Values). Nel pacchetto sono già incluse le lingue elencate di seguito: Inglese (Stati Uniti): en_us Italiano (Italia): it_it Condizioni e responsabilità Condizioni di utilizzo Ad eccezione di quanto stabilito dalle leggi locali, questo software è fornito così com'è senza alcuna garanzia, scritta o verbale, esplicita o implicita. Questo software è ceduto in licenza d'uso. Utilizzando questo software si dichiara di accettare automaticamente le condizioni espresse di seguito: 1. È consentito: utilizzare tale software senza scopo di lucro gratuitamente e a titolo di prova per un tempo indeterminato al fine di valutare l'acquisto di una regolare licenza d'uso; utilizzare tale software per scopi commerciali qualora si sia acquistata una regolare licenza d'uso. L'utilizzo è consentito su una sola installazione di Magento ecommerce e ogni utilizzo diverso deve essere autorizzato in forma scritta da parte di Webgriffe; copiare e distribuire il software riportando i termini di licenza e citando sempre Webgriffe. 2. Non è consentito rivendere o subaffittare il software o parti di esso senza l'esplicito consenso scritto di Webgriffe; copiare e distribuire il software modificato o parti di esso senza l'esplicito consenso scritto di Webgriffe. Limitazioni di responsabilità Ad eccezione di quanto stabilito dalle leggi locali, in nessun caso Webgriffe o altre società ad essa collegate potranno essere ritenute responsabili per qualsiasi tipo di danno, incluso perdita di profitto, di dati o di collegamento, derivante dall'utilizzo o dall'impossibilità di utilizzare questo software. L'utilizzatore si assume i rischi dell'utilizzo e si fa carico degli eventuali costi derivanti dai servizi o dalle riparazioni necessarie al funzionamento del software. Pag. 5