VibeFox Omise 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 successivo.

HTTPS: i campi della carta si trovano nel checkout del tuo negozio, quindi il checkout deve essere servito tramite HTTPS. I dati della carta, comunque, non arrivano mai al tuo server. Omise invia webhook solo a indirizzi HTTPS, e la pagina 3-D Secure della banca deve essere un indirizzo HTTPS.

Valuta: una tra THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD. Quando il cliente paga in un'altra valuta, il metodo di pagamento viene nascosto al checkout.

Account Omise: ti servono la chiave pubblica e la chiave segreta del tuo account Omise, sia per il test sia per la modalità live, da Settings > Keys nella dashboard di Omise, e un endpoint webhook in Settings > Webhooks (vedi Configuration).

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

Installazione

Il download è 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_omise_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_omise_payment.ocmod.zip. Installa solo il pacchetto della 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, fai clic su Upload e scegli il file wcp_omise_payment-oc3-(version).ocmod.zip. L'estensione non contiene modifiche OCMOD, quindi non è necessario aggiornare Extensions > Modifications. In alternativa all'installer, puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

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

3. Fai clic su Edit (il pulsante con la 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 fai clic su Activate (vedi License key).

4. Inserisci le chiavi Omise di test e live e aggiungi nella dashboard di Omise l'URL del webhook mostrato nella pagina delle impostazioni (vedi Configuration).

5. Attiva Enable/Disable e fai clic su Save. Prova un pagamento in modalità test con una carta di test di Omise, come 4242 4242 4242 4242, poi disattiva Test mode.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_omise_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. Fai clic su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Omise Payment, fai clic su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza, le chiavi Omise e il webhook come nei passaggi da 3 a 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 Pagamento e 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 Omise Payment > 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 is on — orders are charged with the test keys, no real money is moved. mentre la modalità test è attiva, ti avvisa quando manca la chiave pubblica o la chiave segreta della modalità corrente (in tal caso il metodo di pagamento viene nascosto al checkout) e ti avvisa quando Omise non accetta la valuta predefinita del tuo negozio. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, un Title vuoto o più lungo di 128 caratteri, un Sort Order che non è un numero intero, un Total che non è un numero maggiore o uguale a 0 o uno stato dell'ordine sconosciuto bloccano il salvataggio: non viene salvato nulla e viene mostrato l'errore. Una chiave con il prefisso sbagliato (per esempio una chiave di test in un campo live) non viene salvata: resta il valore precedente, un avviso indica il campo e gli altri campi vengono salvati.

Omise

Enable/Disable: Enable card payments via Omise attiva o disattiva il metodo di pagamento. Predefinito: off.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento memorizzato nell'ordine. Predefinito: Credit / Debit Card. Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato sopra il modulo della carta nel passaggio Confirm Order. Predefinito: Pay securely with your credit or debit card via Omise.

Sort Order: la posizione di Omise tra i metodi di pagamento del checkout. Lascialo vuoto o inserisci un numero intero.

Geo Zone: mostra il modulo della carta solo per gli indirizzi di pagamento nella zona geografica selezionata. Predefinito: All zones. Le zone geografiche si configurano in System > Localisation > Geo Zones. In OpenCart 4, quando il negozio non richiede un indirizzo di pagamento, viene usato l'indirizzo di spedizione.

Total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che il metodo di pagamento venga offerto. Lascialo vuoto per offrirlo per qualsiasi totale.

Chiavi API

Trovi le chiavi nella dashboard di Omise, in Settings > Keys (la pagina contiene un collegamento). Le chiavi di test iniziano con pkey_test_ e skey_test_, quelle live con pkey_ e skey_.

Test mode: usa le chiavi di test, senza addebiti reali. Cambia entrambe le chiavi. Acquisizioni, rimborsi e verifiche dello stato di un ordine usano sempre le chiavi della modalità in cui l'ordine è stato pagato. Predefinito: on.

Test public key: la chiave pubblica della modalità test, pkey_test_..., usata da Omise.js nel browser.

Test secret key: la chiave segreta della modalità test, skey_test_...

Live public key: la chiave pubblica della modalità live, pkey_..., usata da Omise.js nel browser.

Live secret key: la chiave segreta della modalità live, skey_...

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

Pagamento e webhook

Webhook URL: l'indirizzo del webhook del tuo negozio. In OpenCart 3 ha questa forma: https://your-store/index.php?route=extension/payment/wcp_omise_payment/webhook, in OpenCart 4: https://your-store/index.php?route=extension/wcp_omise_payment/payment/wcp_omise_payment.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Copialo esattamente come lo mostrano le impostazioni e aggiungilo nella dashboard di Omise, in Settings > Webhooks (solo HTTPS). L'estensione gestisce questi eventi (sono elencati anche in questa sezione):

Omise non firma i webhook, quindi il contenuto di un webhook non è mai considerato attendibile: l'addebito deve essere stato creato da questo negozio per quell'ordine, e il suo stato viene riletto dall'API di Omise con la chiave segreta della modalità del pagamento. Senza il webhook, un ordine il cui cliente chiude il browser durante 3-D Secure non viene aggiornato automaticamente, e le acquisizioni fatte nella dashboard di Omise non vengono rilevate finché non fai clic su Sync payment status.

Payment action: cosa succede all'importo della carta.

Per-charge webhook: invia l'URL del webhook con ogni addebito. Utile quando più negozi condividono un unico account Omise. Funziona solo quando il negozio usa HTTPS; altrimenti viene usato il webhook della dashboard. Predefinito: off.

Ordini

L'ordine viene creato nel passaggio Confirm Order senza stato (un ordine mancante) e riceve uno stato solo dopo che Omise ha risposto per la carta. OpenCart non ha lo stato On hold: per impostazione predefinita, gli stati autorizzato, in revisione e in attesa sono tutti Pending, e la scheda dell'ordine e le note li distinguono. Puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui.

Order Status After Payment: la carta è stata addebitata (Capture immediately, oppure un'acquisizione successiva). Predefinito: Processing.

Authorized Status: Authorize only: l'importo è riservato, non ancora acquisito. Predefinito: Pending.

On Hold (Review) Status: l'importo o la valuta addebitati non corrispondono all'ordine. Predefinito: Pending.

Awaiting Payment Status: il cliente ha terminato, ma Omise non ha ancora confermato l'addebito. Predefinito: Pending.

Failed Status: un addebito in sospeso di un ordine con uno stato è fallito in seguito. Predefinito: Failed.

Canceled Status: l'addebito è scaduto o l'autorizzazione è stata annullata; non è stato prelevato alcun denaro. Predefinito: Canceled.

Refunded Status: impostato dopo che il pagamento è stato rimborsato interamente dalla scheda dell'ordine. Predefinito: Refunded.

Avanzate

Debug log: scrive le richieste API e gli eventi di pagamento in omise_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 spostato in omise_p_debug.old.log.php. Chiavi, token e dati della carta non vengono mai registrati. Predefinito: off. Con l'interruttore disattivato non viene scritto nulla, errori compresi, quindi attivalo quando cerchi un problema.

Log: mostra la dimensione e le voci più recenti del registro. Fai clic su Clear log per svuotarlo.

Delete data on uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni e il registro di debug. Gli addebiti e i rimborsi Omise degli ordini fanno parte dello storico dei pagamenti e vengono sempre conservati. Predefinito: off.

Importazione / Esportazione

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

Import: incolla un JSON esportato in precedenza e fai clic 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 Credit / Debit Card). Nel passaggio Confirm Order il cliente vede la tua descrizione e il modulo della carta: Name on card, Card number, Expiry month (MM), Expiry year (YYYY) e Security code (CVV). In modalità test il modulo mostra TEST MODE — use Omise test cards (e.g. 4242 4242 4242 4242), no real charges are made. OpenCart crea l'ordine in questo passaggio, ancora senza stato. In OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco dei metodi di pagamento, nella finestra Payment method options; il modulo della carta si trova nella sezione di conferma in fondo alla pagina del checkout, sopra Confirm Order. Quando il cliente fa clic su Confirm Order, Omise.js trasforma la carta in un token monouso nel browser, usando l'indirizzo di pagamento dell'ordine (in OpenCart 4, quando il negozio non richiede un indirizzo di pagamento, l'indirizzo di spedizione). I campi della carta non vengono mai inviati al tuo negozio. I campi mancanti o non validi vengono mostrati sopra il modulo, per esempio Please enter a valid card number.

