VibeFox MultiSafepay for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 7.0 o successivo, installato e attivo. Il plugin non si attiva senza WooCommerce.

PHP: 8.0 o successivo.

Valuta: la valuta del negozio o dell'ordine deve essere una di quelle accettate da MultiSafepay, ad esempio EUR, USD, GBP, PLN, CHF, SEK, DKK o NOK. Per le altre valute, il metodo di pagamento viene nascosto al checkout.

Account MultiSafepay: ti serve la chiave API del tuo sito web in MultiSafepay Control. Gli account di test e live hanno chiavi diverse. Non c'è altro da configurare in MultiSafepay: l'indirizzo di notifica viene inviato con ogni pagamento.

Sito pubblico: MultiSafepay deve poter raggiungere il tuo sito per inviare le notifiche. In caso contrario, gli ordini vengono comunque aggiornati quando il cliente torna da MultiSafepay.

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

Installazione

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

2. Fai clic su Activate.

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

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

5. Incolla la chiave API di test e/o live di MultiSafepay Control (vedi Configurazione).

6. Attiva Enable/Disable e salva. Prova un pagamento con Test mode attivo, poi disattivalo per accettare pagamenti reali.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > MultiSafepay. Il titolo della pagina mostra un distintivo Test mode mentre la modalità test è attiva. Sopra i campi, la pagina ti avvisa quando la modalità corrente non ha una chiave API (in tal caso il metodo di pagamento non viene mostrato al checkout) o quando MultiSafepay non accetta la valuta del negozio. Nell'elenco dei metodi di pagamento, MultiSafepay risulta da configurare finché la modalità corrente non ha una chiave API.

Checkout

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

Title: il nome del metodo di pagamento che il cliente vede al checkout. Predefinito: MultiSafepay.

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

Chiavi API

La chiave API si trova in MultiSafepay Control > Manage settings > Website settings. L'account di test (testmerchant.multisafepay.com) e quello live (merchant.multisafepay.com) hanno chiavi diverse. La modalità test usa solo la chiave di test, la modalità live solo la chiave live.

Test mode: Use the MultiSafepay test environment (no real payments). Cambia sia l'indirizzo dell'API sia la chiave API. I pagamenti già effettuati continuano a usare l'ambiente in cui sono stati fatti per i controlli di stato e i rimborsi. Predefinito: attivo.

Test API key: la chiave API del tuo account di test MultiSafepay.

Live API key: la chiave API del tuo account live MultiSafepay.

Notifiche

Non c'è nulla da configurare. Questa sezione mostra l'URL di notifica, che viene inviato a MultiSafepay con ogni pagamento. Ha un aspetto simile a https://your-site/?wc-api=mspg_webhook. MultiSafepay deve poter raggiungere il tuo sito. Una notifica indica solo al plugin quale pagamento è cambiato: stato, importo e valuta vengono sempre letti dall'API di MultiSafepay con la tua chiave API prima che un ordine venga modificato. Le notifiche relative a pagamenti che non appartengono a un ordine del tuo negozio vengono ignorate.

Ordini

Order status after payment: lo stato di un ordine pagato. Lo stato viene impostato subito, con un solo cambio di stato e un'unica e-mail al cliente.

Avanzate

Debug log: Log API calls and notifications scrive i dettagli in WooCommerce > Status > Logs, origine wcp_multisafepay_gateway. Gli errori vengono sempre registrati. Chiavi API e dati dei clienti non vengono registrati. Predefinito: disattivato.

Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Disattivare il plugin non cancella mai nulla. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita MultiSafepay) e invia l'ordine. Il plugin crea un pagamento MultiSafepay per il totale dell'ordine nella valuta dell'ordine e invia il cliente alla pagina di pagamento di MultiSafepay. Lì il cliente sceglie un qualsiasi metodo di pagamento attivo nel tuo account MultiSafepay e paga. I dati di fatturazione del cliente e la lingua del negozio vengono trasmessi a MultiSafepay, e il pagamento compare come Order #, il numero dell'ordine e il nome del tuo sito. In modalità test il checkout mostra Test mode: no real payment will be made.

