VibeFox Moneris for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 8.0 o successivo, installato e attivo. Senza WooCommerce il plugin non si attiva.

PHP: 8.0 o successivo.

Valuta del negozio: CAD per un account Moneris canadese, USD per un vecchio account Moneris USA. Il gateway viene mostrato solo quando la valuta dell'ordine corrisponde a quella dell'account.

HTTPS e PCI DSS: i numeri di carta vengono inseriti nel checkout e transitano dal tuo server. I pagamenti reali richiedono HTTPS e la conformità a PCI DSS SAQ D. Se non puoi garantirla, usa invece una soluzione con pagina di pagamento ospitata.

Account Moneris: ti servono Store ID e API Token del tuo negozio Moneris Gateway, che trovi nel Moneris Merchant Resource Center > Admin > Store Settings. Per i test è già inserito il negozio di test pubblico di Moneris. Le credenziali di test e le carte di test si trovano nel portale per sviluppatori di Moneris.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un dominio.

Installazione

1. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. In alternativa puoi caricare la cartella wcp_moneris_gateway in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > Moneris > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.

4. Inserisci la chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Scegli il paese dell'account e inserisci il Live Store ID e il Live API Token. La modalità test è attiva di default e usa il negozio di test pubblico (store5 / yesguy per il Canada, monusqa002 / qatoken per gli USA).

6. Scegli Purchase o Pre-Authorization e i loghi delle carte, poi attiva Enable / Disable.

7. Effettua un ordine di prova con una carta di test Moneris, poi deseleziona Test mode.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > Moneris. Sopra i campi la pagina mostra Moneris gateway is in TEST MODE. No real charges will be made. finché la modalità test è attiva. In modalità live avvisa se i campi live contengono credenziali di test Moneris (in tal caso il gateway viene nascosto al checkout) e se il sito non usa HTTPS. Avvisa anche se la valuta del negozio non è quella dell'account Moneris; il gateway viene allora nascosto al checkout.

Generali

Enable / Disable: Enable Moneris Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che vede il cliente. Predefinito: Credit card (Moneris). In modalità test, al checkout viene aggiunto (Test Mode) al titolo.

Description: il testo mostrato sopra i campi della carta al checkout. Predefinito: Pay securely with your credit card.

Account Moneris

Lo Store ID e l'API Token si trovano nel Moneris Merchant Resource Center, in Admin > Store Settings. Le credenziali di test e le carte di test si trovano nel portale per sviluppatori di Moneris. La sezione contiene i link a entrambi.

Moneris account country: gli account canadesi addebitano in CAD, quelli statunitensi in USD. Il gateway viene mostrato solo quando la valuta dell'ordine corrisponde. Predefinito: Canada (CAD).

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). Rimborsi, acquisizioni e annullamenti vengono sempre inviati all'ambiente in cui è avvenuto il pagamento. I clienti vedono TEST MODE: use a Moneris test card, no real charges are made. sopra i campi della carta. Predefinito: attivo.

Live Store ID: lo Store ID di produzione, per esempio monca01234.

Live API Token: l'API Token di produzione.

Test Store ID: il negozio di test pubblico di Moneris: store5 (Canada) o monusqa002 (USA). Predefinito: store5.

Test API Token: il token di test pubblico: yesguy (Canada) o qatoken (USA). Predefinito: yesguy.

Pagamento

Transaction type: come viene addebitata la carta. Predefinito: Purchase.

Card logos: i loghi dei marchi di carta mostrati accanto al titolo del metodo di pagamento: Visa, Mastercard, Discover, American Express, JCB. I marchi accettati dipendono dal tuo account Moneris. Predefinito: Visa and Mastercard.

Avanzate

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Gli errori vengono sempre registrati. Il registro si trova in WooCommerce > Status > Logs, origine wcp_moneris_gateway. Predefinito: disattivato.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per default Credit card (Moneris)) e inserisce numero della carta, data di scadenza e codice di sicurezza nel modulo carta di WooCommerce nel checkout del tuo negozio. Quando l'ordine viene effettuato, il tuo server invia la carta a Moneris per il totale dell'ordine e ottiene il risultato subito. Non ci sono reindirizzamenti né webhook. Il codice di sicurezza (CVD) viene sempre inviato, quindi si applicano ancora le regole eFraud del tuo negozio Moneris.

Un pagamento approvato viene segnato come pagato solo quando Moneris comunica che la transazione è completata e l'importo elaborato corrisponde al totale dell'ordine. Il cliente arriva poi alla pagina di conferma dell'ordine. Con Pre-Authorization l'ordine resta In attesa finché non acquisisci i fondi.

Se la carta viene rifiutata, il cliente vede Your card was declined con il motivo indicato da Moneris e può controllare i dati della carta oppure usarne un'altra. Se Moneris non riesce a elaborare la richiesta (per esempio per uno Store ID o un API Token errati), il cliente vede The payment could not be processed. Please try again or use another payment method. Il motivo viene aggiunto alle note dell'ordine e al registro. Un secondo clic mentre un pagamento è in corso mostra A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Un ordine pagato o pre-autorizzato non viene mai riaddebitato.

Se Moneris non risponde (errore di rete o timeout), il plugin invia a Moneris uno Status Check per verificare se la transazione è andata a buon fine. Se anche questo non è possibile, l'ordine passa In attesa con l'ID dell'ordine Moneris e il cliente non viene invitato a pagare una seconda volta.

Il metodo di pagamento funziona nel checkout classico, nel blocco Checkout e nella pagina Pay for order. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin non prevede carte salvate né Moneris Vault, né WooCommerce Subscriptions, né Apple Pay, Google Pay o Interac Online, né Moneris Checkout o Hosted Tokenization, né 3-D Secure, AVS o Kount, né prezzi in più valute.

