Wordpress
L'estensione di pagamento Nexi XPay per Wordpress, ti consente di integrare il gateway di pagamento XPay senza ulteriori implementazioni sul tuo sito.
Per utilizzare questo plugin è necessario che sul sito Wordpress sia installato il modulo Woocommerce.
Installazione
Il plugin Nexi XPay per Wordpress è disponibile gratuitamente al sito wordpress.org, da cui sarà possibile verificare le versioni compatibili.
È possibile installare l'estensione tramite l'installer apposito messo a disposizione da Wordpress.
- Effettuare il login nel pannello amministrativo di Wordpress.
- Assicurarsi di avere installato il plugin Woocommerce.
- Nella barra di navigazione a sinistra selezionare Plugin > Aggiungi nuovo.
- Nella nuova pagina inserire Nexi XPay nella barra di ricerca.
- Individuare il plugin XPay e cliccare Installa ora.
La fase di installazione è completata, procedere con la configurazione.
Configurazione
Di seguito le indicazioni per poter configurare correttamente il plugin Nexi XPay:
- Effettuare il login nel pannello amministrativo di Wordpress.
- Nella barra di navigazione a sinistra selezionare Plugin > Plugin installati.
- Nella nuova pagina cercare il plugin Nexi XPay nell'elenco e cliccare su Impostazioni.
- Procedere con la configurazione del modulo:
| Campo | Descrizione |
|---|---|
| Abilita | Abilita il modulo di pagamento Nexi XPay. |
| Tipologia di credenziali | Selezionare API Key |
| Tipologia di integrazione | - Pagina di pagamento ospitata con reindirizzamento: il cliente viene reindirizzato alla pagina di pagamento esterna di XPay. - Build con checkout incorporato: il modulo di inserimento dati carta è integrato nel checkout. |
| API Key | Codice necessario per la comunicazione con il gateway XPay. Per ottenere questo dato per l'ambiente di produzione o test seguire le indicazioni del paragrafo successivo Test e produzione. |
| Abilita modalità di TEST | Abilita la modalità di test: è possibile recuperare le credenziali di test nella sezione Area di test. |
| Abilita il servizio 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. |
| Abilita OneClick | Questa funzionalità permette di tokenizzare i dati carta del cliente in modo da permettere pagamenti successivi più rapidi. Assicurati che questa opzione sia abilitata anche nella configurazione del tuo terminale. Non disponibile nella tipologia di integrazione Build con checkout incorporato. |
| Abilita Multivaluta | Riservato esclusivamente a pagamenti con carta: attiva questa opzione per consentire il pagamento con carta in diverse valute. Per avere l'elenco completo delle valute supportate, visita la sezione Pagamenti Multivaluta del portale sviluppatori. Assicurati che questa opzione sia abilitata anche nella configurazione del tuo terminale. |
| Abilita pagamenti rateali | Questa funzionalità è disponibile solo per i commercianti con partita IVA greca. Abilita questa opzione per utilizzare i pagamenti rateali tramite XPay. Prima di abilitare questa funzionalità, assicurati che sia disponibile sul tuo terminale presso il tuo fornitore di servizi di pagamento. |
Configurazione Google Pay
È possibile abilitare Google Pay tramite due modalità:
- REDIRECT: opzione di default attivata in automatico da Nexi sul plugin. La scelta del pagamento reindirizza verso una pagina intermedia esterna del gateway XPay, da cui sarà possibile pagare con Google Pay. Non è richiesto il possesso di un account Google Merchant e l'utilizzo della Google Pay Business Console.
- PULSANTE: viene creato un bottone nativo Google Pay che permette il pagamento senza reindirizzamenti verso pagine intermedie esterne. Istruzioni per attivare questa modalità:
- Abilitare APM: verificare che il metodo di pagamento alternativo (APM) sia abilitato sul terminale accedendo al portale Nexi Business nella sezione XPay Back office selezionare Pagamenti Alternativi > Google Pay.
- Registrare il dominio: accedere al sito Google Pay Business Console e registrare il dominio del negozio (API Google Pay > Integrate with your website). Google deve approvare il sito prima di poter procedere. Se non si possiede un account Google Merchant, crearne uno durante la procedura.
-
Inserire i dati del merchant: una volta approvato il dominio, recuperare i seguenti dati dalla console di Google Pay:
- Google Merchant Name
- Google Merchant ID
- Impostare il Gateway Merchant ID: inserire in questo campo un codice univoco; si consiglia di utilizzare un generatore di codici UUID online.
Campo Descrizione Google merchant name Dato fornito da Google nella console di Google Pay. Google merchant Id Dato fornito da Google nella console di Google Pay. Google gateway merchant Id Inserire in questo campo un codice univoco; si consiglia di utilizzare un generatore di codici UUID online. Tipo di pulsante Google mette a disposizione diversi stili per il bottone di pagamento Google Pay. Per maggiori informazioni ed un'anteprima delle diverse tipologie, consultare la pagina Brand guidelines. Colore del pulsante Colore dello sfondo del bottone Google Pay. Per maggiori informazioni ed un'anteprima delle diverse tipologie, consultare la pagina Brand guidelines.
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:
- Effettuare il login nel pannello amministrativo di Wordpress.
- Nella barra di navigazione a sinistra selezionare Plugin > Plugin installati.
- Nella nuova pagina cercare il plugin Nexi nell'elenco e cliccare su Impostazioni.
- Disabilitare la modalità TEST e inserire l'API Key generata su Nexi Business
- Salvare la nuova configurazione
È consigliato effettuare una prova di pagamento con carta reale con il passaggio in produzione.
Metodi di pagamento
Il plugin Nexi mette a disposizione ai clienti diverse modalità di pagamento:
Pagamento tramite carte
Con questa soluzione il cliente resta sull'e-commerce dell'esercente fino al momento del checkout. Viene reindirizzato in ambiente Nexi per effettuare il pagamento per poi tornare sul sito dell'esercente al termine della transazione.
Pagamento OneClick
L'integrazione di questa soluzione consente al cliente finale di memorizzare i dati della propria carta di credito, ed utilizzarli successivamente per effettuare gli acquisti con pochi click.
Nel caso di primo pagamento XPay mostrerà il form per l'inserimento dei dati della carta mentre nel caso di pagamenti successivi mostrerà i dati della carta precedentemente inseriti oppure la possibilità di inserire i dati di una nuova carta.
Non disponibile nella tipologia di integrazione Build con checkout incorporato.
Pagamento ricorrente
Questa soluzione permette di acquistare prodotti con addebiti ricorrenti (es. abbonamenti).
In fase di primo pagamento viene assegnato un token che consente a Nexi di salvare l'abbinamento tra l'utente e la carta di pagamento utilizzata.
I pagamenti successivi verranno eseguiti automaticamente nella data prestabilita nelle impsotazione del prodotto subscription.
Per utilizzare questa modalità è necessario installare il plugin Woocommerce Subscription.
Pay-By-Link
Questa soluzione prevede di generare un ordine lato Woocommerce, selezionando gli opportuni prodotti e il cliente che desidera effettuare l'acquisto.
Verrà inviata una mail al cliente contenente un link per effettuare il pagamento. Il cliente verrà reindirizzato verso la pagina di checkout del sito ecommerce.
Metodi di pagamento alternativi (APM)
Il plugin mette a disposizione diversi metodi di pagamento alternativi. Selezionando il metodo desiderato il cliente verrà reindirizzato verso la pagina di checkout del servizio di pagamento scelto. Di seguito una lista dei metodi di pagamento supportati:
- Google Pay
- Apple Pay
- PayPal
- PayPal - Paga in 3 rate
- Bancomat Pay
- MyBank
- Giropay
- iDEAL
- Bancontact
- Multibanco
Una volta abilitato un nuovo metodo di pagamento da back office XPay, sarà necessario effettuare una salvataggio nella configurazione del plugin per aggiornare la lista degli APM e mostrare nel checkout del sito ecommerce il nuovo metodo di pagamento.
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 Woocommerce. Di seguito le operazioni da eseguire:
- Effettuare il login nel pannello amministrativo di Wordpress.
- Nella barra di navigazione a sinistra selezionare Woocommerce > Ordini.
- Cliccare sull'ordine da rimborsare.
- Nella sezione Prodotto cliccare sul bottone Rimborsa e selezionare i prodotti da rimborsare.
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.
Di seguito le operazioni da eseguire:
- Effettuare il login nel pannello amministrativo di Wordpress.
- Nella barra di navigazione a sinistra selezionare Woocommerce > Ordini.
- Cliccare sull'ordine da contabilizzare.
- Nella sezione Dettagli pagamenti XPay inserire l'importo da stornare e cliccare sul bottone Contabilizza.