VibeFox Kushki for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successiva.

Valuta: USD (Ecuador) o COP (Colombia). Per gli ordini in altre valute il metodo di pagamento non viene mostrato al checkout.

HTTPS: Kushki richiede che il checkout venga servito tramite HTTPS in modalità live.

Account Kushki: ti servono i Merchant ID pubblico e privato del tuo account di test (UAT) Kushki e del tuo account di produzione. Si trovano nella Kushki Console, in Developers > Credentials. Per il webhook facoltativo ti serve anche la chiave di firma del webhook di ciascun account (vedi Configurazione).

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

Installazione

L'archivio da scaricare è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_kushki_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_kushki_payment.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_kushki_payment-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'installer puoi 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 Kushki Payment 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 di licenza in cima alla pagina, e clicca su Activate (vedi Chiave di licenza).

4. Inserisci i Merchant ID pubblico e privato di test e lascia attivo Test mode. Facoltativamente, configura il webhook nella Kushki Console e incolla la sua chiave di firma (vedi Configurazione).

5. Attiva Enable / Disable, clicca su Save ed effettua un ordine di prova. Quando sei pronto, inserisci i Merchant ID live (e la firma del webhook live) e disattiva Test mode.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_kushki_payment.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 Kushki Payment, clicca su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza, i Merchant ID e il webhook come nei passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'URL del webhook (vedi Webhook).

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Kushki Payment > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni, la pagina ti avvisa quando il metodo di pagamento è attivo ma mancano i Merchant ID della modalità corrente (in tal caso il metodo di pagamento viene nascosto al checkout), quando la valuta predefinita del negozio non è USD o COP, quando la modalità live viene usata senza HTTPS (su OpenCart 4, quando l'indirizzo della vetrina inizia con http://) e quando la modalità corrente non ha una chiave di firma del webhook. Mentre la modalità test è attiva, mostra Test mode is on: the Kushki test environment is used, no real money is charged. Senza il diritto di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto né superare 128 caratteri, Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total deve essere un numero maggiore o uguale a 0 e ogni stato dell'ordine deve esistere. Se un campo è errato, non viene salvato nulla e la pagina indica il campo. Gli spazi attorno agli ID vengono rimossi al salvataggio.

Kushki

Enable / Disable: Enable Kushki card payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Credit / debit card (Kushki). Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato sopra il modulo della carta nel passaggio Confirm Order. Predefinito: Pay securely with your card. Card details are entered in a Kushki form and never stored on this site.

Sort Order: la posizione di Kushki tra i metodi di pagamento al checkout. Lascia vuoto o inserisci un numero intero.

Geo Zone: offri Kushki 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 Kushki. Lascia vuoto per offrire Kushki per qualsiasi importo.

Credenziali API

Copia i Merchant ID pubblico e privato dalla Kushki Console (Developers > Credentials; la pagina contiene un link alla Console). Gli account di test (UAT) e di produzione hanno ID diversi. La modalità test usa solo gli ID di test, la modalità live solo gli ID live.

Test mode: usa l'ambiente di test Kushki (UAT): i Merchant ID di test, il modulo della carta di test e l'API di test insieme. Non viene addebitato denaro reale e al checkout compare un badge TEST MODE. Predefinito: attivo. Disattivalo per accettare pagamenti reali. I rimborsi vanno sempre nell'ambiente in cui è stato effettuato il pagamento.

Test Public Merchant ID: il Merchant ID pubblico del tuo account di test Kushki. Serve a caricare il modulo della carta.

Test Private Merchant ID: il Merchant ID privato del tuo account di test Kushki. Viene usato sul server per addebiti e rimborsi.

Live Public Merchant ID: il Merchant ID pubblico del tuo account di produzione Kushki.

Live Private Merchant ID: il Merchant ID privato del tuo account di produzione Kushki. Mantienilo segreto.

I Merchant ID privati salvati e le firme dei webhook non vengono mai più mostrati. Il campo resta vuoto e riporta Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere un valore salvato, seleziona Clear the saved value on save sotto il campo e clicca su Save.

Webhook (consigliato)

I pagamenti vengono confermati subito dalla risposta dell'API Kushki, quindi il webhook non è obbligatorio. Serve inoltre a confermare un pagamento la cui risposta è andata persa (ad esempio per un timeout) e a segnalare annullamenti, rimborsi e chargeback effettuati nella Kushki Console. Nella Kushki Console (Webhooks) aggiungi l'URL mostrato in Webhook URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_kushki_payment/webhook, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_kushki_payment/payment/wcp_kushki_payment.webhook. È costruito a partire dall'indirizzo del negozio della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Fallo per l'account di test e per l'account di produzione.

L'estensione gestisce queste notifiche di carta:

Test webhook signature: la chiave di firma del webhook dell'account di test Kushki (Console > Webhooks).

Live webhook signature: la chiave di firma del webhook dell'account di produzione Kushki.

I webhook senza una firma valida vengono rifiutati. Una notifica deve essere firmata con la chiave della modalità in cui è stato effettuato il pagamento, quindi una notifica di test non conferma mai un pagamento live. Senza una chiave di firma vengono rifiutate tutte le notifiche webhook, ma i pagamenti continuano a funzionare, perché vengono confermati dalla risposta dell'API.

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza uno stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Kushki ha approvato l'addebito sulla carta. Ogni campo qui sotto elenca gli stati ordine del tuo OpenCart.

Order Status After Payment: Kushki ha approvato l'addebito con un numero di ticket, per l'importo e la valuta dell'ordine. Predefinito: In lavorazione.

On Hold (Review) Status: Kushki ha approvato l'addebito senza numero di ticket, oppure ha segnalato un altro importo o un'altra valuta. Una nota ne spiega il motivo; controlla il pagamento nella Kushki Console prima dell'evasione. Predefinito: In attesa di pagamento, perché OpenCart non ha uno stato In attesa. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Failed Status: un ordine nello stato di verifica il cui addebito Kushki segnala successivamente come rifiutato (webhook). Predefinito: Non riuscito.

Canceled Status: gli ordini in questo stato (o nello stato di rimborsato) non vengono mai riaperti da un webhook tardivo. Predefinito: Annullato.

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

Avanzate

Debug log: scrive richieste e webhook di Kushki nel file kushki_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Avvisi ed errori vengono sempre registrati. I log non contengono mai Merchant ID, token delle carte o e-mail dei clienti. Predefinito: disattivato.

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

Delete data on uninstall: se attivo, disinstallando l'estensione vengono rimosse le impostazioni e il log. I registri dei pagamenti Kushki (addebiti e rimborsi) restano sempre, quindi gli ordini vecchi possono essere rimborsati anche dopo una reinstallazione. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. I Merchant ID privati e le firme dei webhook non vengono esportati.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. I segreti salvati vengono mantenuti.

Checkout

Al passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit / debit card (Kushki)). OpenCart crea l'ordine al passaggio Confirm Order, ancora senza stato. Lì il cliente vede la tua descrizione e il modulo della carta Kushki con il totale dell'ordine nella valuta dell'ordine. Il cliente inserisce la carta, sceglie le rate se il modulo Kushki le offre e preme il pulsante di pagamento all'interno del modulo Kushki. Il pagamento viene quindi inviato automaticamente, come dice la nota sotto il modulo: Enter your card in the secure Kushki form above and press its pay button — the payment is sent automatically. Se il cliente clicca invece sul pulsante Confirm Order di OpenCart, compare il messaggio Please enter your card details in the Kushki form and press its pay button.

Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose nel blocco del metodo di pagamento, nella finestra Payment method options. Il modulo carta Kushki compare poi nel blocco di conferma dell'ordine in fondo alla pagina del checkout, sopra il pulsante Confirm Order, e viene ricreato per il totale attuale dell'ordine ogni volta che OpenCart ricarica quel blocco.