Le scorte vengono riservate mentre il cliente paga, e il carrello viene conservato fino alla pagina di ordine ricevuto. Dopo il pagamento, il cliente torna alla pagina di ordine ricevuto del tuo negozio. L'ordine viene segnato come pagato solo dopo la conferma di MultiSafepay: tramite la notifica o con un controllo tramite l'API di MultiSafepay quando il cliente arriva su quella pagina.

Se il cliente annulla sulla pagina di MultiSafepay durante il checkout, l'ordine viene annullato nel modo standard di WooCommerce, le scorte vengono rilasciate e i prodotti restano nel carrello. Se il cliente stava pagando dalla pagina Pay for order, torna a quella pagina, che spiega cosa è successo: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. oppure The payment session has expired. Please try again.

Un cliente può pagare di nuovo un ordine non pagato. Prima di creare un nuovo pagamento, il plugin controlla il precedente su MultiSafepay. Se è già pagato, l'ordine viene confermato. Se è ancora aperto con lo stesso importo, viene riutilizzata la stessa pagina di pagamento. Se l'importo è cambiato, il pagamento precedente viene annullato su MultiSafepay, così non può più essere pagato.

Se MultiSafepay non riesce ad avviare il pagamento, il cliente vede un breve messaggio, ad esempio Could not connect to MultiSafepay. Please try again in a moment. oppure MultiSafepay cannot accept this order amount or currency. Please choose another payment method., e può scegliere un altro metodo di pagamento. L'errore di MultiSafepay viene aggiunto alle note dell'ordine.

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 offre un unico metodo di pagamento che porta alla pagina di MultiSafepay. Non ci sono metodi di pagamento WooCommerce separati per ogni metodo MultiSafepay, né campi carta integrati, né pulsanti express Apple Pay o Google Pay, né abbonamenti, pagamenti ricorrenti o carte salvate, e non è possibile catturare o annullare da WooCommerce. Non viene inviato alcun dato del carrello, quindi MultiSafepay non offre per questi ordini i metodi di pagamento differito che ne hanno bisogno (ad esempio Klarna, in3 o Riverty).

Ordini e rimborsi

Stati dell'ordine

Pending payment: il cliente è stato inviato a MultiSafepay e non ha ancora pagato.

Processing o Completed: MultiSafepay ha confermato il pagamento (completato o spedito). Lo stato segue Order status after payment. La nota dell'ordine mostra l'ID del pagamento MultiSafepay, il metodo di pagamento e l'ambiente. L'ID della transazione è l'ID dell'ordine MultiSafepay del pagamento.

On hold before payment: il pagamento non è regolato (in verifica da parte di MultiSafepay) o è riservato (autorizzato). Cattura un pagamento riservato in MultiSafepay Control per ricevere il denaro. L'ordine viene completato automaticamente quando MultiSafepay lo segnala come pagato.

On hold after payment: MultiSafepay ha confermato un importo o una valuta diversi dal totale dell'ordine, un pagamento di prova è stato completato mentre il negozio è in modalità live (non è stato ricevuto denaro reale), oppure il pagamento è stato completato dopo l'annullamento dell'ordine. La nota dell'ordine lo spiega. Controlla la transazione in MultiSafepay Control ed evadi o rimborsa manualmente l'ordine.

On hold after a chargeback: MultiSafepay ha segnalato uno storno per un ordine pagato: il denaro è stato prelevato dal tuo conto.

Failed: l'ultimo pagamento di un ordine non pagato è stato rifiutato, annullato, scaduto o invalidato (void). Le scorte trattenute vengono rilasciate. Il cliente può riprovare.

