VibeFox CCAvenue for WooCommerce — Guida

Requisiti

WordPress: 5.8 o successivo.

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

PHP: 8.0 o successivo, con l'estensione OpenSSL (usata per cifrare la richiesta e decifrare la risposta).

Account CCAvenue: ti serve un account commerciante CCAvenue con un Merchant ID, un Access Code e una Working Key. Access Code e Working Key vengono emessi per un dominio web, quindi generali per il dominio di questo negozio. CCAvenue usa le stesse credenziali per l'ambiente di test; l'accesso di test deve essere attivato per il tuo account da CCAvenue. Il plugin usa gli endpoint CCAvenue per l'India.

Valuta: la valuta dell'ordine viene inviata a CCAvenue così com'è. Gli account CCAvenue accettano INR per impostazione predefinita; le altre valute richiedono l'elaborazione multivaluta sul tuo account CCAvenue.

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_ccavenue_payment in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > CCAvenue > 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 ID, Access Code e Working Key dalla tua dashboard CCAvenue e attiva Enable/Disable.

6. Lascia attivo Test mode durante i test, poi disattivalo per accettare pagamenti reali.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > CCAvenue. Sopra i campi la pagina ti avvisa quando CCAvenue è attivo ma manca Merchant ID, Access Code o Working Key (il metodo di pagamento viene allora nascosto al checkout finché non sono impostati tutti e tre), mostra CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. finché la modalità test è attiva, e ricorda l'elaborazione multivaluta quando la valuta del negozio non è INR.

Generali

Enable/Disable: Enable CCAvenue 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: CCAvenue.

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

Credenziali API

Accedi alla dashboard del commerciante CCAvenue (M.A.R.S.) e apri Settings > API Keys. Genera Access Code e Working Key per il dominio di questo negozio. Gli spazi nelle credenziali vengono rimossi al salvataggio.

Merchant ID: il tuo Merchant ID CCAvenue numerico. Se contiene caratteri diversi dalle cifre, al salvataggio viene mostrato un errore e viene mantenuto il valore salvato in precedenza.

Access Code: l'Access Code di questo sito.

Working Key: la Working Key (chiave di cifratura) di questo sito. Cifra la richiesta di pagamento ed è l'unico modo per verificare la risposta di CCAvenue, quindi tienila segreta.

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue usa lo stesso Merchant ID, Access Code e Working Key per test e live; l'accesso di test deve essere attivato per il tuo account da CCAvenue. In modalità test il checkout mostra TEST MODE: no real transactions will be processed. Predefinito: attivato. Disattivala per i pagamenti reali.

URL di ritorno

CCAvenue riporta il cliente all'indirizzo mostrato in questa sezione. Ha una forma come https://your-site/wc-api/ccavenue_p_callback/. Il plugin invia questo URL con ogni pagamento, quindi non c'è nulla da configurare in CCAvenue. Deve appartenere al dominio registrato presso CCAvenue.

Avanzate

Debug log: Log CCAvenue events scrive ID ordine, riferimenti e stati CCAvenue in WooCommerce > Status > Logs, origine wcp_ccavenue_payment. Chiavi, dati della carta e indirizzi non vengono registrati. Predefinito: disattivato.

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. Disattivare il plugin non cancella mai nulla. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita CCAvenue) e fa l'ordine. La pagina Pay for order mostra Thank you for your order. You are being redirected to CCAvenue to complete the payment. e invia il cliente alla pagina di pagamento CCAvenue. Senza JavaScript il cliente fa clic su Pay via CCAvenue oppure Cancel order. Ogni tentativo riceve un nuovo riferimento ordine CCAvenue. Il totale e la valuta dell'ordine, i dati di fatturazione e di consegna e la chiave dell'ordine vengono inviati nella richiesta cifrata. Nomi e indirizzi vengono puliti in base ai caratteri e alla lunghezza accettati da CCAvenue; paese e stato vengono inviati come nomi, il telefono come sole cifre.

Dopo il pagamento, CCAvenue riporta il cliente con una risposta cifrata. L'ordine viene segnato come pagato solo dopo la conferma di CCAvenue: la risposta deve decifrarsi con la tua Working Key, appartenere a questo ordine e riportare lo stesso importo e la stessa valuta dell'ordine. Poi il cliente arriva alla pagina Ordine ricevuto.

Se il pagamento non riesce, il cliente torna al checkout con Payment was not completed. Please try again or choose a different payment method. Se il cliente annulla nella pagina CCAvenue, il messaggio è Payment was cancelled. You may try again. Se la risposta non può essere verificata, il messaggio è We could not confirm the payment result. If your account was charged, please contact us before paying again. Il cliente può pagare di nuovo un ordine non pagato, per esempio dalla pagina Pay for order. Se il pagamento è stato avviato dalla pagina Pay for order e il carrello è vuoto, WooCommerce mostra il messaggio nella pagina del carrello; un ordine non riuscito può essere pagato di nuovo da My account > Orders.

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). I testi per il cliente sono tradotti in hindi.

