VibeFox SimplePay for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

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

PHP: 8.0 o successivo.

Valuta del negozio: HUF, EUR o USD. SimplePay non accetta altre valute e per esse il metodo di pagamento non viene offerto.

Account commerciante SimplePay: SimplePay fornisce un account commerciante separato per ogni valuta, e account separati per live e sandbox. Per ogni account ti servono il suo MERCHANT e la sua SECRET KEY dal pannello commerciante di SimplePay (admin.simplepay.hu per live, sandbox.simplepay.hu per sandbox), account > Dati tecnici. Se vendi solo in HUF, basta l'account HUF. Non servono altre chiavi.

Chiave di licenza VibeFox: acquistabile 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. In alternativa puoi caricare la cartella wcp_simplepay_gateway in /wp-content/plugins/ tramite FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > SimplePay (OTP) > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugin.

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

5. Inserisci MERCHANT e SECRET KEY dei tuoi account SimplePay per ogni valuta in cui vendi: account sandbox per le prove e account live per i pagamenti reali (vedi Configurazione).

6. Copia l'IPN URL mostrato nella pagina delle impostazioni in ogni account commerciante (live e sandbox) del pannello SimplePay.

7. Attiva Enable/Disable, prova un pagamento con Sandbox mode attivo, poi disattiva Sandbox mode per accettare pagamenti reali.

Quando aggiorni dalla versione 1.0, il Merchant ID e la Secret key unici della 1.0 vengono trasferiti nell'account della valuta del negozio, nella modalità che era attiva (sandbox o live). Controlla gli account dopo l'aggiornamento.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > SimplePay (OTP). Sopra i campi la pagina ti avvisa quando la valuta del negozio non è supportata da SimplePay, o quando la valuta del negozio non ha un account commerciante nella modalità attuale. In entrambi i casi il metodo di pagamento non viene offerto per gli ordini in quella valuta. Finché la modalità sandbox è attiva, la pagina mostra Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. Nell'elenco dei metodi di pagamento, SimplePay è segnalato come da configurare finché la modalità attuale non ha almeno un account commerciante.

Generali

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

Title: il nome del metodo di pagamento che il cliente vede al checkout. Predefinito: SimplePay (Card Payment).

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely with your credit or debit card via SimplePay. I commercianti ungheresi devono mostrare al checkout la dichiarazione di trasferimento dati di SimplePay (Adattovábbítási nyilatkozat). Puoi inserirla qui, con il suo link.

Sandbox mode: Use the SimplePay sandbox invia i pagamenti alla sandbox di SimplePay e usa gli account sandbox. Cambia sia l'indirizzo dell'API sia gli account commerciante. Non viene addebitato denaro reale. Predefinito: attivo. Deseleziona per accettare pagamenti reali con gli account live.

Account commerciante live

Gli account usati quando Sandbox mode è disattivato. Compila gli account delle valute in cui vende il tuo negozio. I valori di MERCHANT e SECRET KEY si trovano nel pannello commerciante di SimplePay (admin.simplepay.hu), account > Dati tecnici. Un account viene usato solo quando entrambi i campi sono compilati.

HUF account — Merchant ID: il MERCHANT del tuo account live HUF.

HUF account — Secret key: la SECRET KEY del tuo account live HUF.

EUR account — Merchant ID e EUR account — Secret key: lo stesso per il tuo account live EUR.

USD account — Merchant ID e USD account — Secret key: lo stesso per il tuo account live USD.

Account commerciante sandbox

Gli account usati quando Sandbox mode è attivo. I campi sono gli stessi degli account live: HUF account — Merchant ID, HUF account — Secret key e le stesse coppie per EUR e USD. Prendi i valori dal pannello commerciante sandbox di SimplePay (sandbox.simplepay.hu), account > Dati tecnici.

IPN URL

L'IPN è il messaggio che SimplePay invia al tuo negozio quando cambia lo stato del pagamento. È il modo normale con cui un ordine diventa pagato. La pagina delle impostazioni mostra l'IPN URL del tuo negozio. Ha questo aspetto: https://your-site/wc-api/simplepay_payment_callback/. Imposta questo URL per ogni account commerciante, live e sandbox, nel pannello SimplePay. Se il tuo sito usa un prefisso di lingua negli URL o reindirizza altri indirizzi, copia l'URL esattamente come lo mostrano le impostazioni, perché un IPN reindirizzato va perso.

L'IPN deve essere firmato con la SECRET KEY dell'account commerciante che indica. Gli IPN senza firma valida vengono rifiutati. Il plugin conferma a SimplePay ogni IPN valido nella forma firmata richiesta da SimplePay. Questi stati dell'IPN modificano l'ordine:

