VibeFox Klarna for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato con la versione 3.0.5.0) o 4.0.2 e successive (testato con la versione 4.1.0.3).

PHP: 8.0 o successiva.

Account commerciante Klarna: ti servono le credenziali API di Klarna (nome utente e password) del tuo account commerciante per una regione API, e le credenziali di test del portale Klarna Playground (vedi Configurazione). Ogni regione API ha le proprie credenziali. È possibile usare un solo account commerciante (una regione API) per negozio.

Valuta: una valuta Klarna della tua regione: EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF o RON in Europa; USD, CAD o MXN in Nord America; AUD o NZD in Oceania. La valuta deve esistere in System > Localisation > Currencies.

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_klarna_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_klarna_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_klarna_payment-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non richiede un aggiornamento. Invece dell'installer puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions, scegli il tipo Payments, trova VibeFox Klarna Payments 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 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. Scegli la API region del tuo account commerciante Klarna.

5. Inserisci il nome utente e la password di test dal portale Klarna Playground, lascia attivo Test mode, attiva Enable/Disable, clicca su Save ed effettua un ordine di prova.

6. Inserisci il nome utente e la password live dal Klarna Merchant Portal, disattiva Test mode e scegli quando gli ordini vengono catturati (predefinito: quando l'ordine viene spedito o completato).

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_klarna_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 Klarna Payments, clicca su Install (il pulsante verde +), poi su Edit (il pulsante a matita).

4. Inserisci la chiave di licenza, scegli la API region, inserisci le credenziali e la modalità di cattura come nei passaggi 3–6 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'URL di notifica (vedi Notifiche).

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità test attiva. L'URL di notifica viene inviato con ogni ordine Klarna, quindi non c'è nulla da configurare in Klarna.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni, la pagina mostra TEST MODE: Klarna playground, no real payments. oppure LIVE: real Klarna payments. Ti avvisa se nome utente o password della modalità attiva mancano (in questo caso Klarna viene nascosto al checkout) e se la valuta predefinita del negozio non è gestita da Klarna nella regione API selezionata. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto (massimo 128 caratteri), Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total deve essere un numero maggiore o uguale a 0, e la regione API, la modalità di cattura, la zona geografica e gli stati dell'ordine devono essere validi. Altrimenti non viene salvato nulla e la pagina indica il campo. Le credenziali mancanti non impediscono il salvataggio.

Klarna Payments

Enable/Disable: attiva o disattiva il metodo di pagamento. Predefinito: disattivato. Klarna viene mostrato al checkout solo se nome utente e password della modalità attiva sono compilati e il paese di fatturazione del cliente è un mercato Klarna della regione API, con pagamento nella valuta di quel paese.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Klarna. Obbligatorio.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il widget Klarna. Predefinito: Pay now, later or in instalments with Klarna.

Sort Order: la posizione di Klarna tra i metodi di pagamento al checkout. Lascia il campo vuoto oppure inserisci un numero intero.

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

Credenziali API

Le credenziali API di Klarna (nome utente e password) si creano nel Klarna Merchant Portal alla voce Settings > Klarna API credentials (la sezione contiene i link). Le credenziali di test provengono dal portale Playground: una per l'Europa, una per il Nord America e l'Oceania. Ogni regione API ha le proprie credenziali.

Test mode: usa l'ambiente Klarna Playground (credenziali di test, nessun pagamento reale). Predefinito: attivo. Mentre la modalità test è attiva, i clienti vedono TEST MODE: Klarna playground, no real payment is made. nel passaggio Confirm Order. Gli ordini mantengono l'ambiente in cui sono stati effettuati: le catture e i rimborsi degli ordini Playground usano sempre le credenziali di test.

API region: la regione del tuo account commerciante Klarna. I clienti possono pagare con Klarna solo dai paesi di questa regione, nella valuta del loro paese. Il paese viene preso dall'indirizzo di pagamento dell'ordine.

Live username (UID): il nome utente API di produzione, per esempio PK12345_abcdef012345.

Live password: la password API di produzione (segreto condiviso).

Test username (UID): il nome utente API del Playground.

Test password: la password API del Playground (segreto condiviso).

Le password salvate non vengono più mostrate. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere una password salvata, seleziona Clear the saved password on save sotto il campo e clicca su Save.

Gestione degli ordini

Un ordine Klarna effettuato è un'autorizzazione: il cliente viene addebitato solo quando l'ordine viene catturato. Le autorizzazioni non catturate scadono, di solito dopo 28 giorni, quindi spedisci gli ordini in tempo oppure usa la cattura automatica.

Capture: il momento in cui il cliente viene addebitato. I rimborsi sono possibili solo per gli importi catturati.

Cancellation: annulla l'ordine Klarna (libera l'autorizzazione) quando un ordine non ancora catturato viene impostato allo stato Canceled Status indicato sotto. Predefinito: attivo.

