VibeFox CorvusPay 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: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK o USD. In qualsiasi altra valuta il metodo di pagamento è nascosto al checkout. Gli importi vengono inviati con 2 decimali; un totale con più decimali (per esempio in un negozio BHD a 3 decimali) viene rifiutato invece di essere arrotondato.

Account CorvusPay: ti serve un account commerciante CorvusPay. CorvusPay assegna uno Store ID e una Secret Key per ogni negozio, separatamente per il negozio di test e per quello di produzione; sono mostrati nel CorvusPay Merchant Center. La Success URL e la Cancel URL del plugin devono essere inserite lì (vedi Configurazione).

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. Puoi anche caricare la cartella wcp_corvuspay_gateway in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > CorvusPay > 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 lo Store ID e la Secret Key del tuo negozio di test CorvusPay (e del negozio di produzione per i pagamenti reali). Copia la Success URL e la Cancel URL mostrate nella pagina delle impostazioni nel CorvusPay Merchant Center, per il negozio di test e per quello di produzione.

6. Attiva Enable/Disable, effettua un ordine di prova, poi deseleziona Test Mode per passare alla produzione.

Configurazione

Tutte le impostazioni sono in un'unica pagina: WooCommerce > Settings > Payments > CorvusPay. Sopra i campi la pagina mostra Test mode is on. finché la modalità test è attiva, e ti avvisa quando il gateway è abilitato ma lo Store ID o la Secret Key della modalità corrente sono vuoti (in tal caso è nascosto al checkout finché non vengono compilati) e quando la valuta del negozio non è supportata da CorvusPay.

Generale

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

Title: il nome del metodo di pagamento che i clienti vedono al checkout. Predefinito: Credit/Debit Card (CorvusPay).

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely with your credit or debit card via CorvusPay. In modalità test viene aggiunto (Test mode — no real payment is taken.)

Credenziali del negozio

Lo Store ID e la Secret Key sono assegnati da CorvusPay per ogni negozio (test e produzione separatamente) e sono mostrati nel CorvusPay Merchant Center.

Test Mode: Enable test mode usa l'ambiente di test di CorvusPay (wallet.test.corvuspay.com) e lo Store ID e la Secret Key di test. Predefinito: attivato.

Test Store ID: lo Store ID numerico del tuo negozio di test CorvusPay.

Test Secret Key: la Secret Key del tuo negozio di test CorvusPay, usata per le firme HMAC-SHA256.

Live Store ID: lo Store ID numerico del tuo negozio di produzione CorvusPay.

Live Secret Key: la Secret Key del tuo negozio di produzione CorvusPay, usata per le firme HMAC-SHA256.

Uno Store ID deve contenere solo cifre. Se inserisci altro, viene mostrato un errore e il valore precedente viene mantenuto. Un pagamento viene sempre verificato con la Secret Key del negozio in cui è stato effettuato, quindi tieni compilata la chiave di test finché ci sono ordini di prova ancora aperti.

Success URL e Cancel URL

Copia i due indirizzi mostrati in questa sezione nel CorvusPay Merchant Center, per il negozio di test e per quello di produzione. CorvusPay riporta il cliente a questi indirizzi dopo il pagamento.

Pagamento

Transaction Type: come viene addebitata la carta.

Payment Page Language: la lingua della pagina di pagamento di CorvusPay. Site language (predefinito) usa la lingua attuale del tuo sito se CorvusPay la supporta, altrimenti l'inglese. Puoi anche scegliere croato, inglese, tedesco, italiano, serbo o sloveno.

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

Avanzate

Logging: Enable debug logging scrive in WooCommerce > Status > Logs, origine wcp_corvuspay_gateway. Gli errori vengono sempre registrati; i segreti e i dati dei clienti mai. Predefinito: disattivato.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). La disattivazione non elimina mai nulla. I dati di pagamento memorizzati negli ordini vengono sempre conservati. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit/Debit Card (CorvusPay)) ed effettua l'ordine. L'ordine resta In attesa di pagamento, e la pagina Pay for order mostra Redirecting to CorvusPay for payment. Please wait... e invia il modulo firmato alla pagina di pagamento di CorvusPay. Se il reindirizzamento non parte, il cliente fa clic su Pay via CorvusPay. Vengono inviati il totale dell'ordine, la valuta, una breve descrizione del carrello e i dati di fatturazione (per precompilare la pagina di pagamento). Lo stesso numero d'ordine CorvusPay viene riutilizzato finché l'importo non cambia, e CorvusPay non accetta un secondo pagamento per esso.

Dopo il pagamento, CorvusPay riporta il cliente alla Success URL. L'ordine viene segnato come pagato solo dopo la conferma di CorvusPay: il numero d'ordine CorvusPay deve essere stato emesso per questo ordine, la firma deve corrispondere alla Secret Key del negozio in cui è stato effettuato il pagamento, e importo e valuta devono coincidere con l'ordine. Poi il cliente arriva alla pagina di ordine ricevuto. La disponibilità a magazzino viene ridotta quando il pagamento è confermato, e il carrello viene svuotato nella pagina di ordine ricevuto.

