VibeFox CorvusPay for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x.

PHP: 8.0 o successivo. Il modulo non si installa su versioni precedenti di PHP.

Valuta: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK o USD. Con qualsiasi altra valuta del carrello, il metodo di pagamento non viene mostrato al checkout. Gli importi vengono inviati con 2 decimali; un totale con più decimali (per esempio in un negozio con prezzi BHD a 3 decimali) viene rifiutato invece di essere arrotondato.

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

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

Installazione

1. Nel back office vai su Modules > Module Manager e fai clic su Upload a module. Scegli il file ZIP del modulo.

2. Al termine del caricamento, fai clic su Configure, oppure trova in seguito VibeFox CorvusPay Gateway nell'elenco dei moduli e fai clic su Configure.

3. Inserisci la tua chiave di licenza VibeFox in License key nel blocco licenza in alto nella pagina Configure, quindi fai clic su Activate (vedi Chiave di licenza).

4. Inserisci lo Store ID e la Secret Key del tuo negozio di test CorvusPay (e quelli del negozio di produzione per i pagamenti reali). Copia la Success URL e la Cancel URL mostrate nella pagina Configure nel CorvusPay Merchant Center, sia per il negozio di test sia per quello di produzione.

5. Attiva Enable/Disable e fai clic su Save. Effettua un ordine di prova, poi disattiva Test Mode per andare in produzione.

All'installazione il modulo crea lo stato dell'ordine CorvusPay payment on hold. PrestaShop collega un nuovo modulo di pagamento alle valute, ai gruppi di clienti e ai paesi attivi in quel momento. Puoi modificarlo in Payment > Preferences; un paese che attivi più tardi deve essere selezionato lì per il modulo.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox CorvusPay Gateway > Configure. Ogni sezione ha un proprio pulsante Save, che salva l'intera pagina. Sopra i campi, la pagina mostra La modalità test è attiva. I pagamenti vanno all'ambiente di test di CorvusPay: non viene addebitato denaro reale. mentre la modalità test è attiva, ti avvisa quando il gateway è attivato ma lo Store ID o la Secret Key della modalità corrente sono vuoti (in quel caso non viene mostrato al checkout finché non vengono compilati) e quando la valuta predefinita del tuo negozio non è supportata da CorvusPay.

CorvusPay

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. È anche il nome del metodo di pagamento salvato nell'ordine. 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 (Modalità test — non viene addebitato alcun pagamento reale.).

Credenziali del negozio

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

Test Mode: usa l'ambiente di test di CorvusPay (wallet.test.corvuspay.com) e lo Store ID e la Secret Key di test. Predefinito: attivo. Disattivalo per accettare pagamenti reali su wallet.corvuspay.com.

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.

Clear saved secrets: seleziona Test Secret Key o Live Secret Key e fai clic su Save per rimuoverla.

Lo Store ID deve contenere solo cifre. Se inserisci altro, la pagina mostra … deve contenere solo cifre — è stato mantenuto il valore precedente. e gli altri campi vengono comunque salvati. Le Secret Key salvate non vengono più mostrate: il campo resta vuoto e riporta Salvata — lasciare vuoto per mantenerla. Inserisci un nuovo valore solo se vuoi cambiarlo. Un pagamento viene sempre verificato con la Secret Key del negozio in cui è stato avviato, quindi tieni compilata la chiave di test finché possono ancora arrivare pagamenti di test.

Success URL e Cancel URL

Copia i due indirizzi mostrati in questa sezione nel CorvusPay Merchant Center, sia per il negozio di test sia per quello di produzione. CorvusPay riporta il cliente a questi indirizzi dopo il pagamento. Copiali esattamente come li mostra la pagina; con URL leggibili hanno l'aspetto degli esempi seguenti, eventualmente con un codice lingua come /en/.

Pagamento

Transaction Type: come viene addebitata la carta.

Payment Page Language: la lingua della pagina di pagamento CorvusPay. Site language (predefinito) usa la lingua corrente del tuo negozio quando CorvusPay la supporta, altrimenti l'inglese. Puoi anche scegliere Hrvatski, English, Deutsch, Italiano, Srpski o Slovenščina.

Order Status After Payment: lo stato dell'ordine dopo un pagamento Sale riuscito. L'ordine viene creato direttamente in questo stato.

Avanzate

Logging: scrive informazioni di debug in logs/corvuspay_p_debug.log.php nella cartella del modulo. Il file non può essere aperto dal web. Gli errori vengono sempre registrati, anche quando l'opzione è disattivata; segreti, firme e dati dei clienti non lo sono mai. Predefinito: disattivato.

Log: mostra la dimensione e le ultime voci del registro. Fai clic su Clear log per svuotarlo.