Gli stati Non riuscito e Annullato vengono impostati solo per l'ultimo tentativo di pagamento di un ordine ancora In attesa di pagamento. Gli altri stati vengono registrati e non modificano l'ordine. Senza IPN, un ordine viene confermato solo quando il cliente torna nel negozio dopo un pagamento riuscito.

Ordini

Order Status After Payment: lo stato dell'ordine impostato dopo un pagamento riuscito. Lo stato viene impostato subito, senza un secondo cambio di stato.

Avanzate

Logging: Enable logging scrive chiamate API, IPN e ritorni in WooCommerce > Status > Logs, origine wcp_simplepay_gateway. Chiavi e dati dei clienti non vengono registrati. Gli errori vengono sempre registrati, anche quando l'opzione è disattivata. Predefinito: disattivato.

Delete Data on Uninstall: Remove all plugin data when uninstalling. Quando è attivo, eliminare il plugin rimuove le impostazioni del gateway e i registri del plugin. I dati degli ordini vengono sempre conservati. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita SimplePay (Card Payment)) e invia l'ordine. Il plugin avvia un pagamento con carta SimplePay per il totale dell'ordine nella valuta dell'ordine, con l'account commerciante di quella valuta nella modalità attuale, e invia il cliente alla pagina di pagamento di SimplePay. La pagina mostra ciò che il tuo account commerciante consente per i pagamenti con carta. L'e-mail del cliente e, quando è completo, l'indirizzo di fatturazione vengono passati a SimplePay. La pagina di pagamento usa la lingua del tuo sito quando SimplePay la supporta, altrimenti l'inglese. Un pagamento avviato può essere completato entro 30 minuti.

Dopo un pagamento riuscito il cliente torna alla pagina di ricezione dell'ordine del tuo negozio. Il ritorno da solo non paga mai un ordine: il plugin chiede a SimplePay lo stato della transazione con una richiesta firmata, quindi l'ordine viene confermato anche se l'IPN arriva in ritardo. La pagina di ricezione dell'ordine mostra Successful transaction. SimplePay transaction ID: e l'ID. Se il pagamento non è ancora confermato, mostra Your payment is being confirmed by SimplePay. SimplePay transaction ID: e l'ID.

Se il pagamento non riesce, viene annullato o scade, il cliente torna al checkout oppure, se il carrello è vuoto, alla pagina Pay for order. Lì il cliente vede il messaggio di SimplePay con l'ID transazione, per esempio Cancelled payment. You cancelled the payment oppure Timeout. The time allowed to complete the payment has expired. In caso di pagamento non riuscito, il cliente è invitato a controllare i dati inseriti e a contattare la banca che ha emesso la carta. Il cliente può riprovare. Ogni nuovo tentativo riceve un proprio riferimento SimplePay, per esempio 123, 123-2, 123-3.

Se SimplePay non riesce ad avviare il pagamento, il cliente vede The SimplePay payment could not be started. Please try again or choose another payment method. Se la valuta dell'ordine non ha un account commerciante, il messaggio è SimplePay is not available for the currency of this order. Please choose another payment method. Il motivo tecnico viene aggiunto alle note dell'ordine e al registro. I gestori del negozio che hanno effettuato l'accesso lo vedono anche nel messaggio.

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 accetta solo pagamenti con carta singoli, addebitati nella pagina di SimplePay. Non prevede carte salvate o pagamenti con un clic, abbonamenti o pagamenti ricorrenti, né autorizzazione e cattura separate.

Ordini e rimborsi

Stati dell'ordine

Pending payment: il cliente è stato inviato a SimplePay e non ha ancora pagato, oppure SimplePay non ha ancora confermato il pagamento. La nota dell'ordine mostra la transazione avviata, l'importo e la modalità (sandbox o live).

Processing or Completed: il pagamento è confermato. Lo stato segue Order Status After Payment. La nota dell'ordine mostra l'ID transazione e se a confermare il pagamento sono stati l'IPN o la richiesta di stato. L'ID transazione SimplePay viene salvato come ID transazione dell'ordine. Un pagamento riuscito in ritardo completa anche un ordine che era Non riuscito o Annullato.

On hold: il totale o la valuta dell'ordine sono stati cambiati dopo l'avvio del pagamento, quindi l'importo pagato non corrisponde all'ordine. La nota dell'ordine mostra entrambi gli importi. Controlla l'ordine ed evadilo oppure rimborsa il pagamento.

Failed: SimplePay ha segnalato l'ultimo tentativo di pagamento come non autorizzato o frode.

