VibeFox KOMOJU 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 KOMOJU: ti servono la chiave segreta (sk_live_... e, per la modalità test, sk_test_...) e il token segreto di un webhook creato nella dashboard di KOMOJU (vedi Configurazione). La chiave pubblica non è necessaria. KOMOJU deve poter raggiungere l'URL del webhook del tuo negozio.

Valuta dell'ordine: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD o VND. Per gli ordini in altre valute il metodo di pagamento viene nascosto.

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_komoju_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_komoju_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_komoju_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 KOMOJU 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 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. Nella dashboard di KOMOJU aggiungi un webhook con l'URL e gli eventi indicati nella sezione Webhook URL, e copia il suo token segreto (vedi Configurazione).

5. Inserisci la chiave segreta live e il token segreto del webhook live, e quelle di test per la modalità sandbox. Attiva Enable/Disable e clicca su Save.

OpenCart 4

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

4. Inserisci la chiave di licenza, il webhook e le chiavi 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 URL del webhook).

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità sandbox disattivata.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni, la pagina mostra KOMOJU Sandbox Mode is enabled. mentre la modalità test è attiva. Ti avvisa quando la modalità corrente non ha una chiave segreta (in questo caso il metodo di pagamento viene nascosto al checkout) o un token segreto del webhook (le notifiche di KOMOJU vengono rifiutate, quindi i pagamenti konbini e con bonifico non vengono mai confermati), e quando KOMOJU non supporta la valuta predefinita del negozio (in questo caso il metodo di pagamento viene nascosto per gli ordini in quella valuta). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title deve contenere al 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 zona geografica e gli stati dell'ordine devono esistere. Altrimenti non viene salvato nulla e la pagina indica il campo. Le chiavi mancanti non impediscono il salvataggio.

Metodo di pagamento KOMOJU

Enable/Disable: Enable KOMOJU Payment Gateway 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: KOMOJU Payment. Se lo lasci vuoto, viene usato il nome predefinito. Massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

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

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

Chiavi API live