Delete Data: se attivo, la disinstallazione del modulo rimuove le impostazioni del modulo e i file di log. Ordini, dati delle transazioni CorvusPay e stato dell'ordine vengono sempre conservati. Predefinito: disattivato.

Checkout

Nella fase di pagamento il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit/Debit Card (CorvusPay)) e conferma. La pagina successiva mostra Reindirizzamento a CorvusPay per il pagamento. Attendere... e invia il modulo firmato alla pagina di pagamento CorvusPay. Se il reindirizzamento non parte, il cliente fa clic su Pay via CorvusPay; Back to checkout riporta al checkout. Vengono inviati il totale del carrello, la valuta, una breve descrizione (numero del carrello e nome del negozio) e i dati dell'indirizzo di fatturazione e l'e-mail (per precompilare la pagina di pagamento). A questo punto non esiste ancora alcun ordine. Lo stesso numero d'ordine CorvusPay viene riutilizzato finché non cambiano importo, valuta, modalità e tipo di transazione, e CorvusPay non accetta per esso un secondo pagamento.

Dopo il pagamento, CorvusPay riporta il cliente alla Success URL. L'ordine viene segnato come pagato solo quando CorvusPay lo conferma: il numero d'ordine CorvusPay deve essere stato emesso da questo negozio, la firma deve corrispondere alla Secret Key del negozio in cui è stato avviato il pagamento, e importo e valuta devono corrispondere al carrello. Poi l'ordine viene creato e il cliente vede la pagina standard di conferma dell'ordine con Il tuo pagamento CorvusPay è stato ricevuto. Per Authorize only la pagina mostra Il tuo pagamento CorvusPay è stato autorizzato. L'importo sarà addebitato quando il negozio elaborerà il tuo ordine. e, per un ordine in sospeso, Il tuo pagamento è stato ricevuto e il negozio lo sta verificando.

Se in quel momento l'ordine non può essere creato (per esempio perché un'altra richiesta sta confermando lo stesso carrello), il cliente vede Il tuo pagamento è in fase di conferma con un pulsante Check again, che porta alla conferma dell'ordine non appena l'ordine esiste. Se la richiesta alla Success URL non può essere verificata, il cliente vede Pagamento non confermato e Non è stato possibile confermare questo pagamento CorvusPay. Se la carta è stata addebitata, contatta il negozio — non pagare di nuovo. Non viene modificato nulla. La Success URL funziona anche quando il negozio è in modalità manutenzione.

Se il cliente annulla nella pagina di CorvusPay, torna al checkout con il carrello intatto e Il pagamento CorvusPay è stato annullato e l'ordine non è stato pagato. Il tuo carrello è ancora qui: puoi riprovare o scegliere un altro metodo di pagamento.

Se il pagamento non può iniziare, il cliente resta al checkout con un breve messaggio: CorvusPay non è configurato. Scegli un altro metodo di pagamento., CorvusPay non accetta pagamenti in … oppure Questo totale dell'ordine non può essere pagato tramite CorvusPay (deve essere maggiore di zero e avere al massimo 2 decimali). Scegli un altro metodo di pagamento.

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 il pagamento, non viene creato alcun ordine. Il modulo non prevede rimborsi, acquisizioni o annullamenti da PrestaShop (l'API server di CorvusPay richiede un certificato client), né carte salvate, abbonamenti, pagamenti rateali o modulo carta sul sito.

Ordini

Stati dell'ordine

Nessun ordine ancora: il cliente è stato inviato a CorvusPay e non è tornato con un pagamento confermato. Esiste solo il carrello. Se il cliente ha pagato ma non è tornato, verifica il pagamento nel CorvusPay Merchant Center e crea l'ordine manualmente.

Payment accepted, Delivered o CorvusPay payment on hold: il pagamento Sale è stato confermato. Lo stato segue Order Status After Payment. Il pagamento viene registrato con l'ID della transazione CorvusPay oppure, se CorvusPay non ne invia uno, con il numero d'ordine CorvusPay, con cui il pagamento può essere ritrovato nel Merchant Center. Una nota privata dell'ordine mostra il numero d'ordine CorvusPay, il codice di approvazione e il tipo di carta.

CorvusPay payment on hold, authorized: è selezionato Authorize only. Acquisisci il pagamento nel CorvusPay Merchant Center, poi imposta l'ordine su Payment accepted.

CorvusPay payment on hold, amount/currency mismatch: l'importo o la valuta pagati non corrispondono al carrello, per esempio perché il carrello è stato modificato in un'altra scheda. Il pagamento viene registrato con l'importo effettivamente pagato se è nella valuta dell'ordine. Non spedire prima di aver verificato il pagamento nel CorvusPay Merchant Center.

CorvusPay payment on hold, payment after cancel: è arrivato un pagamento riuscito per un tentativo che il cliente aveva annullato. Evadi l'ordine o rimborsa il pagamento nel CorvusPay Merchant Center.

Se per un carrello che ha già un ordine 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.

Blocco pagamento CorvusPay

La pagina dell'ordine mostra un blocco CorvusPay payment con il numero d'ordine CorvusPay, lo stato del tentativo di pagamento, il tipo di transazione (Sale o Authorize only), l'importo (e l'importo ricevuto, se CorvusPay lo ha comunicato), il codice di approvazione, la transazione e il tipo di carta. I pagamenti di test sono contrassegnati come Test.

