VirtueMart
L'estensione di pagamento Nexi XPay per VirtueMart consente di integrare il gateway di pagamento XPay senza richiedere alcuna implementazione aggiuntiva sul tuo sito web. Gestisce il trasferimento del cliente dal sito di e-commerce del commerciante all'ambiente sicuro di Nexi e viceversa. Il cliente rimane sul sito di e-commerce del commerciante fino alla fase di checkout, dopodiché viene reindirizzato al gateway XPay per completare il pagamento.
Installazione
Il plugin Nexi XPay per VirtueMart è disponibile gratuitamente nella directory delle estensioni di Joomla, dove è possibile verificare le versioni compatibili.
L'estensione può essere installata tramite il gestore delle estensioni fornito da Joomla:
- Accedi al pannello di amministrazione di Joomla.
- Nella barra di navigazione in alto, seleziona Estensioni > Gestisci.
- Carica il file scaricato dalla directory delle estensioni di Joomla.
- Dal menu a sinistra, seleziona Gestisci.
- Cerca Nexi XPay nell'elenco.
- Abilita l'estensione cliccando sul pulsante corrispondente.
- Nella barra di navigazione in alto, seleziona VirtueMart > Metodi di pagamento.
- Nella nuova pagina, seleziona il plugin Nexi XPay dall'elenco e clicca sul pulsante Modifica.
- Clicca sul pulsante Nuovo in alto.
- Nella nuova pagina, inserisci Nexi XPay nel campo Nome pagamento e seleziona Nexi XPay come Metodo di pagamento
- Clicca sul pulsante Salva in alto.
La fase di installazione è ora completa. Puoi procedere con la configurazione.
Configurazione
Di seguito sono riportate le istruzioni per configurare correttamente il plugin Nexi XPay:
- Accedi al pannello di amministrazione di Joomla.
- Nella barra di navigazione superiore, seleziona VirtueMart > Metodi di pagamento.
- Nella nuova pagina, fai clic sul plugin Nexi XPay dall'elenco.
- Selezionare la sezione Configurazione.
- Procedi con la configurazione del modulo.
| Campo | Descrizione |
|---|---|
| Abilita/Disabilita | Abilita il modulo di pagamento Nexi XPay |
| Tipologia | Seleziona API Key |
| API Key | Codice necessario per la comunicazione con il gateway XPay. Per ottenere questo dato per l'ambiente di produzione seguire le indicazioni del paragrafo successivo. |
| Abilita/Disabilita la modalità TEST | Attiva o disattiva la modalità di test. Registrati nell'area di test per ricevere le tue credenziali. Le credenziali di test sono disponibili nella sezione Area di test. |
| Abilita 3D secure 2 | Il nuovo protocollo 3D Secure 2 adottato dai principali circuiti internazionali (Visa, MasterCard, American Express), introduce nuove modalità di autenticazione, in grado di migliorare e velocizzare l'esperienza di acquisto del titolare della carta. |
Test e produzione
È altamente consigliato testare il plugin in ambiente di test, prima di inserire i codici di produzione.
È possibile ottenere le credenziali di test (API Key) nella sezione area di test. Nell'area saranno presenti anche le carte di test utilizzabili per eseguire transazioni con esito positivo e negativo. In questa fase è necessario verificare che gli ordini vengano creati correttamente, controllando anche il dettaglio degli ordini.
Passaggio in produzione
Per effettuare il passaggio in produzione è necessario creare le credenziali di produzione (API Key). Per generare le nuove credenziali seguire questi passaggi:
- Accedere a Nexi Business.
- Effettuare il login al Back Office di XPay Web.
- Nella sezione "Admin" cliccare su "APIKey".
- Cliccare su "Aggiungere nuova APIKey".
- Una volta selezionato il terminale, cliccare su "Aggiungi" per generare l'API Key di produzione.
Una volta creata l'API Key serve aggiornare la configurazione del modulo:
- Accedere alla sezione di configurazione come indicato nei punti precedenti
- Disabilitare la modalità TEST e inserire la API Key generata nel Back Office merchant.
- Salvare la nuova configurazione.
Metodi di pagamento
Il plugin Nexi XPay mette a disposizione ai clienti diverse modalità di pagamento:
Pagamento tramite carta
Con questa soluzione il cliente resta sull'e-commerce dell'esercente fino al momento del checkout. Viene reindirizzato in ambiente Unicredit per effettuare il pagamento per poi tornare sul sito dell'esercente al termine della transazione.
Metodi di pagamento alternativi (APM)
Funzionalità back office
Nel dettaglio di ciascun ordine il plugin mette a disposizione delle informazioni relative alle transazioni come il dettaglio della carta utilizzata e lo stato dei pagamenti sul gateway XPay.
Rimborso
È possibile eseguire operazioni di rimborso totale o parziale. Questa operazione stornerà l'importo desiderato rimborsando il cliente e cambiando lo stato dell'ordine di Virtuemart. Di seguito le operazioni da eseguire:
- Accedere al pannello amministrativo di Joomla
- Dal menu laterale aprire la sezione Components > Virtuemart > Orders
- Selezionare l'ordine da rimborsare
- In fondo alla pagina di dettaglio ordine sarà presente una sezione dedicata al metodo di pagamento nella quale sarà presente un bottone per procedere con il rimborso
- Inserire l'importo da stornare e premere il bottone
Contabilizzazione
È possibile eseguire operazioni di contabilizzazione totale o parziale. Questa operazione contabilizzerà l'importo desiderato sul gateway XPay.
Di default la contabilizzazione avviene in automatico alla mezzanotte, utilizzare questa opzione solo in caso di configurazioni non standard del terminale.
- Accedere al pannello amministrativo di Joomla
- Dal menu laterale aprire la sezione Components > Virtuemart > Orders
- Selezionare l'ordine da contabilizzare
- In fondo alla pagina di dettaglio ordine sarà presente una sezione dedicata al metodo di pagamento nella quale sarà presente un bottone per procedere con la contabilizzazione
- Inserire l'importo da contabilizzare e premere il bottone