VibeFox Cardcom for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato su 3.0.5.0) oppure 4.0.2 e successive (testato su 4.1.0.3).

PHP: 8.0 o successiva.

HTTPS: il tuo negozio deve essere raggiungibile da Internet tramite HTTPS, così che Cardcom possa inviare la notifica di pagamento.

Valuta: la valuta dell'ordine (quella in cui il cliente acquista) deve essere ILS, USD, EUR o GBP. Per qualsiasi altra valuta il metodo di pagamento viene nascosto nel checkout.

Account Cardcom: per i pagamenti reali ti servono un account commerciante Cardcom con un numero di terminale, un nome utente API e una password API. I pagamenti richiedono solo il numero di terminale e il nome utente API. La password API serve solo per i rimborsi da OpenCart. La modalità di test funziona senza un account Cardcom.

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

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Estrailo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_cardcom_payment_gateway.ocmod.zip. Installa solo il pacchetto per la tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non richiede un aggiornamento. Invece dell'installer puoi anche copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Cardcom Payment Gateway e clicca su Install (il pulsante verde +). Il tuo utente amministratore deve avere il permesso di modificare l'elenco delle estensioni di pagamento.

3. Clicca su Edit (il pulsante a forma di matita) per aprire la pagina delle impostazioni. Incolla la tua chiave di licenza VibeFox in License key nel blocco della licenza in cima alla pagina e clicca su Activate (vedi Chiave di licenza).

4. Attiva Enable/Disable, lascia attivo Test Mode e clicca su Save. Effettua un ordine di prova con la carta 4580 0000 0000 0000, una data di scadenza futura qualsiasi e CVV 123.

5. Per i pagamenti reali disattiva Test Mode, inserisci il Terminal Number, l'API Username e l'API Password ricevuti da Cardcom e clicca su Save. Non devi configurare nulla nella dashboard di Cardcom: gli indirizzi di notifica e di ritorno vengono inviati con ogni pagamento.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_cardcom_payment_gateway.ocmod.zip. Non rinominare il file: OpenCart 4 ricava il codice dell'estensione dal nome del file, e un pacchetto rinominato non funziona.

2. Il pacchetto compare nell'elenco delle estensioni installate nella stessa pagina. Clicca su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Cardcom Payment Gateway, clicca su Install (il pulsante verde +), poi su Edit (il pulsante a forma di matita).

4. Inserisci la chiave di licenza, prova il pagamento e inserisci le credenziali reali come nei passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono gli stessi in entrambe le versioni. Cambia solo l'URL di notifica (vedi Notification URL).

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità di test attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra un avviso finché la modalità di test è attiva. In modalità reale avvisa quando mancano il numero di terminale o il nome utente API (in tal caso Cardcom viene nascosto nel checkout), quando nei campi reali è inserito il terminale di test pubblico 1000 / CardTest1994 (anche in questo caso Cardcom viene nascosto nel checkout, perché non verrebbe addebitato denaro reale), e ricorda che senza la password API non sono possibili i rimborsi da OpenCart. Avvisa inoltre quando la valuta predefinita del tuo negozio non è supportata. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto (massimo 128 caratteri), Sort Order deve essere un numero intero, Total deve essere un numero pari o superiore a 0, e la zona geografica e gli stati dell'ordine devono esistere; altrimenti non viene salvato nulla. Quando salvi la modalità reale con credenziali mancanti o di test, le impostazioni vengono salvate con un avviso che il gateway resta nascosto nel checkout finché non inserisci il tuo numero di terminale e il tuo nome utente API.

Cardcom

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

Title: il nome del metodo di pagamento che i clienti vedono nel checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Credit Card (Cardcom). Obbligatorio.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely with your credit card via Cardcom.

Sort Order: la posizione di Cardcom tra i metodi di pagamento nel checkout. Lascialo vuoto oppure inserisci un numero intero.

Geo Zone: offri Cardcom solo per gli indirizzi di pagamento nella zona geografica selezionata. Predefinito: All zones. Le zone geografiche si configurano in System > Localisation > Geo Zones.

Total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga offerto Cardcom. Lascialo vuoto per offrire Cardcom con qualsiasi totale.

Modalità di test