Stati degli ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo che Klarna ha registrato l'ordine Klarna per l'acquisto approvato nel widget. Un acquisto non approvato da Klarna lascia l'ordine senza stato, e il cliente resta nel passaggio Confirm Order. Ogni campo sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: Klarna ha accettato l'acquisto (stato antifrode ACCEPTED). L'importo viene autorizzato e catturato secondo Capture. Predefinito: Elaborazione.

Awaiting Fraud Review Status: Klarna ha registrato l'ordine come PENDING (verifica antifrode). Non spedirlo finché la notifica di Klarna non lo accetta; l'ordine si aggiorna automaticamente. Predefinito: In attesa di pagamento.

On Hold Status: Klarna ha restituito uno stato antifrode inatteso, oppure importo o valuta comunicati da Klarna non corrispondono all'ordine. Una nota spiega cosa controllare. Predefinito: In attesa di pagamento.

Payment Error Status: Klarna ha rifiutato o bloccato l'acquisto dopo la verifica antifrode. Non spedire l'ordine. Predefinito: Non riuscito.

Canceled Status: impostare un ordine non ancora catturato a questo stato annulla l'ordine Klarna (vedi Cancellation). Klarna lo imposta quando segnala l'ordine Klarna come annullato, scaduto o chiuso. Predefinito: Annullato.

Refunded Status: l'importo catturato è stato rimborsato per intero nella scheda Klarna della pagina dell'ordine. I rimborsi parziali aggiungono solo una nota. Predefinito: Rimborsato.

OpenCart non ha stati propri per una verifica antifrode o un pagamento in sospeso. Puoi crearli in System > Localisation > Order Statuses e selezionarli qui.

Notifiche

Klarna comunica l'esito di una verifica antifrode (ordini registrati come in sospeso) all'indirizzo mostrato in Notification URL. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_klarna_payment/notification, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_klarna_payment/payment/wcp_klarna_payment.notification. L'URL viene inviato automaticamente con ogni ordine, quindi non c'è nulla da configurare in Klarna. Il contenuto della notifica non viene mai considerato attendibile: ogni notifica viene verificata con la Klarna Order Management API, usando le credenziali dell'ambiente e della regione in cui è stato effettuato l'ordine, e l'ordine Klarna deve fare riferimento a questo numero d'ordine. L'estensione agisce in base a quanto comunica Klarna:

Se Klarna accetta un acquisto dopo che hai annullato o rimborsato l'ordine, l'ordine non viene riaperto e l'autorizzazione Klarna viene rilasciata. La notifica 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) che lascia passare la notifica e il ritorno del cliente da Klarna.

Avanzate