Un ordine pagato, rimborsato o annullato non viene mai riaperto da una notifica tardiva. Se per un ordine già pagato viene completato un secondo pagamento, l'ordine non viene modificato di nuovo. Una nota ti chiede di rimborsare il duplicato in MultiSafepay Control.

Rimborsi

Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via MultiSafepay. Sono supportati rimborsi totali e parziali per gli ordini pagati tramite MultiSafepay. Il rimborso viene inviato all'ambiente in cui è stato effettuato il pagamento (test o live), quindi la chiave API di quell'ambiente deve essere impostata. Se MultiSafepay non accetta il rimborso, WooCommerce mostra l'errore di MultiSafepay e nessun rimborso viene registrato. Una richiesta riuscita viene aggiunta alle note dell'ordine con l'ID del rimborso MultiSafepay.

I rimborsi effettuati in MultiSafepay Control vengono aggiunti alle note dell'ordine quando MultiSafepay li segnala. Non vengono registrati automaticamente come rimborsi WooCommerce. Se necessario, crea un rimborso manuale in WooCommerce senza usare Refund via MultiSafepay.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza si trova in cima a WooCommerce > Settings > Payments > MultiSafepay. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, ad esempio la data fino alla quale la licenza è attiva e il tuo dominio. Usa Check now per controllare 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 solo dominio. Rimuovere la chiave da un sito non libera il posto del dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, MultiSafepay 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 con (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: i pagamenti già avviati vengono comunque confermati e i rimborsi funzionano.

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

Risoluzione dei problemi

MultiSafepay non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo, che la modalità corrente abbia una chiave API (Test API key in modalità test, Live API key in modalità live) e che la valuta del negozio o dell'ordine sia accettata da MultiSafepay. La pagina delle impostazioni mostra un avviso quando la chiave manca o la valuta non è accettata.

Il pagamento è andato a buon fine, ma l'ordine resta in Pending payment: la notifica non è arrivata al tuo negozio. Verifica che il sito sia raggiungibile da internet e che la chiave API dell'ambiente del pagamento sia impostata, perché il plugin legge lo stato dall'API di MultiSafepay. Se l'API non è raggiungibile, la notifica risponde ERROR e MultiSafepay la ripete. L'ordine viene aggiornato anche quando il cliente torna alla pagina di ordine ricevuto e quando prova a pagare di nuovo lo stesso ordine.

Il cliente vede un errore quando effettua l'ordine: apri le note dell'ordine oppure attiva Debug log e controlla WooCommerce > Status > Logs, origine wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. di solito indica una chiave API errata o mancante. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. significa che MultiSafepay ha rifiutato l'importo o la valuta.

L'ordine è On hold after payment: leggi la nota dell'ordine. Il pagamento può essere non regolato o riservato, l'importo o la valuta pagati possono differire dall'ordine, un pagamento di prova può essere arrivato in modalità live, il pagamento può essere stato completato dopo l'annullamento dell'ordine o può esserci uno storno. Controlla la transazione in MultiSafepay Control.

I pagamenti di prova non confermano un ordine reale: un pagamento di prova non salda mai un ordine mentre il negozio è in modalità live; l'ordine viene invece messo in attesa. I pagamenti di prova precedenti continuano a essere verificati e rimborsati con la chiave di test dopo il passaggio al live.

Il rimborso non riesce con un messaggio sull'ambiente: il pagamento è stato effettuato nell'ambiente di test o live, e la chiave API di quell'ambiente non è impostata. Inseriscila e riprova.

Il blocco di licenza mostra un errore: segui il messaggio nel blocco. Ad esempio, se la chiave è già usata su un altro dominio, libera un posto 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 della licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway, i dati MultiSafepay salvati sugli ordini e i registri vengono rimossi solo se Delete data on uninstall era attivo. Altrimenti restano per una futura reinstallazione. Gli ordini esistenti conservano le note di pagamento e gli ID di transazione.

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