La modalità di test usa il terminale di test pubblico Cardcom 1000 (utente API CardTest1994). Non viene addebitato denaro reale e non serve un account Cardcom. Carta di test: 4580 0000 0000 0000, una data di scadenza futura qualsiasi e CVV 123. In modalità di test il passaggio Confirm Order mostra anche una riga con questa carta di test.

Test Mode: attiva la modalità di test (terminale 1000, nessun denaro reale). Predefinito: attivo. Disattivala per accettare pagamenti reali con le credenziali reali sotto. I rimborsi vengono sempre inviati con le credenziali della modalità in cui è stato pagato l'ordine.

Credenziali reali

Il numero di terminale, il nome utente API e la password API ti vengono forniti da Cardcom con il tuo account commerciante: nella dashboard di Cardcom alla voce delle impostazioni API, oppure tramite l'assistenza Cardcom. Questi campi vengono usati solo in modalità reale.

Terminal Number: il tuo numero di terminale Cardcom. Deve contenere solo cifre. Se inserisci altro, le altre impostazioni vengono salvate con un avviso e viene mantenuto il numero di terminale precedente.

API Username: il tuo nome utente API Cardcom (ApiName) per questo terminale. Gli spazi vengono rimossi al salvataggio.

API Password: la tua password API Cardcom. Serve solo per i rimborsi da OpenCart. La password salvata non viene mai più mostrata: il campo resta vuoto e indica Salvata — lascia vuoto per mantenerla. Inserisci un nuovo valore solo per modificarla. Per rimuoverla, spunta Clear the saved API password sotto il campo e clicca su Save.

Pagina di pagamento

Notification URL: Cardcom invia le notifiche di pagamento (IndicatorUrl) a questo indirizzo. Su OpenCart 3 ha la forma https://your-store/index.php?route=extension/payment/wcp_cardcom_payment_gateway/webhook, su OpenCart 4 la forma https://your-store/index.php?route=extension/wcp_cardcom_payment_gateway/payment/wcp_cardcom_payment_gateway.webhook. È costruito a partire dall'indirizzo del negozio della tua installazione di OpenCart. L'indirizzo viene passato automaticamente a Cardcom con ogni pagamento, insieme al numero dell'ordine, quindi non c'è nulla da configurare in Cardcom. Deve essere raggiungibile da Internet tramite HTTPS.

Operation: cosa fa Cardcom nella pagina di pagamento.

Max Installments: il numero massimo di rate (pagamenti) che il cliente può scegliere nella pagina Cardcom, da 1 a 36. 1 significa nessuna rateizzazione. Predefinito: 1.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Cardcom ha confermato il pagamento. Ogni campo qui sotto elenca i tuoi stati degli ordini OpenCart.

Success Order Status: lo stato impostato dopo un pagamento confermato. Predefinito: In lavorazione.

On Hold (Review) Status: i pagamenti che non corrispondono all'ordine (importo, valuta, nessun numero di transazione) ricevono questo stato e una nota che spiega il motivo. Predefinito: In attesa, perché OpenCart non ha lo stato In sospeso. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Refunded Status: impostato dopo il rimborso completo del pagamento dalla pagina dell'ordine. Predefinito: Rimborsato.

Avanzate

Debug log: registra le richieste API e le notifiche in cardcom_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web e, al raggiungimento di 5 MB, viene ruotato. Gli errori vengono sempre registrati. Credenziali, token delle carte e dati del titolare della carta non vengono mai scritti. Predefinito: disattivato.

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

Delete on Uninstall: se attivo, la disinstallazione dell'estensione rimuove in modo permanente le impostazioni e i log. Gli ordini e le transazioni e i rimborsi Cardcom vengono sempre conservati, così i vecchi ordini possono essere rimborsati anche dopo una reinstallazione. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni come file JSON. La password API non viene esportata.

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. La password API salvata viene mantenuta.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit Card (Cardcom)). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota Verrai reindirizzato alla pagina di pagamento sicura di Cardcom. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea una pagina di pagamento Cardcom per il totale dell'ordine nella valuta dell'ordine e invia il cliente a quella pagina. La pagina si apre in ebraico quando la lingua dell'ordine è l'ebraico, altrimenti in inglese. I prodotti dell'ordine vengono passati a Cardcom come nome del prodotto. Il cliente inserisce i dati della carta e, se le rate sono consentite, sceglie il numero di pagamenti. Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco del metodo di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina di checkout.