Trova le chiavi nella dashboard di KOMOJU (lì ci sono i link alle sezioni): la chiave segreta in Settings > API keys, il token segreto del webhook in Settings > Webhooks (aggiungi prima lì l'URL del webhook mostrato nella sezione Webhook URL).

Live Secret Key: la tua chiave segreta live di KOMOJU. Inizia con sk_live_.

Live Webhook Secret Token: il token segreto del webhook live. Serve a verificare la firma di ogni notifica.

Modalità test

KOMOJU usa lo stesso indirizzo API per i pagamenti di test e quelli live: decide la chiave. I pagamenti mantengono la modalità in cui sono stati effettuati, quindi rimborsi e verifiche di stato di un ordine usano sempre la chiave di quella modalità.

Sandbox Mode: Enable test mode (use the test keys below, no real payments). Predefinito: disattivato. Quando è attiva, il passaggio Confirm Order mostra Test mode sopra la descrizione.

Sandbox Secret Key: la tua chiave segreta di test di KOMOJU. Inizia con sk_test_.

Sandbox Webhook Secret Token: il token segreto del webhook della modalità di test.

Le chiavi e i token salvati non vengono più mostrati. Il campo resta vuoto e mostra 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.

URL del webhook

Il webhook informa il tuo negozio sui pagamenti, compresi quelli differiti con konbini e bonifico bancario. Nella dashboard di KOMOJU, alla voce Settings > Webhooks, aggiungi l'URL mostrato in questa sezione, sia per la modalità live sia per quella di test. Su OpenCart 3 ha questo formato: https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Poi copia il token segreto di ogni webhook in Live Webhook Secret Token oppure in Sandbox Webhook Secret Token.

Seleziona questi eventi (sono elencati anche in questa sezione):

Gli eventi di scadenza, annullamento e fallimento modificano l'ordine solo per il suo pagamento attuale, quindi un pagamento di un tentativo precedente non può annullare un ordine che viene pagato in un altro modo. I webhook senza una firma valida vengono rifiutati. I webhook firmati con uno dei due token segreti vengono accettati, ma solo per i pagamenti della stessa modalità. Senza il webhook, i pagamenti con carta vengono comunque confermati quando il cliente torna nel negozio, ma i pagamenti con konbini e bonifico bancario non vengono mai confermati.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo che KOMOJU ha confermato il pagamento. Ogni campo sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: il pagamento è stato catturato e importo e valuta sono stati verificati. Predefinito: Elaborazione.

Awaiting KOMOJU Payment Status: il pagamento è autorizzato: è stato emesso un documento konbini o un bonifico bancario, oppure il pagamento attende la cattura nella dashboard di KOMOJU. Predefinito: In attesa di pagamento.

KOMOJU Payment On Hold Status: l'importo o la valuta pagati non corrispondono all'ordine, oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Una nota spiega il motivo. Predefinito: In attesa di pagamento, perché OpenCart non ha lo stato In attesa.

Cancelled Payment Status: il pagamento di un ordine in attesa è scaduto o è stato annullato, per esempio perché il documento konbini non è stato pagato in tempo. Predefinito: Annullato.

Failed Payment Status: il pagamento di un ordine in attesa non è riuscito. Predefinito: Non riuscito.

Refunded Status: viene impostato quando il pagamento viene rimborsato per intero, dalla pagina dell'ordine o dalla dashboard di KOMOJU. Predefinito: Rimborsato.

Puoi creare i tuoi stati, per esempio Pagamento KOMOJU in attesa o In attesa, in System > Localisation > Order Statuses e selezionarli qui.

Avanzate

Invoice Prefix: il prefisso dei numeri d'ordine inviati a KOMOJU. Il numero presso KOMOJU è composto dal prefisso, dal numero d'ordine di OpenCart e da un breve suffisso casuale, per esempio OC-123-A1B2C3. Se usi più negozi con lo stesso account KOMOJU, rendi il prefisso univoco per ogni negozio. Predefinito: OC-.

Enable Logging: scrive gli eventi KOMOJU e le chiamate API in komoju_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Chiavi e dati dei clienti non vengono registrati. Errori e avvisi vengono sempre scritti. 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 e il log. Gli ordini e le transazioni e i rimborsi KOMOJU vengono sempre conservati, quindi i vecchi ordini possono essere ancora confermati e rimborsati dopo una reinstallazione. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Le chiavi segrete e i token dei webhook non vengono esportati.

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita KOMOJU Payment). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the KOMOJU payment page to complete the payment. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea una sessione di pagamento KOMOJU per il totale dell'ordine nella valuta dell'ordine e invia il cliente alla pagina di pagamento di KOMOJU. L'e-mail, il nome, gli indirizzi di pagamento e di spedizione e gli articoli ordinati vengono trasmessi a KOMOJU. La pagina viene mostrata in giapponese, inglese o coreano, a seconda della lingua del cliente (in inglese per le altre lingue). Lì il cliente sceglie un metodo di pagamento. I metodi disponibili dipendono dal tuo account KOMOJU e dalla valuta dell'ordine.

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, e clicca su Confirm Order in fondo alla pagina di checkout. Per impostazione predefinita OpenCart 4 non chiede un indirizzo di pagamento; in questo caso l'estensione passa a KOMOJU l'indirizzo di spedizione come indirizzo di pagamento.

Dopo il pagamento, il cliente torna nel tuo negozio. L'estensione legge la sessione di pagamento dall'API di KOMOJU con la chiave della modalità del pagamento. L'ordine viene segnato come pagato solo quando KOMOJU lo conferma: tramite il webhook firmato oppure leggendo la sessione quando il cliente torna. Poi l'ordine riceve 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 conferma dell'ordine di OpenCart con Your payment with KOMOJU has been received. Se in quel momento KOMOJU non è raggiungibile, oppure il pagamento è confermato ma non ancora applicato, compare la pagina Payment confirmation con We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. e un pulsante Check again.

Per i pagamenti con konbini e bonifico bancario il cliente riceve un documento di pagamento. L'ordine riceve Awaiting KOMOJU Payment Status, e la pagina di successo indica al cliente che il pagamento è autorizzato e deve essere completato secondo le istruzioni di KOMOJU (per esempio presso un convenience store o tramite bonifico bancario). L'ordine passa a Order Status After Payment quando il cliente paga e KOMOJU invia il webhook. Se il documento scade, l'ordine passa a Cancelled Payment Status.