Debug log: registra le chiamate API e gli eventi di pagamento in wc_kl_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Gli errori vengono sempre registrati. Il log non contiene mai credenziali, token di autorizzazione o dati 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, la disinstallazione dell'estensione rimuove le impostazioni del gateway, il log e le sessioni temporanee del widget. I dati degli ordini (ID ordini Klarna, rimborsi) vengono sempre conservati. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Le password non vengono esportate.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Le password salvate vengono mantenute.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Klarna). OpenCart crea l'ordine nel passaggio Confirm Order, ancora senza stato. In questo passaggio il cliente vede il badge Klarna, la tua descrizione e il widget Klarna. L'estensione crea sul server la sessione Klarna a partire da quell'ordine: prodotti con le relative opzioni, buoni regalo, spedizione, sconti da coupon, voucher e punti fedeltà, tasse e indirizzi. Nel widget il cliente sceglie pagamento immediato, pagamento differito o a rate, in base a ciò che offre Klarna. Quando il cliente clicca su Confirm Order, Klarna autorizza l'acquisto nel widget e l'estensione crea l'ordine Klarna lato server con i dati dell'ordine OpenCart. L'ordine Klarna riporta il numero dell'ordine OpenCart come riferimento del commerciante.

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 widget Klarna compare poi nel blocco di conferma dell'ordine in fondo alla pagina di checkout, sopra il pulsante Confirm Order. OpenCart 4 non ha buoni regalo, quindi non vengono inviati a Klarna. Per impostazione predefinita OpenCart 4 non chiede un indirizzo di pagamento; in questo caso l'estensione usa l'indirizzo di spedizione come indirizzo di fatturazione e il suo paese come paese dell'acquisto.

Il risultato dipende dallo stato antifrode di Klarna:

Se Klarna non può accettare l'ordine, il cliente resta nel passaggio Confirm Order con un breve messaggio, per esempio Klarna could not accept this order. Please check your billing details or choose another payment method., Klarna did not respond. Please try again in a moment. oppure, quando l'autorizzazione è scaduta, un invito a cliccare di nuovo su "Confirm Order". I dettagli vengono scritti nel log e l'ordine riceve una nota. Se il paese e la valuta del cliente non corrispondono a un mercato Klarna della tua regione, il cliente vede Klarna is not available for your billing country and currency. Please choose another payment method.