Dopo aver pagato, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo dopo che Cardcom lo ha confermato. Cardcom chiama l'indirizzo di notifica, e dalla chiamata l'estensione prende solo il codice della pagina di pagamento. Verifica che quel codice sia stato emesso dal tuo negozio per quell'ordine, quindi chiede a Cardcom, da server a server, il risultato reale. Se la notifica arriva in ritardo, lo stesso controllo viene eseguito quando il cliente torna. L'ordine riceve quindi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino, e il cliente vede la pagina di successo dell'ordine OpenCart con Il tuo pagamento con Cardcom è stato ricevuto. Se Cardcom non ha ancora confermato il pagamento quando il cliente torna, una pagina Payment confirmation mostra Il tuo pagamento è in fase di conferma da parte di Cardcom. Riceverai un'e-mail non appena sarà confermato. con i pulsanti Check again e Back to checkout; la notifica imposta lo stato dell'ordine non appena arriva. Su OpenCart 4 il browser non invia la sessione del negozio quando Cardcom rimanda indietro il cliente, quindi l'estensione mostra prima una breve pagina che riapre lo stesso indirizzo di ritorno dal tuo negozio: il cliente conserva il carrello e l'accesso.

Se il pagamento non viene completato o Cardcom lo rifiuta, il cliente torna al checkout con Il pagamento con carta non è stato completato. Riprova o scegli un altro metodo di pagamento. Su OpenCart 4 questo messaggio viene mostrato sopra la pagina di checkout. L'ordine resta senza stato e il carrello viene conservato. Il cliente può riprovare: OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 mantiene un unico ordine per il checkout e lo aggiorna, e ogni tentativo ottiene una nuova pagina di pagamento Cardcom. Prima della creazione di una nuova pagina, le pagine di pagamento Cardcom aperte di questo ordine e degli altri ordini dello stesso carrello (stessa sessione del cliente e stesso contenuto del carrello) delle ultime 24 ore vengono verificate con Cardcom. Se una di esse risulta pagata, quell'ordine viene confermato e il cliente va alla pagina di successo invece di pagare due volte. Un carrello già pagato con un altro ordine non viene addebitato di nuovo: il cliente va alla pagina di successo. Un rifiuto su una pagina più vecchia non influisce su un tentativo più recente.

Se l'ordine del checkout è stato chiuso nel frattempo senza un pagamento (per esempio lo hai annullato), Confirm Order o il ritorno da Cardcom rimanda il cliente al checkout con Questo ordine non può più essere pagato. Conferma di nuovo il tuo ordine., e il successivo Confirm Order paga un nuovo ordine del carrello. OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo: se quell'ordine ha già uno stato e il carrello è cambiato nel frattempo (altri prodotti o quantità), il cliente riceve lo stesso messaggio, e il carrello modificato ottiene un nuovo ordine e un proprio pagamento, mentre lo stesso carrello va alla pagina di successo senza un nuovo pagamento.

Se Cardcom non riesce ad aprire la pagina di pagamento, il cliente resta al passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio Impossibile connettersi a Cardcom. Riprova tra qualche istante. oppure il messaggio che Cardcom non è riuscito ad aprire la pagina di pagamento, con il codice Cardcom, e può scegliere un altro metodo di pagamento.

La notifica funziona anche mentre il negozio è in modalità manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, e su OpenCart 4 l'estensione aggiunge un'azione di avvio che fa passare la notifica e il ritorno del cliente.

L'estensione accetta pagamenti con carta solo sulla pagina Cardcom. Non ha carte salvate né pagamenti con un clic, non ha abbonamenti, non addebita i token salvati, non ha impostazioni per fatture o ricevute Cardcom, nessun Bit, Apple Pay, Google Pay o PayPal tramite Cardcom, nessuna modalità iframe e nessun accordo di cattura differita.

Ordini e rimborsi

Stati degli ordini