Se il pagamento non è stato completato, il cliente torna al checkout con il messaggio The payment was not completed. You can try again or choose another payment method. Se l'ordine era già stato annullato, il messaggio è The KOMOJU payment was not completed and the order has been cancelled. Il carrello viene conservato. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina del checkout. Ogni nuovo tentativo (OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; OpenCart 4 aggiorna l'ordine del checkout e paga lo stesso ordine) controlla le sessioni KOMOJU aperte di questo ordine e di altri ordini dello stesso carrello: la sessione aperta di questo ordine con totale invariato viene riutilizzata, le altre sessioni aperte vengono annullate presso KOMOJU, e una sessione pagata nel frattempo conferma il proprio ordine invece di creare un nuovo pagamento. 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 (per esempio è scaduto il documento konbini, il pagamento non è riuscito o l'hai annullato), il cliente torna al checkout con il messaggio Your previous order was cancelled or its payment failed. Please confirm the order again. Se l'ordine è già stato inserito e nel carrello ci sono ora altri prodotti, il messaggio è Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. In entrambi i casi, il successivo clic su Confirm Order paga un nuovo ordine del carrello.

Se KOMOJU non può avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio KOMOJU could not accept this payment: con il motivo, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. oppure Payment error: Could not connect to KOMOJU. Please try again in a moment. Il motivo tecnico viene scritto nel log.

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) che lascia passare il webhook e il ritorno del cliente.

L'estensione non ha un modulo carta sul tuo sito, carte salvate o abbonamenti. Non limita i metodi di pagamento: vengono scelti nella pagina di KOMOJU. Non ha un'azione di cattura manuale: i pagamenti autorizzati per la cattura manuale devono essere catturati nella dashboard di KOMOJU, e l'ordine resta in Awaiting KOMOJU Payment Status fino ad allora.

Ordini e rimborsi

Stati degli ordini

No status (missing order): il cliente è stato inviato a KOMOJU e non ha pagato, oppure KOMOJU non ha ancora confermato il pagamento. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (default Processing): KOMOJU ha confermato il pagamento. Una nota mostra l'ID del pagamento KOMOJU, il metodo di pagamento e come è stato confermato (webhook o ritorno).

Awaiting KOMOJU Payment Status (default Pending): è stato emesso un documento konbini o bonifico che attende il pagamento, oppure un pagamento attende la cattura nella dashboard di KOMOJU.

KOMOJU Payment On Hold Status (default Pending): KOMOJU ha segnalato un importo o una valuta diversi dal totale dell'ordine, oppure il pagamento è stato catturato dopo che l'ordine era stato annullato. La nota lo spiega. Controlla l'ordine ed evadilo oppure rimborsa il pagamento.

Cancelled Payment Status (default Canceled): il documento di pagamento è scaduto oppure il pagamento è stato annullato.

Failed Payment Status (default Failed): il pagamento di un ordine in attesa non è riuscito.

Refunded Status (default Refunded): il pagamento è stato rimborsato per intero, dalla pagina dell'ordine o dalla dashboard di KOMOJU.

Se per un ordine già pagato, o per un altro ordine di un carrello già pagato, viene catturato un secondo pagamento, l'ordine non viene modificato. Una nota ti chiede di rimborsarlo dalla dashboard di KOMOJU se si tratta di un duplicato. Gli ordini rimborsati non vengono mai riaperti.

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

Scheda VibeFox KOMOJU Payment

In Sales > Orders apri un ordine pagato con KOMOJU. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox KOMOJU Payment mostra l'ID del pagamento KOMOJU (collegato al pagamento nella dashboard di KOMOJU) con un'etichetta Test mode per i pagamenti di prova, il metodo di pagamento, la sessione, il numero d'ordine presso KOMOJU, lo stato, gli importi Paid / refunded, il modulo di rimborso, la cronologia dei rimborsi (da OpenCart o dalla dashboard di KOMOJU) e le KOMOJU notes dell'ordine. La scheda è visibile agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox KOMOJU Payment inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via KOMOJU. Conferma la domanda Refund this amount through KOMOJU? This cannot be undone. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi sono limitati all'importo che KOMOJU ha effettivamente addebitato, quindi dopo una differenza di importo puoi rimborsare fino a quanto ha pagato il cliente, non il totale dell'ordine. Il rimborso viene inviato con la chiave della modalità in cui è stato effettuato il pagamento, quindi la chiave segreta di quella modalità deve essere impostata. L'estensione controlla prima il pagamento presso KOMOJU e rifiuta i rimborsi superiori all'importo ancora rimborsabile. Se KOMOJU non può rimborsare un pagamento automaticamente (alcuni metodi, per esempio konbini, richiedono i dati bancari del cliente), viene mostrato il messaggio di errore di KOMOJU e non viene registrato nulla: gestisci questi rimborsi nella dashboard di KOMOJU. Un rimborso viene considerato eseguito solo quando KOMOJU lo conferma. Un rimborso riuscito viene aggiunto alla cronologia dei rimborsi e alle note. Un rimborso totale imposta l'ordine su Refunded Status senza riportare i prodotti in magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato. I rimborsi sono disponibili una volta che KOMOJU ha catturato il pagamento.