Cliccare due volte, ricaricare la pagina o pagare lo stesso carrello in una seconda scheda del browser non crea mai un secondo ordine Klarna (OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; OpenCart 4 aggiorna l'ordine del checkout, quindi dopo un acquisto rifiutato il cliente paga lo stesso ordine). Se Klarna ha approvato l'acquisto ma non è stato possibile impostare lo stato dell'ordine, il cliente vede Your Klarna purchase was approved, but the order could not be completed automatically. Please contact us — do not pay again. Il tentativo successivo o la notifica di Klarna impostano lo stato a partire dall'ordine Klarna salvato, senza una nuova autorizzazione. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

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 l'hai annullato), il cliente torna al checkout con il messaggio Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. Se l'ordine è già stato inserito e il carrello è cambiato, compare il messaggio Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. In entrambi i casi, il successivo clic su Confirm Order paga un nuovo ordine del carrello. Questi messaggi vengono mostrati sopra la pagina del checkout.

L'estensione non include Klarna Checkout (KCO, sostituzione completa del checkout), i pulsanti Klarna Express Checkout, On-site messaging né Sign in with Klarna, né abbonamenti o metodi di pagamento salvati, né catture parziali per riga d'ordine. Le righe dell'ordine non vengono inviate di nuovo a Klarna quando modifichi un ordine dopo che è stato effettuato.

Ordini e rimborsi

Stati degli ordini

No status (missing order): il cliente non ha completato l'autorizzazione Klarna, oppure Klarna ha rifiutato l'acquisto. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (default Processing): Klarna ha accettato l'acquisto. Una nota mostra l'ID dell'ordine Klarna e quando verrà catturato.

Awaiting Fraud Review Status (default Pending): l'acquisto è in attesa della verifica antifrode di Klarna. La notifica di Klarna sposta l'ordine su Order Status After Payment, Payment Error Status o Canceled Status.

On Hold Status (default Pending): Klarna ha restituito uno stato antifrode inatteso, oppure importo o valuta comunicati da Klarna non corrispondono all'ordine. La nota lo spiega. Controlla l'ordine nel Klarna Merchant Portal.

Payment Error Status (default Failed): Klarna ha rifiutato o bloccato l'acquisto dopo la verifica antifrode. Non spedire l'ordine.

Canceled Status (default Canceled): hai annullato l'ordine, oppure Klarna segnala l'ordine Klarna come annullato, scaduto o chiuso. Con Cancellation attivo, annullare un ordine non ancora catturato annulla anche l'ordine Klarna e rilascia l'autorizzazione, quindi il cliente non viene addebitato. Un ordine già catturato non viene annullato su Klarna: rimborsalo per restituire il denaro.

Refunded Status (default Refunded): l'importo catturato è stato rimborsato per intero tramite l'estensione.

Le note sono voci della History dell'ordine che il cliente non vede. Iniziano con la parola Klarna.

Capture

Con When the order is shipped / completed, cambiare lo stato di un ordine in Sales > Orders (Add History) a uno stato completato cattura il totale dell'ordine prima del salvataggio del nuovo stato. Se Klarna rifiuta la cattura, per esempio perché il totale dell'ordine è salito oltre l'importo ancora autorizzato dopo una modifica, lo stato non cambia, non viene inviata alcuna e-mail e la pagina dell'ordine mostra il motivo al posto del messaggio di successo. Una nota indica che il cliente NON è stato addebitato. Correggi il problema e cambia di nuovo lo stato per riprovare, oppure cattura nel Klarna Merchant Portal e imposta Capture su manuale. Una cattura riuscita aggiunge una nota con l'importo catturato e l'ID della cattura. Il primo stato di un nuovo ordine e il passaggio da uno stato completato a un altro stato completato non catturano nulla. Catture e annullamenti continuano a funzionare finché l'estensione è installata, anche se disattivata. Su OpenCart 4.1 anche il cambio di stato rifiutato mostra il motivo nella pagina dell'ordine; su OpenCart 4.0.x lo stato viene rifiutato allo stesso modo, ma il motivo appare solo nella nota della cronologia dell'ordine.

Scheda VibeFox Klarna Payments

In Sales > Orders apri un ordine pagato con Klarna. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Klarna Payments mostra l'ID dell'ordine Klarna con ambiente e regione, un'etichetta Playground per gli ordini di test, lo stato antifrode e lo stato Klarna, l'importo Authorized, gli importi Captured / refunded, il modulo di rimborso, la cronologia dei rimborsi e le Klarna notes dell'ordine. La scheda è visibile agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Klarna Payments inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Klarna. Conferma la domanda Refund this amount through Klarna? This cannot be undone. Sono supportati rimborsi totali e parziali di importi catturati, fino a quanto Klarna indica come catturato meno quanto già rimborsato. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Il rimborso viene inviato all'ambiente e alla regione in cui è stato effettuato l'ordine, quindi devono essere impostate le credenziali di quell'ambiente. Se Klarna non accetta il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto alla cronologia dei rimborsi e alle note, con l'ID del rimborso Klarna. Un rimborso totale imposta l'ordine su Refunded Status senza avvisare il cliente e senza riportare i prodotti in magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato. Un rimborso ripetuto non viene mai eseguito due volte.

Un ordine non ancora catturato non può essere rimborsato: annullalo per rilasciare l'autorizzazione. Con Capture impostato su manuale, il negozio non sa cosa hai catturato nel Klarna Merchant Portal. Il modulo di rimborso viene mostrato con un importo vuoto, e Klarna verifica l'importo al momento dell'invio.

Le restituzioni di prodotti in Sales > Returns non rimandano denaro tramite Klarna. I rimborsi effettuati nel Klarna Merchant Portal non vengono aggiunti alla scheda, ma contano nell'importo che Klarna consente ancora di rimborsare.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox Klarna Payments è il primo blocco di Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo, 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 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: opencart-payment-klarna 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 incluse le lingue inglese e russa).

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 oppure License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato un posto 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 nella configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il posto dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Klarna 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 testare 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 vengono coinvolti: le notifiche Klarna continuano a essere elaborate, e gli ordini possono essere ancora catturati, annullati e rimborsati.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e assistenza richiedono il rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: 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

Klarna non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo e che le credenziali della modalità attiva siano compilate: nome utente e password di test in modalità test, quelle live in modalità live. La pagina delle impostazioni mostra un avviso quando mancano. Il paese di pagamento del cliente deve essere un paese Klarna della tua API region, con pagamento nella valuta di quel paese (per esempio, un cliente svedese deve pagare in SEK). Controlla 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 in Awaiting Fraud Review Status: l'acquisto è in attesa della verifica antifrode di Klarna, e l'ordine viene aggiornato quando arriva la notifica di Klarna. Controlla che il tuo negozio possa ricevere richieste da Klarna all'indirizzo Notification URL mostrato nelle impostazioni, e che siano ancora inserite le credenziali dell'ambiente in cui è stato effettuato l'ordine. Attiva Debug log e controlla il campo Log nella pagina dell'estensione.

La notifica risponde Not configured: mancano le credenziali dell'ambiente (test o live) in cui è stato effettuato l'ordine, quindi la notifica non può essere verificata. Inseriscile. Klarna ripeterà la notifica.

La notifica risponde Verification failed: non è stato possibile leggere l'ordine Klarna dalla Order Management API. Klarna ripeterà la notifica.

La notifica risponde Busy: l'ordine era in aggiornamento da parte di un'altra richiesta nello stesso momento. Klarna ripeterà la notifica.

La notifica risponde mismatch_ref o Unknown order: l'ordine Klarna non si riferisce a questo ordine, oppure l'estensione non lo conosce. L'ordine non viene modificato.

Il widget non si carica: il cliente vede Klarna could not be loaded. Please try again or choose another payment method. oppure Klarna is not available for this purchase. Controlla le credenziali della modalità attiva e il paese e la valuta del cliente.

Il cambio di stato a Complete o Shipped viene rifiutato: la cattura Klarna non è riuscita. Leggi il motivo nella pagina dell'ordine o nella nota. Il totale dell'ordine potrebbe richiedere più di quanto ancora autorizzato, l'ordine Klarna potrebbe non essere ancora accettato, oppure l'autorizzazione potrebbe essere scaduta. Risolvi il problema e cambia di nuovo lo stato, oppure cattura nel Klarna Merchant Portal.

Il rimborso non riesce: leggi il messaggio nella scheda. L'ordine potrebbe non essere ancora catturato (annullalo al suo posto), l'importo potrebbe superare quanto ancora rimborsabile, oppure potrebbero mancare le credenziali dell'ambiente dell'ordine.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: non c'è ancora nulla di catturato, l'importo catturato è rimborsato per intero, oppure il tuo gruppo utenti non ha il permesso di modificare l'estensione.

Il cliente vede This order is already being paid: è in corso un'altra richiesta per lo stesso acquisto, per esempio per un doppio clic. Attendi un momento e controlla se l'ordine ha ricevuto uno stato.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Klarna Payments. 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 Order statuses, che tornano ai valori predefiniti alla reinstallazione. Vengono rimossi anche gli eventi OpenCart dell'estensione, quindi i cambi di stato non catturano né annullano più gli ordini Klarna (su OpenCart 4 anche la sua azione di avvio (startup action), che lascia passare la notifica e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità test, regione API, credenziali, cattura, annullamento, registrazione), il log e le sessioni temporanee del widget. Se è disattivo, vengono conservate per una futura reinstallazione. Gli ordini e i rimborsi Klarna vengono sempre conservati, quindi gli ordini effettuati prima possono essere ancora catturati e rimborsati dopo una reinstallazione. Gli ordini esistenti mantengono 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 Klarna Payments nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

Klarna è un marchio registrato del suo titolare. Questa estensione non è affiliata a Klarna né approvata da Klarna.