Nessuno stato (ordine mancante): il cliente è stato inviato a Cardcom e non ha pagato, il pagamento è stato rifiutato, oppure Cardcom non ha ancora confermato il pagamento. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Success Order Status (predefinito In lavorazione): il pagamento è stato confermato. Una nota mostra la transazione Cardcom e, quando Cardcom le comunica, le ultime quattro cifre della carta, il numero di fattura e il numero di rate, oltre al modo in cui il pagamento è stato confermato (notifica, ritorno o un nuovo tentativo). I pagamenti di prova sono contrassegnati con Modalità di test: nessun denaro reale è stato addebitato.

On Hold (Review) Status (predefinito In attesa): Cardcom ha confermato un pagamento che non corrisponde all'ordine, per esempio è stato addebitato un altro importo o un'altra valuta, oppure Cardcom non ha restituito alcun numero di transazione. La nota lo spiega, e la scheda dell'ordine lo mostra sotto Needs review:. Confronta il pagamento nella dashboard Cardcom con l'ordine, poi evadi l'ordine oppure rimborsa il pagamento.

Refunded Status (predefinito Rimborsato): il pagamento è stato rimborsato interamente tramite l'estensione.

Se arriva un secondo pagamento riuscito per un ordine che ha già uno stato (per esempio il cliente ha pagato in due schede del browser), l'ordine non viene modificato. Una nota avvisa che il cliente potrebbe essere stato addebitato due volte e ti chiede di rimborsarlo nella dashboard Cardcom. La stessa nota viene aggiunta all'ordine pagato quando lo stesso carrello è stato pagato di nuovo con un altro ordine (per esempio in una seconda scheda); quest'altro ordine non riceve alcuno stato.

Le note sono voci della History dell'ordine che il cliente non vede.

Scheda VibeFox Cardcom Payment Gateway