Il tuo negozio addebita poi la carta sul server. L'ordine viene segnato come pagato solo quando Kushki lo conferma con un numero di ticket. L'ordine riceve quindi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino, il carrello viene svuotato e il cliente vede la pagina di successo dell'ordine di OpenCart con Your card payment has been received. Importo e valuta comunicati da Kushki vengono confrontati con l'ordine. Un ordine nello stato di verifica mostra Your payment is being reviewed. We will update your order as soon as the review is complete.

Se la carta viene rifiutata, l'ordine resta senza stato, il cliente rimane al passaggio Confirm Order con Your payment was declined e il motivo indicato da Kushki, e può provare un'altra carta nel modulo ricaricato. Per problemi di rete, di chiavi o del server, il cliente vede The payment could not be processed right now. Please try again in a moment or choose another payment method. Il motivo tecnico viene scritto nel log e nelle note dell'ordine. Un secondo clic mentre un pagamento è in elaborazione mostra A payment for this order is already being processed. Please wait a moment and check your order status.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna. In entrambi i casi un carrello viene pagato una sola volta: un carrello già pagato, o un addebito approvato il cui ordine non ha ancora uno stato, non viene mai addebitato di nuovo, e il cliente vede la pagina di successo. Se la risposta di Kushki va persa (ad esempio per un timeout), il cliente vede il messaggio generico, ma il tentativo di addebito viene conservato. Quando il webhook firmato segnala l'addebito approvato, l'ordine riceve il suo stato. Se il cliente paga di nuovo prima dell'arrivo di qualsiasi webhook, si tratta di un nuovo addebito; un'approvazione tardiva del primo addebito aggiunge solo una nota su un possibile doppio addebito.