Il tuo negozio crea quindi l'addebito con la chiave segreta, per il totale dell'ordine nella valuta dell'ordine. La descrizione dell'addebito è il nome del negozio e il numero dell'ordine, e l'ID dell'ordine viene memorizzato nei metadati dell'addebito. Se la banca richiede 3-D Secure, il cliente viene inviato alla pagina della banca e poi torna nel tuo negozio, e il risultato viene riletto dall'API di Omise.

L'ordine viene segnato come pagato solo dopo che Omise lo conferma: l'addebito deve essere acquisito e il suo importo e la sua valuta devono corrispondere all'ordine. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento delle scorte, e il cliente vede la pagina di successo dell'ordine di OpenCart con Your card payment has been received. Con Authorize only la pagina dice Your card payment has been authorized. The amount will be charged when your order is processed. Se Omise segnala ancora il pagamento come in sospeso, l'ordine riceve l'Awaiting Payment Status e la pagina dice Your payment is being confirmed by Omise. You will receive an e-mail as soon as it is confirmed — please do not pay again. Quando Omise conferma o rifiuta il pagamento più tardi (il webhook o il ritorno del cliente), il nuovo stato dell'ordine viene inviato con notifica al cliente, quindi OpenCart gliela invia via e-mail. Se il pagamento non può essere confermato subito dopo 3-D Secure, una pagina Payment confirmation mostra We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again. e un pulsante Check again.