In Sales > Orders apri un ordine pagato con Cardcom. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Cardcom Payment Gateway mostra la Transaction con l'etichetta Test mode per i pagamenti di prova, la Payment page (LowProfileCode), lo Status, la Card, le Installments, la Invoice, il Card token (con Charge + Save token), l'importo Charged, il Order total / refunded, il modulo di rimborso, lo storico dei rimborsi e le Cardcom notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Cardcom. Conferma la domanda Refund this amount through Cardcom? This cannot be undone. Sono supportati rimborsi totali e parziali, ed è possibile effettuare più rimborsi parziali per un ordine. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi vengono eseguiti nell'importo e nella valuta addebitati da Cardcom, quindi, dopo una discrepanza di importo o valuta, puoi rimborsare fino a quanto il cliente ha effettivamente pagato, e non fino al totale dell'ordine. Il rimborso viene inviato con le credenziali della modalità in cui è stato pagato l'ordine: gli ordini di prova vengono rimborsati sul terminale di test Cardcom anche dopo il passaggio alla modalità reale, e gli ordini reali usano sempre le tue credenziali reali. I rimborsi reali richiedono l'API Username e l'API Password. Se Cardcom non accetta il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note, con la transazione di rimborso Cardcom e il motivo. Un rimborso totale imposta l'ordine sul Refunded Status senza avvisare il cliente e senza rimettere i prodotti a magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Cardcom. I rimborsi effettuati nella dashboard Cardcom non vengono comunicati al negozio.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Cardcom Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per verificare 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: opencart-payment-cardcom e il collegamento Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono modificare la chiave. I testi del blocco seguono la lingua del pannello di amministrazione (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per 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, oppure dopo aver liberato uno slot di dominio nel tuo account, clicca su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Cardcom non viene mostrato ai clienti nel checkout. Se un pagamento viene avviato comunque, il cliente vede Questo metodo di pagamento non è disponibile. Scegline un altro. Un utente amministratore che ha effettuato l'accesso al pannello di amministrazione nello stesso browser vede comunque il metodo di pagamento nel negozio, contrassegnato come (senza licenza — visibile solo agli amministratori), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso al pannello di amministrazione, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente quando apri la Dashboard dell'amministrazione o la pagina Edit: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Cardcom non compare nel checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la valuta del cliente sia ILS, USD, EUR o GBP. In modalità reale verifica che Terminal Number e API Username siano compilati con le tue credenziali, e non con il terminale di test 1000 / CardTest1994. La pagina delle impostazioni mostra un avviso quando manca qualcosa. Verifica anche che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: Cardcom non è riuscito a raggiungere il tuo negozio, per esempio a causa di un firewall, di una protezione con password o di un sito di sviluppo locale. L'indirizzo di notifica deve essere raggiungibile da Internet tramite HTTPS. L'ordine riceve il suo stato anche quando il cliente torna nel negozio dopo il pagamento. Attiva il Debug log e guarda il campo Log nella pagina dell'estensione.

La notifica risponde Missing or invalid lowprofilecode o Unknown lowprofilecode for this order: la chiamata non conteneva un codice di pagina di pagamento emesso dal tuo negozio per quell'ordine. Non viene modificato nulla.

La notifica risponde Gateway not configured o Indicator check failed: mancano le credenziali della modalità in cui è stata creata la pagina di pagamento, oppure Cardcom non è stato raggiunto per la verifica. Non viene modificato nulla; il pagamento viene verificato di nuovo quando il cliente torna nel negozio.

La notifica risponde Busy, retry: l'ordine era in fase di conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Attiva il Debug log per vedere il motivo.

La notifica risponde ReturnValue mismatch o Terminal mismatch: Cardcom ha segnalato un pagamento per un altro ordine o un altro terminale. Non viene modificato nulla. Verifica che il Terminal Number sia il terminale del tuo account.

L'URL di notifica nel browser mostra Missing or invalid lowprofilecode: è normale. L'URL accetta solo chiamate da Cardcom.

Il cliente vede «Errore di pagamento: questa valuta non è supportata da Cardcom.»: la valuta dell'ordine non è ILS, USD, EUR o GBP.

Il cliente vede «Il pagamento con carta non è temporaneamente disponibile. Scegli un altro metodo di pagamento.»: la modalità reale è attiva, ma mancano il numero di terminale o il nome utente API, oppure nei campi reali è inserito il terminale di test pubblico.

Il cliente vede «Questo metodo di pagamento non è disponibile.» dopo Confirm Order: la sessione di checkout non corrisponde più all'ordine, oppure nel frattempo il metodo di pagamento è stato disattivato. Il cliente ricarica il checkout.

Il cliente vede un altro errore dopo Confirm Order: attiva il Debug log e guarda il campo Log. Lì vengono registrati i problemi di connessione e i codici di errore Cardcom.

L'ordine è in stato di verifica dopo il pagamento: leggi le note oppure Needs review: nella scheda VibeFox Cardcom Payment Gateway. L'importo o la valuta pagati non corrispondevano all'ordine. Evadi l'ordine oppure rimborsa il pagamento.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: la transazione non è ancora confermata, il pagamento è rimborsato interamente, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure mancano l'utente API e la password API della modalità del pagamento.

Il rimborso fallisce con «API username and API password are required for refunds»: inserisci la API Password (e l'API Username) nelle impostazioni e riprova.

Il rimborso fallisce con «Could not connect to Cardcom»: controlla la dashboard Cardcom prima di riprovare, perché il rimborso potrebbe essere stato eseguito oppure no.

Per gli sviluppatori: l'estensione attiva gli eventi OpenCart cardcom_p_supported_currencies, che amplia l'elenco delle valute (aggiungi solo le valute abilitate sul tuo terminale Cardcom), e cardcom_p_low_profile_params, che modifica i parametri della pagina di pagamento prima che venga creata.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Cardcom Payment Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable/Disable, Sort Order, Geo Zone, Total e gli stati degli ordini della sezione Orders, che tornano ai valori predefiniti in caso di reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 i suoi eventi e la sua azione di avvio, che fa passare Cardcom in modalità manutenzione). Se Delete on Uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità di test, credenziali, opzioni della pagina di pagamento, registrazione) e il log. Se è disattivo, vengono conservate per una reinstallazione successiva. Le transazioni e i rimborsi Cardcom vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano le note di pagamento.

Su OpenCart 4, per rimuovere anche i file dell'estensione, vai su Extensions > Installer dopo la disinstallazione e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox Cardcom Payment Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso a forma di cestino) per rimuovere il pacchetto caricato.

Cardcom è un marchio del rispettivo proprietario. Questa estensione non è affiliata né approvata da Cardcom.