VibeFox Autopay for WooCommerce — Guida
Requisiti
WordPress: 6.0 o successivo.
WooCommerce: 8.0 o successivo, installato e attivo.
PHP: 8.0 o successivo.
Servizio Autopay: ti servono il Service ID e la Shared key (chiave hash) del tuo servizio Autopay. Sono visibili nel portale commerciante Autopay: portal.autopay.eu per la produzione, testportal.autopay.eu per il test. I servizi di test hanno un proprio Service ID e una propria Shared key; chiedi ad Autopay di aprirne uno. La funzione hash del servizio deve essere SHA-256.
Valuta: la valuta del negozio deve essere PLN, EUR, GBP, USD o CZK e accettata dal tuo servizio Autopay.
Negozio raggiungibile: Autopay deve poter inviare notifiche al tuo negozio, quindi il sito deve essere raggiungibile da internet, senza modalità manutenzione, autenticazione di base o firewall che blocchi le richieste POST.
Chiave di licenza VibeFox: acquistata 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_autopay_payment in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Payments > Autopay > 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 Service ID e Shared key (test e produzione) e scegli le valute del tuo servizio.
6. Nel portale Autopay imposta l'ITN URL, il return URL e la funzione hash SHA-256 per il tuo servizio (vedi Configurazione).
7. Attiva Enable/Disable. Effettua un ordine di prova in modalità test, poi deseleziona Test mode per i pagamenti reali.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > Autopay. Sopra i campi la pagina ti avvisa quando il Service ID o la Shared key dell'ambiente selezionato sono vuoti, e quando la valuta del negozio non è selezionata in Currencies. In entrambi i casi il metodo di pagamento viene nascosto al checkout. Nell'elenco dei metodi di pagamento, Autopay risulta da configurare finché l'ambiente selezionato non ha le credenziali.
Generali
Enable/Disable: Enable Autopay payment gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.
Title: il nome del metodo di pagamento che i clienti vedono al checkout. Predefinito: Autopay.
Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.
Servizio Autopay
Il Service ID e la Shared key sono visibili nel portale commerciante Autopay (portal.autopay.eu oppure testportal.autopay.eu).
Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. Predefinito: attivato. Disattivalo per accettare pagamenti reali su pay.autopay.eu con le credenziali di produzione.
Service ID (production): l'identificativo numerico del servizio su portal.autopay.eu.
Shared key (production): la chiave hash del servizio di produzione. Tienila riservata.
Service ID (test): l'identificativo numerico del servizio su testportal.autopay.eu.
Shared key (test): la chiave hash del servizio di test.
Currencies: le valute accettate dal tuo servizio Autopay: PLN, EUR, GBP, USD, CZK. Di solito Autopay apre un servizio separato per ogni valuta. Il metodo di pagamento viene offerto solo quando la valuta dell'ordine è selezionata qui. Predefinito: PLN.
Notifiche di pagamento (ITN) e indirizzo di ritorno
Inserisci questi indirizzi nel portale Autopay per il tuo servizio, sia per la produzione sia per il test. Gli indirizzi esatti sono mostrati in questa sezione delle impostazioni.
Senza l'ITN URL gli ordini non vengono mai segnati come pagati. Ogni ITN viene verificato con l'hash SHA-256 generato con la Shared key del servizio corrispondente. Le notifiche senza un hash valido o con un Service ID sconosciuto vengono rifiutate. Una notifica viene applicata a un ordine solo se il pagamento per quell'ordine è stato avviato con lo stesso servizio Autopay. Le notifiche per pagamenti avviati prima che tu cambiassi Test mode vengono comunque verificate con la chiave giusta.
Il plugin gestisce questi stati di pagamento nell'ITN:
Avanzate
Logging: Log payment events scrive in WooCommerce > Status > Logs, origine wcp_autopay_payment. Chiavi e dati dei clienti non vengono mai registrati. Predefinito: disattivato.
Checkout
Il cliente sceglie il metodo di pagamento (per impostazione predefinita Autopay) e fa l'ordine. La pagina successiva mostra Thank you for your order. You are being redirected to Autopay to complete the payment. e invia il cliente alla pagina di pagamento Autopay. Se il cliente torna indietro con il pulsante Indietro del browser, la pagina mostra il pulsante Pay with Autopay invece di reindirizzare di nuovo.
Il plugin trasmette il totale dell'ordine nella valuta dell'ordine, il numero dell'ordine come descrizione (Order e il numero) e l'e-mail di fatturazione del cliente. Sulla pagina di Autopay il cliente sceglie il metodo di pagamento e paga.
Dopo il pagamento, il cliente torna alla pagina Ordine ricevuto. L'indirizzo di ritorno è firmato, ma non modifica mai lo stato dell'ordine. L'ordine viene segnato come pagato solo dopo che Autopay lo conferma con un ITN firmato e importo e valuta corrispondono all'ordine.
Se il pagamento non riesce, l'ordine diventa Failed e il cliente può pagare di nuovo dall'ordine con il link Pay. Se il pagamento non può essere avviato, il cliente vede un breve messaggio, per esempio Autopay payments are not configured. Please choose another payment method or contact the store. oppure che Autopay non può accettare pagamenti in questa valuta.
Il metodo di pagamento funziona con il checkout classico, con il blocco Checkout e nella pagina Pay for order. È compatibile con WooCommerce High-Performance Order Storage (HPOS).
Il plugin non gestisce rimborsi da WooCommerce, abbonamenti o pagamenti ricorrenti, carte salvate (1-Click), codice BLIK o modulo carta nella pagina di checkout, né la scelta della banca o del canale di pagamento nella pagina di checkout, e usa un solo Service ID per ambiente.
Ordini
Stati dell'ordine
Pending payment: il cliente è stato inviato ad Autopay e Autopay non ha ancora confermato il pagamento.
Processing or Completed: Autopay ha confermato il pagamento. WooCommerce imposta Processing, oppure Completed per gli ordini con solo prodotti virtuali scaricabili. La nota dell'ordine mostra importo, transazione Autopay e data del pagamento. L'ID transazione è l'ID transazione Autopay (RemoteID).
On hold: Autopay ha segnalato un importo o una valuta diversi dal totale dell'ordine. L'ordine non è stato segnato come pagato. Verifica la transazione nel portale Autopay e completa o rimborsa l'ordine manualmente.
Failed: il pagamento non è riuscito. Il cliente può pagare di nuovo dall'ordine.
Un ordine pagato non viene mai modificato da una notifica di fallimento successiva. Se Autopay segnala un altro pagamento riuscito per un ordine già pagato, una nota avvisa che il cliente potrebbe aver pagato due volte. Una notifica per un pagamento avviato con un altro servizio Autopay non viene applicata, e una nota lo spiega.
Rimborsi
I rimborsi da WooCommerce non sono supportati. Effettua il rimborso del pagamento nel portale Autopay, poi registralo in WooCommerce con un rimborso manuale.
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 > Autopay. 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 solo dominio. Rimuovere la chiave da un sito non libera il posto del dominio. Liberalo nel tuo account vibefox.net.
Senza una chiave attiva, il metodo di pagamento Autopay 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 da (unlicensed — visible to admins only), così puoi configurare e testare 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.
Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato automaticamente in background.
Risoluzione dei problemi
Autopay non appare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che l'ambiente selezionato abbia un Service ID e una Shared key e che la valuta del negozio sia selezionata in Currencies. La pagina delle impostazioni mostra un avviso quando manca una di queste voci.
Il pagamento è andato a buon fine, ma l'ordine resta Pending payment: Autopay non ha consegnato l'ITN, oppure il negozio lo ha rifiutato. Verifica che l'ITN URL mostrato nelle impostazioni sia impostato per il servizio nel portale Autopay (produzione o test), che la funzione hash sia SHA-256 e che la Shared key nel plugin corrisponda al servizio. Verifica che il negozio sia raggiungibile da internet. Attiva Logging e controlla WooCommerce > Status > Logs, origine wcp_autopay_payment.
Il registro mostra ITN rejected: invalid hash: la Shared key non corrisponde al servizio, oppure la funzione hash del servizio non è SHA-256.
Il registro mostra che il service ID non è configurato: la notifica proviene da un servizio il cui Service ID non è inserito nel plugin.
L'ordine è stato messo On hold con una nota di mancata corrispondenza: Autopay ha segnalato un importo o una valuta diversi dal totale dell'ordine. Verifica la transazione nel portale Autopay e completa o rimborsa l'ordine manualmente.
Una nota dice che la notifica NON è stata applicata: il pagamento di questo ordine non è stato avviato con questo servizio Autopay, per esempio una notifica di test per un ordine reale. Verifica la transazione nel portale Autopay.
Dopo il pagamento, il cliente finisce nella home page: l'indirizzo di ritorno non è stato verificato, per esempio perché il Service ID non è inserito nel plugin. Lo stato dell'ordine non cambia: segue l'ITN.
Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per 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 mantiene tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin, così come le impostazioni del gateway, vengono rimossi. Il plugin non ha un'opzione per conservare le impostazioni. Gli ordini esistenti mantengono le note di pagamento e gli ID transazione.
Autopay è un marchio del rispettivo titolare. Questo plugin non è affiliato né approvato da Autopay.