Se la carta viene rifiutata, l'ordine resta senza stato. Il cliente resta nel passaggio Confirm Order con Payment failed: e un motivo, per esempio fondi insufficienti, un codice di sicurezza non valido o un rifiuto dell'emittente della carta, e può riprovare con lo stesso carrello. Se 3-D Secure fallisce, il cliente torna al checkout con il motivo; se nel frattempo l'addebito è scaduto o è stato stornato, il messaggio è The payment was not completed. Please try again. In OpenCart 4 questi messaggi dopo 3-D Secure vengono mostrati sopra la pagina del checkout.

Un nuovo tentativo non addebita mai due volte. 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, quindi dopo una carta rifiutata o un 3-D Secure fallito il cliente paga lo stesso ordine con un nuovo addebito. Se il precedente addebito del carrello è già pagato o autorizzato, quell'ordine riceve il suo stato e non viene effettuato alcun nuovo addebito. Un tentativo 3-D Secure non completato scade prima che venga effettuato un nuovo addebito. Se un secondo addebito risulta ancora pagato per un carrello già pagato (per esempio in un'altra scheda del browser), nessun ordine viene modificato e una nota sull'ordine pagato ti chiede di rimborsarlo o annullarlo nella dashboard di Omise.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se quell'ordine nel frattempo è stato chiuso (per esempio perché il suo addebito è fallito o è scaduto, oppure perché l'hai annullato o rimborsato), il cliente torna al checkout con Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order., e il successivo Confirm Order paga un nuovo ordine. Se quell'ordine è già pagato e il carrello ora contiene altri prodotti o quantità, il cliente torna anch'esso al checkout, e il nuovo carrello riceve un nuovo ordine.

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 che lascia passare il webhook e il ritorno del cliente da 3-D Secure.

L'estensione accetta solo carte. Non prevede altri metodi di pagamento Omise (PromptPay, TrueMoney, mobile banking, rate), né carte salvate o clienti Omise, né abbonamenti, né acquisizione parziale.

Ordini e rimborsi

Stati degli ordini

Nessuno stato (ordine mancante): il cliente è nel 3-D Secure, oppure la carta è stata rifiutata. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

In OpenCart 4, un ordine non pagato del checkout può ricevere lo stato Voided, che OpenCart 4 imposta quando il cliente torna al passaggio Confirm Order. L'estensione tratta questo ordine come un ordine senza stato, e un pagamento successivo lo conferma comunque.

Order Status After Payment (predefinito Processing): il pagamento è stato confermato. Una nota mostra l'importo, l'addebito Omise (chrg_...) e come è stato confermato (checkout, ritorno da 3-D Secure, webhook, nuovo tentativo di pagamento, acquisizione manuale o sincronizzazione manuale).

Authorized Status (predefinito Pending): la carta è stata autorizzata con Authorize only. Usa Capture payment o Void authorization.

Awaiting Payment Status (predefinito Pending): Omise non ha ancora confermato il pagamento. Il webhook o Sync payment status aggiornano l'ordine.

On Hold (Review) Status (predefinito Pending): l'importo o la valuta dell'addebito differiscono dall'ordine, per esempio perché l'ordine è stato modificato durante 3-D Secure. La nota mostra entrambi i valori. Controlla l'ordine ed evadilo oppure rimborsa il pagamento.

Failed Status (predefinito Failed): un pagamento in sospeso è fallito in seguito. Un ordine pagato non viene mai declassato da un successivo evento di errore.

Canceled Status (predefinito Canceled): l'addebito è scaduto o l'autorizzazione è stata annullata.

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

Se per un ordine già nello stato annullato o rimborsato arriva un addebito pagato o autorizzato, l'ordine non viene riaperto. Una nota ti chiede di controllare la dashboard di Omise e di rimborsare o riaprire l'ordine manualmente.

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

Scheda VibeFox Omise Payment

In Sales > Orders apri un ordine pagato con Omise. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Omise Payment mostra l'ID dell'addebito con l'etichetta Test per i pagamenti di prova, l'azione di pagamento, lo stato dell'addebito, il marchio della carta e le ultime cifre, gli importi Charged / order / refunded, i pulsanti, il modulo di rimborso, lo storico dei rimborsi e le Omise notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione. I pulsanti richiedono il permesso di modificare l'estensione (impostato in System > Users > User Groups) e la chiave segreta della modalità in cui è stato effettuato il pagamento. Il risultato di ogni azione viene mostrato nella scheda.

Capture payment: acquisisce l'intero importo autorizzato e imposta l'ordine su Order Status After Payment. Mostrato solo per gli ordini autorizzati.

Void authorization: annulla l'autorizzazione; non viene acquisito denaro e l'ordine viene impostato su Canceled Status. Mostrato solo per gli ordini autorizzati.

Sync payment status: rilegge l'addebito da Omise, per esempio dopo un'acquisizione o un rimborso nella dashboard di Omise, aggiorna l'ordine e aggiunge una nota con lo stato dell'addebito e il totale rimborsato da Omise.

Le modifiche di stato fatte dalla scheda non notificano il cliente e non spostano le scorte, come una modifica manuale dello stato.

Rimborsi

Nella scheda inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e fai clic su Refund via Omise. Conferma la domanda Refund this amount through Omise? This cannot be undone. Sono supportati rimborsi totali e parziali. I rimborsi vengono effettuati nell'importo e nella valuta addebitati da Omise, quindi dopo una discrepanza di importo o valuta puoi rimborsare fino a quanto il cliente ha realmente pagato, non fino al totale dell'ordine. Il rimborso viene inviato nella modalità in cui è stato effettuato il pagamento, quindi la chiave segreta di quella modalità deve essere impostata. Il motivo viene salvato con il rimborso su Omise. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con l'ID del rimborso Omise. Un rimborso totale imposta l'ordine su Refunded Status; un rimborso parziale non cambia lo stato. Per un'autorizzazione non ancora acquisita è possibile solo un rimborso totale, che annulla l'autorizzazione. Se Omise rifiuta il rimborso, la scheda mostra Refund failed. con il messaggio di Omise e non viene registrato alcun rimborso.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Omise. I rimborsi effettuati nella dashboard di Omise non vengono registrati in OpenCart; Sync payment status mostra il totale rimborsato.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox ottenuta da vibefox.net. Il blocco della licenza License — VibeFox Omise Payment è il primo blocco in Extensions > Extensions > Payments > VibeFox Omise Payment > Edit, sopra le impostazioni. Incolla la chiave in License key e fai clic su Activate. Dopo di che 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 si trovano la riga Product: opencart-payment-omise 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 modificare 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, 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 uno slot di dominio nel tuo account, fai clic 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 slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Omise 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 connesso all'amministrazione nello stesso browser continua a vedere il metodo di pagamento nel negozio, contrassegnato da (unlicensed — visible to admins only), così puoi configurare e testare l'estensione prima di acquistare una chiave. 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 verificato 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 a settimana. Non è necessario alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Omise non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che entrambe le chiavi della modalità corrente siano inserite (chiavi di test in modalità test, chiavi live altrimenti) e che il cliente paghi in una delle valute supportate. La pagina delle impostazioni mostra un avviso quando mancano le chiavi. Verifica anche che l'indirizzo di pagamento rientri 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 o nell'Awaiting Payment Status: il webhook non funziona. Nella dashboard di Omise verifica che l'URL del webhook sia esattamente quello mostrato in Webhook URL e che usi HTTPS. Su un ordine esistente fai clic su Sync payment status. Attiva Debug log per vedere le risposte del webhook.

Il webhook risponde Charge ID does not match order o Order not found: l'addebito nell'evento non è stato creato da questo negozio per quell'ordine. Non viene modificato nulla.

Il webhook risponde Order is being processed, retry later o Failed to verify charge: il carrello è stato bloccato da un'altra richiesta nello stesso momento, l'API di Omise non è raggiungibile, oppure manca la chiave segreta della modalità del pagamento. Omise ripete il webhook.

Il webhook risponde The order status could not be set, retry later: non è stato possibile impostare lo stato dell'ordine in quel momento. Omise ripete il webhook. Attiva Debug log per vedere il motivo.

L'URL del webhook mostra Method not allowed nel browser: è normale. L'URL accetta solo richieste da Omise.

Avviso al salvataggio: key must start with ... oppure must be a live key: una chiave è stata incollata nel campo sbagliato e non è stata salvata. Le chiavi di test iniziano con pkey_test_ / skey_test_, quelle live con pkey_ / skey_.

Il cliente vede Card payments are temporarily unavailable: le chiavi non sono corrette, oppure il token della carta appartiene all'altra modalità (un token di test in modalità live o viceversa). Controlla le chiavi e Test mode.

Il cliente vede We could not reach the payment provider: nessuna risposta valida è arrivata da Omise durante la creazione dell'addebito. Un addebito potrebbe comunque essere stato creato; controlla la dashboard di Omise prima che il cliente paghi di nuovo.

Il cliente vede This order is already being paid: il checkout è stato inviato due volte nello stesso momento. Il cliente attende un momento e controlla l'e-mail prima di riprovare.

L'ordine è nello stato di revisione dopo il pagamento: leggi le note nella scheda VibeFox Omise Payment (vedi Order statuses), poi evadi l'ordine o rimborsa il pagamento.

Un rimborso fallisce con un messaggio sulla modalità: il pagamento è stato effettuato in modalità test o live, e la chiave segreta di quella modalità non è impostata. Inseriscila e riprova.

Il rimborso parziale di un ordine autorizzato fallisce: il pagamento è solo autorizzato. Acquisiscilo prima, oppure rimborsa l'importo intero per annullarlo.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox Omise 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 in caso di reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (in OpenCart 4 anche i suoi eventi e la sua azione di avvio, che lascia passare il webhook e il ritorno da 3-D Secure in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità test, chiavi, azione di pagamento, opzioni di webhook e registrazione) e il registro di debug. Se è disattivo, vengono conservate per un'eventuale reinstallazione. Gli addebiti e i rimborsi Omise vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti mantengono le proprie note di pagamento.

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

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