Ordini e rimborsi

Stati dell'ordine

In attesa di pagamento: l'ordine è stato creato e la carta non è ancora stata addebitata, per esempio dopo un tentativo rifiutato. La nota dell'ordine mostra il codice e il messaggio di Moneris. Il cliente può pagare di nuovo.

In lavorazione: l'acquisto è stato approvato. Gli ordini con solo prodotti virtuali scaricabili passano a Completato, l'impostazione predefinita di WooCommerce. La nota dell'ordine mostra l'importo, l'ID della transazione Moneris e la ricevuta. L'ID della transazione è il numero di transazione Moneris.

In attesa: una pre-autorizzazione è stata approvata e attende l'acquisizione, l'importo elaborato era diverso dal totale dell'ordine, oppure Moneris non ha confermato il risultato. La nota dell'ordine lo spiega.

Annullato: per un ordine pre-autorizzato, l'annullamento rilascia i fondi riservati (void).

Acquisizione e annullamento

Per acquisire una pre-autorizzazione, porta lo stato dell'ordine a In lavorazione o Completato, oppure scegli Capture Moneris pre-authorization nelle azioni dell'ordine. Viene acquisito il totale attuale dell'ordine meno i rimborsi; non può superare l'importo autorizzato. Se Moneris rifiuta l'acquisizione, lo stato torna In attesa con una nota e non viene inviata alcuna e-mail di ordine in lavorazione o completato. Le pre-autorizzazioni Moneris scadono dopo alcuni giorni, quindi acquisiscile in tempo.

Per rilasciare i fondi, annulla l'ordine oppure scegli Void Moneris pre-authorization (cancel order) nelle azioni dell'ordine. Portare l'ordine a Rimborsato rilascia anche una pre-autorizzazione aperta. Se il rilascio fallisce, una nota ti chiede di rilasciarla nel Merchant Resource Center.

Rimborsi

Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via Credit card (Moneris) (il pulsante mostra il tuo Title). Sono supportati rimborsi totali e parziali. Una pre-autorizzazione può essere rimborsata solo dopo l'acquisizione; prima, annulla l'ordine per rilasciare i fondi. Il rimborso viene inviato all'ambiente e all'account in cui è avvenuto il pagamento, quindi le credenziali di quella modalità devono essere inserite. Se Moneris non accetta il rimborso, WooCommerce mostra Refund failed con il motivo e nessun rimborso viene registrato. Un rimborso riuscito viene aggiunto alle note dell'ordine con l'ID della transazione Moneris.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Payments > Moneris. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino alla quale la licenza è attiva, e il tuo dominio. Usa Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il link Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un dominio. Rimuovere la chiave da un sito non libera lo slot del dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Moneris non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. I gestori del negozio che hanno effettuato l'accesso vedono ancora il metodo di pagamento, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugins e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: acquisizioni, annullamenti e rimborsi continuano a funzionare.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente in background.

Risoluzione dei problemi

Moneris non compare al checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo e che la modalità corrente abbia uno Store ID e un API Token. In modalità live i campi live devono contenere le tue credenziali di produzione, non quelle di test Moneris. Controlla che la valuta del negozio (o la valuta dell'ordine nella pagina Pay for order) sia quella dell'account: CAD per il Canada, USD per un account USA. La pagina delle impostazioni mostra un avviso quando la valuta non corrisponde.

Il pagamento è andato a buon fine, ma l'ordine resta In attesa di pagamento o In attesa: il plugin non ha webhook; il risultato arriva solo dalla risposta di Moneris. Se l'ordine è In attesa con una nota che indica che Moneris non ha confermato il risultato, Moneris non ha risposto e anche lo Status Check è fallito. Cerca l'ID dell'ordine Moneris indicato nella nota nel Merchant Resource Center: se la transazione è presente, spedisci l'ordine (e rimborsalo lì se necessario); se non c'è, annulla l'ordine oppure chiedi al cliente di pagare di nuovo.

Il cliente vede Payment gateway is misconfigured. Please contact the store administrator.: mancano le credenziali della modalità corrente, oppure la modalità live è attiva con credenziali di test Moneris nei campi live. Inserisci il tuo Store ID e il tuo API Token di produzione.

Il cliente vede This payment method does not support the order currency.: la valuta dell'ordine non è quella dell'account Moneris.

Il cliente vede un errore durante il pagamento: apri le note dell'ordine oppure attiva Debug log e controlla WooCommerce > Status > Logs, origine wcp_moneris_gateway.

L'acquisizione non riesce: l'ordine non ha una pre-autorizzazione in attesa di acquisizione, il totale dell'ordine è zero, oppure l'importo è superiore a quello autorizzato. Inoltre le pre-autorizzazioni Moneris scadono dopo alcuni giorni.

Rimborso, acquisizione o annullamento non riesce con un messaggio su modalità o account: il pagamento è stato effettuato in modalità test o live e le credenziali di quella modalità non sono impostate, oppure il pagamento è stato fatto con un account Moneris dell'altro paese. Inserisci le credenziali oppure elabora il pagamento nel Merchant Resource Center.

Attacchi di card testing: i moduli carta diretti sono un bersaglio per il card testing. Attiva la limitazione delle richieste del checkout di WooCommerce, un plugin CAPTCHA e le regole eFraud o di velocità nel tuo account Moneris.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera uno slot nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Disinstallazione

Disattivare il plugin conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway e i registri vengono rimossi solo se Delete data on uninstall era attivo. Altrimenti restano disponibili per una reinstallazione futura. Gli ordini esistenti conservano le note di pagamento e gli ID delle transazioni.

Moneris è un marchio del rispettivo proprietario. Questo plugin non è affiliato a Moneris né approvato da Moneris.