Rimborsi: rimborsi, acquisizioni e annullamenti da PrestaShop non sono supportati. Eseguili nel CorvusPay Merchant Center e registra manualmente il risultato in PrestaShop.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza License — VibeFox CorvusPay Gateway è il primo blocco di Modules > Module Manager > VibeFox CorvusPay Gateway > Configure, sopra le impostazioni. Inserisci la chiave in License key e fai clic su Activate. Poi il blocco mostra la chiave mascherata, lo stato (per esempio la data fino a cui la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto compaiono la riga Product: presta-payment-corvuspay e il link Gestisci licenze e domini nel tuo account, che apre il tuo account vibefox.net. Solo i dipendenti con il permesso Configure per il modulo possono modificare la chiave. I testi del blocco seguono la lingua del back office (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, ad esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, il modulo continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un solo dominio: il dominio del negozio principale, anche in una configurazione multistore. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, CorvusPay non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede Questo metodo di pagamento non è disponibile. Scegline un altro. La vetrina di PrestaShop non sa che hai effettuato l'accesso al back office, quindi il metodo di pagamento viene nascosto anche per te: puoi configurare il modulo prima di acquistare una chiave, ma non testarlo al checkout. Un promemoria compare in Modules > Module Manager, nella scheda Alerts. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati quando il cliente torna da CorvusPay.

Quando una licenza scade, il modulo continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene ricontrollato automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. Disinstallare o ripristinare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

CorvusPay non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, 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 carrello sia supportata da CorvusPay. In Payment > Preferences verifica che il modulo sia consentito per la valuta del carrello, il paese del cliente e il gruppo del cliente.

Il pagamento è andato a buon fine, ma non è stato creato alcun ordine: probabilmente la Success URL non è stata inserita nel CorvusPay Merchant Center, oppure la Secret Key in PrestaShop non corrisponde al negozio. Cerca INVALID signature nel campo Log della pagina del modulo (gli errori vengono sempre registrati). Non viene creato alcun ordine nemmeno se il cliente ha chiuso il browser prima di tornare; in tal caso verifica il pagamento nel Merchant Center e crea l'ordine manualmente.

Il cliente vede Pagamento non confermato: la richiesta alla Success URL è stata rifiutata: mancavano campi obbligatori, il numero d'ordine CorvusPay non è stato emesso da questo negozio, la Secret Key di quel negozio è vuota oppure la firma non corrispondeva. Non viene modificato nulla. Il log indica il motivo.

Il cliente vede Il tuo pagamento è in fase di conferma per molto tempo: non è stato possibile creare l'ordine, per esempio perché il modulo era disattivato o il carrello non è più valido. Il log indica il motivo; verifica il pagamento nel Merchant Center.

Il cliente vede Questo totale dell'ordine non può essere pagato tramite CorvusPay: il totale è zero oppure ha più di 2 decimali.

Il cliente vede CorvusPay non è configurato oppure CorvusPay non accetta pagamenti in …: manca lo Store ID o la Secret Key della modalità corrente, oppure la valuta del carrello non è supportata.

L'ordine è in CorvusPay payment on hold: leggi le note private dell'ordine. È selezionato Authorize only, l'importo o la valuta pagati non corrispondevano al carrello, il pagamento è arrivato dopo che il cliente aveva annullato, oppure Order Status After Payment è impostato su in sospeso.

Disinstallazione

Vai su Modules > Module Manager, apri il menu accanto a VibeFox CorvusPay Gateway e scegli Uninstall. La chiave di licenza e lo stato della licenza di questo modulo vengono sempre rimossi. Se Delete Data è attivo, vengono rimosse le impostazioni del modulo e i file di log. Se è disattivo, tutte le impostazioni vengono conservate per una reinstallazione successiva. I dati delle transazioni CorvusPay e lo stato dell'ordine CorvusPay payment on hold vengono sempre conservati, quindi il blocco CorvusPay dei vecchi ordini ricompare dopo una reinstallazione. Gli ordini esistenti mantengono le loro note di pagamento e gli ID delle transazioni.

CorvusPay è un marchio di proprietà dei rispettivi titolari. Questo modulo non è affiliato né approvato da CorvusPay.