VibeFox Paysera 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.
Progetto Paysera: ti servono l'ID progetto e la password di progetto (chiave di firma) del tuo progetto Paysera. I metodi di pagamento che vede il cliente sono quelli attivati in questo progetto. Non c'è nulla da configurare in Paysera per il callback: il suo URL viene inviato con ogni richiesta di pagamento.
Sito raggiungibile: gli ordini vengono pagati tramite il callback di Paysera, quindi il tuo sito deve essere raggiungibile da internet, non protetto da login, modalità manutenzione o firewall.
Chiave di licenza VibeFox: acquistata 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_paysera_payment in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Payments > Paysera > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.
4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.
5. Inserisci il Project ID e la Project password del tuo account Paysera (vedi Configurazione).
6. Facoltativo: attiva Allow test payments nel progetto Paysera e Test payments nel plugin per provare il flusso senza addebitare denaro. Disattivali prima di iniziare a vendere.
7. Attiva Enable/Disable e salva.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > Paysera. Sopra i campi la pagina mostra Paysera è nascosto al checkout finché non vengono inseriti l'ID progetto e la password di progetto. finché uno dei due manca, e un avviso che indica che i clienti non vengono addebitati mentre i pagamenti di prova o la sandbox sono attivi. Nell'elenco dei metodi di pagamento, Paysera è segnalato come da configurare finché il progetto non è configurato, e con i pagamenti di prova o la sandbox attivi compare un badge di modalità test.
Generale
Enable/Disable: Enable Paysera Payment attiva o disattiva il metodo di pagamento. Predefinito: disattivato.
Title: il nome del metodo di pagamento mostrato al checkout. Predefinito: Paysera.
Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely via Paysera.
Progetto Paysera
L'ID progetto e la password di progetto si trovano nel tuo account Paysera, in Projects and activities, il tuo progetto, General project settings. La sezione mostra l'URL del callback, che ha questo aspetto: https://your-site/wc-api/wc_psr_payment/. Viene inviato automaticamente con ogni pagamento; non c'è nulla da configurare in Paysera.
Project ID: l'ID numerico del tuo progetto Paysera.
Project password: la password del progetto (chiave di firma). Firma le richieste di pagamento e verifica i callback di Paysera.
Test
Test payments: Send payments in test mode (no money is charged). Paysera restituisce un pagamento di prova riuscito senza addebitare il cliente. Attiva prima Allow test payments nelle impostazioni del progetto Paysera. Finché questa opzione è attiva, i pagamenti di prova contrassegnano gli ordini come pagati; quando è disattiva, un pagamento di prova non paga mai un ordine. Predefinito: disattivato.
Environment: dove viene inviato il cliente. Mantieni Production per un normale progetto Paysera, anche per i pagamenti di prova. Predefinito: Production.
Avanzate
Debug log: Log payment events. Gli errori vengono sempre registrati. I log si trovano in WooCommerce > Status > Logs, origine wcp_paysera_payment. Password e dati dei clienti non vengono mai scritti. Predefinito: disattivato.
Delete data: Delete the plugin settings and logs when the plugin is deleted. La disattivazione del plugin non cancella mai nulla. I dati degli ordini vengono sempre conservati. Predefinito: disattivato.
Checkout
Il cliente sceglie il metodo di pagamento (per impostazione predefinita Paysera) e invia l'ordine. Con i pagamenti di prova attivi, il checkout mostra MODALITÀ TEST — non verrà addebitato alcun importo. Il plugin crea una richiesta di pagamento firmata con il totale dell'ordine nell'unità minima della valuta dell'ordine, il nome, l'e-mail e l'indirizzo di fatturazione del cliente, e una lingua scelta in base alla lingua del tuo sito (lituano, lettone, estone, russo, tedesco, polacco, altrimenti inglese). Il cliente viene inviato alla finestra di pagamento di Paysera e vi sceglie una banca, una carta o un altro metodo.
Dopo il pagamento, il cliente torna alla pagina di ordine ricevuto. L'ordine viene contrassegnato come pagato solo quando arriva il callback firmato di Paysera; il ritorno in sé non paga mai un ordine.
Se il cliente annulla nella finestra di Paysera, l'ordine viene annullato nel modo standard di WooCommerce e il cliente può ordinare di nuovo. Se il pagamento non può essere avviato, il cliente vede I pagamenti Paysera sono temporaneamente non disponibili. Scegli un altro metodo di pagamento. Il motivo viene scritto nel log.
Il metodo di pagamento funziona con il checkout classico, con il blocco Checkout e con la pagina Pay for order. È compatibile con WooCommerce High-Performance Order Storage (HPOS).
Il plugin non gestisce rimborsi da WooCommerce, non offre la scelta di banca o metodo di pagamento al checkout, né abbonamenti, carte salvate o servizi di consegna o corriere di Paysera.
Ordini
Stati dell'ordine
Pending payment: il cliente è stato inviato a Paysera e il callback non è ancora arrivato.
Processing: Paysera ha confermato il pagamento (stato 1). Gli ordini con soli prodotti virtuali scaricabili diventano Completato, il valore predefinito di WooCommerce. La nota dell'ordine mostra la richiesta Paysera e il metodo di pagamento. L'ID transazione è l'ID della richiesta Paysera.
On hold: Paysera ha accettato l'ordine di pagamento ma non lo ha ancora eseguito (stato 2), e l'ordine viene completato quando Paysera conferma il pagamento; oppure l'importo o la valuta pagati differiscono dall'ordine (nota amount/currency mismatch); oppure è stato ricevuto un pagamento di PROVA mentre i pagamenti di prova erano disattivati, quindi non è stato addebitato denaro. La nota dell'ordine lo spiega.
Cancelled: il cliente ha annullato nella finestra di Paysera, oppure l'ordine è stato annullato da te o dal timeout della prenotazione di magazzino. Un pagamento confermato successivamente per un ordine annullato non cambia il suo stato: una nota ti chiede di ripristinare l'ordine (impostandolo su Processing) o di rimborsare il pagamento in Paysera.
Gli altri stati Paysera (pagamento non eseguito, informazioni aggiuntive) aggiungono solo una nota. Se arriva un altro pagamento riuscito per un ordine già pagato, l'ordine non viene modificato e una nota ti chiede di rimborsare il duplicato nel tuo account Paysera.
Rimborsi
I rimborsi da WooCommerce non sono supportati: il protocollo della finestra di pagamento Paysera non ha un'API per i rimborsi. Effettua i rimborsi nel tuo account Paysera. Quando Paysera segnala un rimborso, all'ordine viene aggiunta una nota con l'importo rimborsato, e lo stato dell'ordine non cambia. Registra il rimborso manualmente in WooCommerce se necessario.
Chiave di licenza
Il plugin funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Payments > Paysera. 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 collegamento 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 il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.
Senza una chiave attiva, Paysera 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 Plugins 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 il rinnovo. Lo stato viene verificato di nuovo automaticamente in background.
Risoluzione dei problemi
Paysera non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che siano inseriti sia Project ID sia Project password. La pagina delle impostazioni mostra un avviso finché uno dei due manca.
Il pagamento è andato a buon fine, ma l'ordine resta in Pending payment: l'ordine viene pagato dal callback di Paysera, non dal ritorno del cliente. Verifica che il tuo sito sia raggiungibile da internet all'URL del callback mostrato nelle impostazioni (non dietro login, modalità manutenzione o firewall), e controlla WooCommerce > Status > Logs, origine wcp_paysera_payment.
Il callback risponde Invalid signature: la Project password non corrisponde al progetto, oppure il callback non proviene da Paysera. Copia di nuovo la password del progetto.
Il callback risponde Project ID mismatch: il Project ID nelle impostazioni è diverso dal progetto che ha effettuato il pagamento.
Il callback risponde Gateway not configured o Busy: l'ID o la password del progetto sono vuoti, oppure un altro callback per lo stesso ordine è ancora in corso. Paysera ripete il callback.
Paysera rifiuta la finestra di pagamento o dice che il progetto non esiste: controlla Environment. Un normale progetto Paysera funziona solo con Production; Sandbox richiede un progetto creato nell'ambiente sandbox di Paysera.
Il pagamento di prova non paga l'ordine: un pagamento di PROVA paga un ordine solo mentre Test payments è attivo. Altrimenti l'ordine viene messo in sospeso con una nota che indica che non è stato addebitato denaro. Attiva anche Allow test payments nel progetto Paysera.
Nessuna icona al checkout: il plugin non mostra un'icona per impostazione predefinita. Gli sviluppatori possono impostarne una con il filtro wc_psr_gateway_icon.
Un ordine è On hold con una nota su una discrepanza di importo o valuta: Paysera ha confermato un pagamento il cui importo o la cui valuta non corrisponde al totale dell'ordine, ad esempio perché l'ordine è stato modificato dopo che il cliente aveva iniziato a pagare. Confronta il pagamento nel tuo account Paysera e completa o rimborsa l'ordine manualmente.
Il blocco licenza mostra un errore: segui il messaggio nel blocco. Ad 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 sul nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.
Disinstallazione
La disattivazione del plugin mantiene 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 log vengono rimossi solo se Delete data era attivo. Altrimenti restano per una successiva reinstallazione. Gli ordini esistenti conservano le loro note di pagamento e gli ID transazione.
Paysera è un marchio del rispettivo titolare. Questo plugin non è affiliato né approvato da Paysera.