Il risultato viene ricavato solo dal ritorno del cliente da CCAvenue: non ci sono notifiche da server a server né richieste di stato. Se il cliente chiude il browser prima di tornare, l'ordine resta In attesa di pagamento. Il plugin non offre rimborsi da WooCommerce, carte salvate, abbonamenti o pagamenti ricorrenti, iframe o modulo carta sul sito, né supporto per CCAvenue UAE o altre piattaforme regionali.

Ordini

Stati dell'ordine

Pending payment: il cliente è stato inviato a CCAvenue e non è ancora tornato. Verifica il pagamento nella dashboard CCAvenue se il cliente non torna.

Processing: il pagamento è stato confermato (gli ordini con soli prodotti virtuali scaricabili diventano Completato, come da impostazione predefinita di WooCommerce). La nota dell'ordine mostra il riferimento bancario, l'ID di tracciamento CCAvenue e la modalità di pagamento. L'ID transazione dell'ordine è l'ID di tracciamento CCAvenue.

On hold, amount/currency mismatch: CCAvenue ha confermato un pagamento il cui importo o la cui valuta differisce dall'ordine, per esempio perché l'ordine è stato modificato dopo che il cliente ha iniziato a pagare o perché è stata applicata un'offerta sconto di CCAvenue. La nota mostra l'importo ricevuto e quello atteso. Verifica il pagamento nella dashboard CCAvenue, poi completa o rimborsa l'ordine.

On hold, awaiting bank confirmation: CCAvenue ha segnalato il pagamento come Awaited. L'ordine non viene mai segnato come non riuscito finché il denaro potrebbe ancora essere incassato. Verificalo nella dashboard CCAvenue prima di evadere l'ordine e cambia lo stato manualmente. Una risposta successiva con lo stesso ID di tracciamento viene comunque applicata.

On hold, payment for a cancelled order: il cliente ha pagato dopo che l'ordine era stato annullato. Controlla le scorte, poi evadi o rimborsa l'ordine.

Cancelled: il cliente ha interrotto il pagamento nella pagina CCAvenue.

Failed: il pagamento non è riuscito, oppure CCAvenue ha restituito Invalid, Timeout o un altro stato non riuscito. La nota mostra il messaggio di CCAvenue. Un fallimento tardivo non modifica mai un ordine pagato.

Se arriva un altro pagamento riuscito per un ordine già pagato (per esempio da due schede del browser), l'ordine non viene modificato di nuovo. Una nota ti chiede di rimborsare il duplicato nella dashboard CCAvenue.

Refunds: i rimborsi da WooCommerce non sono supportati. Rimborsa il pagamento nella dashboard CCAvenue e registralo manualmente in WooCommerce.

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 > CCAvenue. 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, CCAvenue 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 clienti che tornano da pagamenti già avviati vengono comunque elaborati.

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

CCAvenue non appare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che siano impostati tutti e tre i dati: Merchant ID, Access Code e Working Key. La pagina delle impostazioni mostra un avviso quando ne manca uno.

Il pagamento è andato a buon fine, ma l'ordine resta Pending payment: il cliente non è tornato da CCAvenue al tuo negozio, per esempio perché ha chiuso il browser. Il plugin non riceve notifiche da server a server. Verifica il pagamento nella dashboard CCAvenue e aggiorna l'ordine manualmente.

Ogni pagamento termina con We could not confirm the payment result: la risposta non può essere decifrata. La Working Key è errata, appartiene a un altro dominio o è stata copiata con caratteri in più. Genera le chiavi per il dominio di questo negozio e incollale di nuovo. Attiva il Debug log e controlla WooCommerce > Status > Logs, origine wcp_ccavenue_payment.

CCAvenue mostra un errore prima della pagina di pagamento: verifica che Access Code e Working Key siano stati generati per questo dominio, che l'URL di ritorno appartenga al dominio registrato presso CCAvenue e, in modalità test, che CCAvenue abbia attivato l'accesso di test per il tuo account. Per una valuta diversa da INR, sul tuo account CCAvenue deve essere attivata l'elaborazione multivaluta.

Il cliente vede This payment method is temporarily unavailable: manca una delle credenziali.

Il cliente vede Payment gateway error: encryption failed: la richiesta non è stata cifrata. Verifica che l'estensione OpenSSL di PHP sia installata.

L'ordine è On hold dopo il pagamento: leggi la nota dell'ordine. L'importo o la valuta pagati erano diversi dall'ordine, il pagamento è in attesa della conferma bancaria, oppure l'ordine era stato annullato. Verifica il pagamento nella dashboard CCAvenue, poi evadi l'ordine o rimborsa il pagamento.

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.

Per gli sviluppatori, il readme elenca il filtro ccavenue_p_request_params (modifica i dati inviati a CCAvenue, per esempio da merchant_param2 a merchant_param5 o promo_code; non modificare amount, currency, order_id o merchant_param1) e il filtro ccavenue_p_icon per l'icona del checkout.

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 vengono sempre rimossi. Impostazioni del gateway, registri e riferimenti CCAvenue salvati negli ordini vengono rimossi solo se Delete data on uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Gli ordini esistenti mantengono le note di pagamento e gli ID transazione.

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