Cancelled: SimplePay ha segnalato che l'ultimo tentativo di pagamento è scaduto o è stato annullato.

Un ordine rimborsato o completato non viene mai riaperto da un IPN tardivo. Se un secondo pagamento riesce per un ordine già pagato, l'ordine non viene modificato di nuovo. Una nota ti chiede di verificarlo nel pannello SimplePay e di rimborsarlo se è un duplicato.

Rimborsi

Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via SimplePay (OTP). Sono supportati rimborsi totali e parziali. I rimborsi in HUF devono essere in fiorini interi. Il rimborso viene inviato con l'account commerciante e nella modalità (sandbox o live) con cui è stato effettuato il pagamento, quindi quell'account deve essere ancora presente nelle impostazioni. Se SimplePay non accetta il rimborso, WooCommerce mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto alle note dell'ordine con l'ID transazione del rimborso SimplePay e il motivo, se ne hai inserito uno.

I rimborsi effettuati nel pannello commerciante di SimplePay non vengono sincronizzati con WooCommerce. Registrali manualmente in WooCommerce, senza usare Refund via SimplePay (OTP).

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 > SimplePay (OTP). 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 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 suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, SimplePay 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 provare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugin 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 supporto richiedono il rinnovo. Lo stato viene ricontrollato automaticamente in background.

Risoluzione dei problemi

SimplePay non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che la valuta dell'ordine sia HUF, EUR o USD e che quella valuta abbia sia Merchant ID sia Secret key nella modalità attuale: gli account sandbox mentre Sandbox mode è attivo, gli account live mentre è disattivo. La pagina delle impostazioni mostra un avviso quando la valuta del negozio non ha un account.

Il pagamento è andato a buon fine, ma l'ordine resta In attesa di pagamento: l'IPN non è arrivato al negozio. Nel pannello commerciante di SimplePay controlla l'IPN URL dell'account commerciante che usi (live o sandbox, valuta dell'ordine). Deve essere esattamente l'URL mostrato nelle impostazioni, e il tuo server deve essere raggiungibile da internet. L'ordine viene confermato anche quando il cliente torna nel negozio dopo il pagamento.

L'IPN risponde Invalid signature: l'IPN indica un account commerciante che non è nelle impostazioni, oppure la sua Secret key è errata. Inserisci MERCHANT e SECRET KEY esattamente come li mostra il pannello commerciante di SimplePay. SimplePay ripete gli IPN non confermati.

L'IPN risponde Order not found o Unknown transaction: l'IPN riguarda un ordine o una transazione che questo negozio non ha avviato. L'ordine non viene modificato.

L'IPN risponde Busy, retry: l'ordine era in fase di conferma da un'altra richiesta nello stesso momento. SimplePay ripete l'IPN.

Il cliente vede un errore quando invia l'ordine: apri le note dell'ordine oppure controlla WooCommerce > Status > Logs, origine wcp_simplepay_gateway. Una secret key errata dà Invalid response signature from SimplePay. Check the secret key of the merchant account. Gli errori di SimplePay vengono mostrati come SimplePay error code(s): seguito dai codici.

Dopo il passaggio tra sandbox e live: i nuovi pagamenti usano gli account della nuova modalità. Gli ordini avviati prima mantengono l'account commerciante e la modalità con cui sono stati avviati: i loro IPN, le richieste di stato e i rimborsi usano quell'account. Mantieni nelle impostazioni gli account della vecchia modalità finché questi ordini sono aperti o possono essere rimborsati.

L'ordine passa a In attesa dopo il pagamento: leggi la nota dell'ordine. Il totale o la valuta dell'ordine sono stati modificati dopo l'avvio del pagamento. Evadi l'ordine oppure rimborsa il pagamento.

Il rimborso non riesce: leggi il messaggio. SimplePay refunds in HUF must be whole amounts. significa che l'importo in HUF aveva dei decimali. Se il messaggio dice che l'account commerciante di questo pagamento non è configurato, inserisci di nuovo l'account (valuta e modalità) con cui il pagamento è stato effettuato. Se SimplePay ha rimborsato un importo diverso, il messaggio ti chiede di controllare il rimborso nel pannello SimplePay.

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 mantiene tutti i dati. Per rimuoverlo, disattivalo ed eliminalo dalla pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway e i registri del plugin vengono rimossi solo se Delete Data on Uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Gli ordini esistenti conservano le note di pagamento, gli ID transazione e i dati SimplePay.

SimplePay è un marchio registrato del rispettivo titolare. Questo plugin non è affiliato né approvato da SimplePay.