Per i pagamenti che KOMOJU ha convertito in un'altra valuta (per esempio konbini in JPY per un ordine in EUR), da OpenCart è possibile solo un rimborso totale. Effettua i rimborsi parziali nella dashboard di KOMOJU.

Le restituzioni di prodotti in Sales > Returns non rimandano denaro tramite KOMOJU.

I rimborsi effettuati nella dashboard di KOMOJU arrivano tramite webhook e vengono aggiunti alla cronologia dei rimborsi con una nota. Quando viene rimborsato l'intero pagamento, l'ordine viene impostato su Refunded Status. I rimborsi parziali effettuati nella dashboard per pagamenti convertiti in un'altra valuta vengono solo annotati nell'ordine: registra manualmente in OpenCart l'importo corrispondente.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox KOMOJU Payment è il primo blocco di Extensions > Extensions > Payments > VibeFox KOMOJU Payment > 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-komoju 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, KOMOJU 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: i pagamenti già avviati vengono comunque confermati, e i rimborsi funzionano.

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

KOMOJU non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità corrente abbia una chiave segreta: Sandbox Secret Key in modalità sandbox, Live Secret Key in modalità live. Il cliente deve pagare in una valuta supportata da KOMOJU. La pagina delle impostazioni mostra un avviso quando manca qualcosa. 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 senza stato: il webhook non funziona. Nella dashboard di KOMOJU controlla che il webhook esista per la modalità che usi, che il suo URL sia esattamente quello mostrato nella sezione Webhook URL e che gli eventi siano selezionati. Controlla che il token segreto sia nel campo giusto (Live Webhook Secret Token o Sandbox Webhook Secret Token) e consulta il campo Log nella pagina dell'estensione. I pagamenti con carta vengono confermati anche quando il cliente torna nel tuo negozio, ma quelli con konbini e bonifico bancario vengono confermati solo dal webhook.

Il webhook risponde Failed to verify KOMOJU webhook signature.: il token segreto manca oppure appartiene a un altro webhook. KOMOJU ripete la notifica.

Il webhook risponde Mode mismatch, ignored.: il webhook è stato firmato con il token segreto dell'altra modalità rispetto a quella in cui è stato effettuato il pagamento. Usa webhook e token separati per la modalità live e quella di test, e controlla che non siano scambiati.

Il webhook risponde Order not found.: il pagamento non appartiene a un ordine di questo negozio, per esempio perché è stato effettuato da un altro negozio con lo stesso account KOMOJU. L'evento viene ignorato.

Il webhook risponde Order is busy, retry later. oppure Temporary error, retry later.: l'ordine era in aggiornamento da parte di un'altra richiesta, oppure in quel momento il pagamento non poteva essere elaborato. KOMOJU ripete la notifica. Il motivo è nel log.

L'URL del webhook mostra un errore nel browser: è normale. L'URL accetta solo richieste firmate da KOMOJU.

L'ordine è in uno stato in attesa o sospeso: leggi le KOMOJU notes nella scheda dell'ordine. È in attesa di pagamento un documento, un pagamento attende la cattura nella dashboard di KOMOJU, l'importo o la valuta non corrispondevano, oppure il pagamento è arrivato dopo l'annullamento dell'ordine.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: KOMOJU non ha ancora catturato il pagamento, è rimborsato per intero, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure la chiave segreta della modalità del pagamento non è impostata.

Il rimborso non riesce: leggi il messaggio. Potrebbe mancare la chiave segreta della modalità in cui è stato effettuato il pagamento, il pagamento potrebbe non essere rimborsabile automaticamente (rimborsalo nella dashboard di KOMOJU), KOMOJU potrebbe non riconoscere il pagamento con la chiave configurata, oppure per un pagamento convertito è possibile solo un rimborso totale.

Per gli sviluppatori: l'estensione attiva gli eventi OpenCart komoju_p_supported_currencies (per modificare l'elenco delle valute) e komoju_p_session_params (per modificare la sessione di pagamento, per esempio i metodi di pagamento).

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox KOMOJU 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 e la sua azione di avvio (startup action), che lascia passare il webhook e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, chiavi, token dei webhook, modalità sandbox, prefisso fattura, registrazione) e il log. Se è disattivo, vengono conservate per una futura reinstallazione. Le transazioni e i rimborsi KOMOJU vengono sempre conservati, quindi i vecchi ordini possono essere ancora confermati 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 KOMOJU Payment nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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