Se il cliente annulla sulla pagina di CorvusPay, l'ordine non pagato viene annullato e il cliente torna al checkout con il carrello intatto e The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. Se il pagamento è stato avviato dalla pagina Pay for order e il carrello è vuoto, WooCommerce mostra The CorvusPay payment was cancelled and the order was not paid. nella pagina del carrello. Se la richiesta alla Success URL non può essere verificata, il cliente vede We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. e l'ordine non viene modificato.

Il metodo di pagamento funziona nel checkout classico, nel blocco Checkout e nella pagina Pay for order. È compatibile con l'High-Performance Order Storage (HPOS) di WooCommerce. I testi sono tradotti in croato.

L'ordine viene confermato solo quando CorvusPay riporta il cliente alla Success URL; non ci sono notifiche da server a server. Se il cliente chiude il browser subito dopo aver pagato, l'ordine resta In attesa di pagamento. Il plugin non prevede rimborsi, acquisizioni o annullamenti da WooCommerce (l'API server di CorvusPay richiede un certificato client), né carte salvate, abbonamenti, pagamenti rateali, IBAN / PIS o CorvusWallet.

Ordini

Stati degli ordini

Pending payment: il cliente è stato indirizzato a CorvusPay e non è ancora tornato. Se il cliente ha pagato ma non è tornato, controlla il pagamento nel CorvusPay Merchant Center e completa l'ordine manualmente.

Processing, Completed o On Hold: il pagamento Sale è stato confermato. Lo stato segue Order Status After Payment. La nota dell'ordine mostra il numero d'ordine CorvusPay, il codice di approvazione e il tipo di carta. L'ID transazione dell'ordine è l'ID transazione CorvusPay oppure, se CorvusPay non ne invia uno, il numero d'ordine CorvusPay, con cui il pagamento si può trovare nel Merchant Center.

On hold, autorizzato: è selezionato Authorize only. Acquisisci il pagamento nel CorvusPay Merchant Center, poi imposta l'ordine su In lavorazione.

On hold, importo/valuta non corrispondente: l'importo o la valuta pagati non corrispondono all'ordine. Non spedire prima di aver verificato il pagamento nel CorvusPay Merchant Center.

On hold, pagamento per un ordine annullato: è arrivato un pagamento riuscito dopo che l'ordine era stato annullato, per esempio dal timeout degli ordini non pagati. Evadi l'ordine oppure rimborsa il pagamento nel CorvusPay Merchant Center.

Cancelled: il cliente ha annullato il pagamento sulla pagina di CorvusPay.

Se per un ordine già pagato o chiuso arriva un altro pagamento riuscito, diverso, l'ordine non viene modificato. Una nota ti chiede di controllare il CorvusPay Merchant Center e di rimborsare il pagamento duplicato, se necessario.

Refunds: i rimborsi, le acquisizioni e gli annullamenti da WooCommerce non sono supportati. Eseguili nel CorvusPay Merchant Center e registra il rimborso manualmente in WooCommerce.

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 > CorvusPay. 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 ricontrollare 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 il posto del suo dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, CorvusPay non viene mostrato ai clienti al checkout. Se un pagamento viene comunque avviato, il cliente vede This payment method is not available. Please choose another one. I gestori del negozio che hanno effettuato l'accesso vedono comunque 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 Plugin e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: i clienti che tornano da pagamenti già avviati vengono comunque elaborati.

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

Risoluzione dei problemi

CorvusPay non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivato, che lo Store ID e la Secret Key della modalità corrente siano compilati (Test Store ID e Test Secret Key in modalità test, Live Store ID e Live Secret Key in modalità live) e che la valuta del negozio sia supportata da CorvusPay. La pagina delle impostazioni mostra un avviso in ciascun caso.

Il pagamento è andato a buon fine, ma l'ordine resta In attesa di pagamento: probabilmente la Success URL non è inserita nel CorvusPay Merchant Center, oppure la Secret Key in WooCommerce non corrisponde al negozio. Attiva Logging e cerca INVALID signature in WooCommerce > Status > Logs, origine wcp_corvuspay_gateway. L'ordine resta in attesa anche se il cliente ha chiuso il browser prima di tornare; in tal caso controlla il pagamento nel Merchant Center e completa l'ordine manualmente.

Il cliente vede We could not confirm this CorvusPay payment: la richiesta alla Success URL è stata rifiutata: mancavano campi obbligatori, il numero d'ordine CorvusPay non era stato emesso per l'ordine, la Secret Key di quel negozio è vuota oppure la firma non corrispondeva. L'ordine non viene modificato. Il registro mostra il motivo.

Il cliente vede This order total cannot be paid via CorvusPay: il totale è zero oppure ha più di 2 decimali.

Il cliente vede CorvusPay is not configured o CorvusPay does not accept payments in …: manca lo Store ID o la Secret Key della modalità corrente, oppure la valuta dell'ordine non è supportata.

L'ordine è On hold: leggi la nota dell'ordine. È selezionato Authorize only, l'importo o la valuta pagati non corrispondevano all'ordine, oppure il pagamento è arrivato dopo che l'ordine era stato annullato.

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 conserva 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 file di registro vengono rimossi solo se Delete Data era attivo. In caso contrario restano per una successiva reinstallazione. I dati di pagamento memorizzati negli ordini vengono sempre conservati. Gli ordini esistenti mantengono le loro note di pagamento e gli ID transazione.

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