Su OpenCart 4 l'ordine resta nel checkout fino a quando non viene mostrata la pagina di successo. Se nel frattempo l'ordine è stato chiuso senza pagamento (per esempio un addebito in revisione è stato poi rifiutato, oppure l'hai annullato), oppure è già pagato per un carrello precedente e il cliente da allora ha modificato il carrello, il cliente al pagamento torna alla pagina del checkout e il successivo clic su Confirm Order crea un nuovo ordine. Sopra la pagina del checkout il cliente vede Your previous order is closed (declined, cancelled or refunded by the store). Please confirm the order again: the cart will be paid with a new order. se l'ordine è stato chiuso, oppure Your previous order is already paid for other cart contents. Please confirm the order again: the current cart will be paid with a new order. se era stato pagato per un altro carrello. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

Il webhook funziona anche quando 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 (startup action) per il webhook. Il 3-D Secure, le regole antifrode e le rate offerte si configurano nella Kushki Console.

L'estensione accetta solo pagamenti con carta in un unico passaggio. Non prevede rimborsi parziali, carte salvate o abbonamenti, né pagamenti in contanti, bonifico bancario (PSE) o pagamenti con reindirizzamento su carta di debito, né autorizzazione e cattura separate.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente non ha pagato, la carta è stata rifiutata, oppure la risposta di Kushki è andata persa e il webhook non è ancora arrivato. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (predefinito In lavorazione): Kushki ha confermato l'addebito (con la risposta dell'API o con il webhook). Una nota mostra la modalità, l'importo, il numero di ticket Kushki e il riferimento.

On Hold (Review) Status (predefinito In attesa di pagamento): Kushki ha restituito un esito positivo senza numero di ticket, oppure ha segnalato un importo o una valuta diversi da quelli dell'ordine. La nota lo spiega. Controlla la transazione nella Kushki Console ed evadi l'ordine oppure rimborsa il pagamento. Un'approvazione firmata successiva con numero di ticket e importo corrispondente porta l'ordine a Order Status After Payment.

Failed Status (predefinito Non riuscito): il webhook ha segnalato che l'addebito di un ordine nello stato di verifica è stato rifiutato.

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

Se Kushki segnala un altro addebito approvato per un ordine già pagato, annullato o rimborsato, l'ordine non viene modificato. Una nota ti chiede di verificare un eventuale doppio addebito e di rimborsarlo nella Kushki Console. Un webhook dell'ambiente di test per un pagamento live (o viceversa) viene ignorato con una nota.

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

Scheda VibeFox Kushki Payment

In Sales > Orders apri un ordine pagato con Kushki. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Kushki Payment mostra il Ticket number (con l'etichetta TEST per i pagamenti di test), il Transaction reference, l'Environment, il Result, gli importi Charged / order amount, il modulo di rimborso, lo storico dei rimborsi e le Kushki notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Kushki rimborsa l'intero addebito, quindi sono possibili solo rimborsi totali. Nella scheda VibeFox Kushki Payment viene compilato il campo Amount addebitato da Kushki. Facoltativamente inserisci un Reason (optional), clicca su Refund via Kushki e poi conferma la domanda Refund the full payment through Kushki? This cannot be undone. Ti serve il diritto di modificare l'estensione (impostato in System > Users > User Groups). Per qualsiasi altro importo l'estensione mostra Kushki refunds the full payment only. Enter the full charged amount con l'importo, e non viene inviato nulla. Il rimborso viene effettuato nell'importo e nella valuta addebitati da Kushki, quindi dopo una differenza di importo il cliente riottiene quanto è stato effettivamente addebitato, non il totale dell'ordine. Un pagamento può essere rimborsato una sola volta.

Il rimborso viene inviato nella modalità in cui è stato effettuato il pagamento (test o live), quindi il Merchant ID privato di quella modalità deve essere impostato. Se Kushki non accetta il rimborso, la scheda mostra Kushki refund failed con il codice e il messaggio di Kushki, e nessun rimborso viene registrato. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con il ticket di rimborso Kushki, e l'ordine passa a Refunded Status senza notificare il cliente e senza rimettere i prodotti a magazzino, come una modifica manuale dello stato. I rimborsi richiedono un addebito Kushki confermato con numero di ticket.

Le restituzioni di prodotti in Sales > Returns non rimandano denaro tramite Kushki. Annullamenti e rimborsi effettuati nella Kushki Console arrivano tramite webhook e vengono aggiunti alle note. Lo stato dell'ordine non cambia automaticamente.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox Kushki Payment è il primo blocco di Extensions > Extensions > Payments > VibeFox Kushki Payment > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (ad esempio la data fino a cui 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-kushki e il link 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 cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (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 un posto per il 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 solo dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo posto per il dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Kushki 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. Un utente amministratore che ha effettuato l'accesso all'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede il login dell'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 un rinnovo. Lo stato viene ricontrollato automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: una volta al giorno nei primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. Disinstallando l'estensione vengono sempre rimossi la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Kushki non compare al checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo e che la modalità corrente abbia entrambi i Merchant ID: quelli di test in modalità test, quelli live in modalità live. La pagina delle impostazioni mostra un avviso quando mancano gli ID. Controlla che la valuta dell'ordine sia USD o COP, 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: la risposta dell'API Kushki è andata persa, ad esempio per un timeout. Il webhook conferma questi pagamenti. Nella Kushki Console verifica che l'URL del webhook sia esattamente quello mostrato in Webhook URL, per l'account della modalità che usi, e che la chiave di firma di quell'account sia nel campo corrispondente (Test webhook signature o Live webhook signature). Un addebito approvato senza l'importo e la valuta pagati mette l'ordine in On Hold (Review) Status.

Il webhook risponde Webhook signature not configured: non è impostata nessuna firma del webhook. Incolla la chiave di firma nelle impostazioni.

Il webhook risponde Invalid signature: la chiave di firma appartiene a un altro account o a un'altra modalità, oppure la notifica è stata modificata durante il percorso.

Il webhook risponde Order mismatch: la notifica non appartiene a un tentativo di addebito di questo ordine (chiave del tentativo o transazione errata). Non viene modificato nulla.

Il webhook risponde Busy, retry later: l'ordine era in elaborazione da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Kushki può inviare di nuovo la notifica. Gli errori vengono sempre scritti nel log.

L'URL del webhook mostra solo POST nel browser: è normale. L'URL accetta solo notifiche da Kushki.

Il modulo della carta non si carica: il cliente vede The Kushki card form could not be loaded. Please reload the page or choose another payment method. Controlla il Merchant ID pubblico della modalità corrente.

Il cliente vede This payment option is not available in this store. Please pay by card.: nel modulo Kushki è stata scelta un'opzione di pagamento diversa dalla carta. L'estensione addebita solo carte.

Il cliente vede un errore durante il pagamento: attiva Debug log e controlla il campo Log nella pagina dell'estensione. This payment method is not available. Please reload the checkout page. significa che la sessione del checkout non corrisponde più all'ordine, oppure che nel frattempo il metodo di pagamento è stato disattivato: il cliente deve ricaricare il checkout. Un Merchant ID privato errato o mancante produce il messaggio generico secondo cui il pagamento non può essere elaborato.

Il cliente vede Your payment was received, but the order could not be completed automatically: Kushki ha approvato l'addebito, ma OpenCart non è riuscito a impostare lo stato dell'ordine. Il log indica il motivo. Il successivo tentativo di pagamento dello stesso carrello imposta lo stato senza un nuovo addebito.

Il rimborso non riesce con un messaggio sulla modalità: il pagamento è stato effettuato in modalità test o live, e il Merchant ID privato di quella modalità non è impostato. Inseriscilo e riprova.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: il pagamento è già stato rimborsato, l'ordine non ha un numero di ticket Kushki (No Kushki ticket number found for this order — refund it in the Kushki Console.), il tuo gruppo utenti non ha il diritto di modificare l'estensione, oppure il Merchant ID privato della modalità del pagamento non è impostato.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Kushki Payment. 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 alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi, incluso quello che mostra il messaggio sopra la pagina del checkout, e la sua azione di avvio (startup action), che lascia passare il webhook in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità test, Merchant ID, firme dei webhook, registrazione) e il log. Se è disattivo, vengono conservate per una reinstallazione successiva. I registri dei pagamenti Kushki (addebiti e rimborsi) restano sempre, quindi gli ordini pagati in precedenza possono essere rimborsati dopo una reinstallazione. Gli ordini esistenti conservano le proprie note di pagamento.

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

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