VibeFox ECPay 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.

Valuta: nuovo dollaro taiwanese (TWD). ECPay addebita solo in TWD, quindi il metodo di pagamento viene mostrato solo quando il cliente effettua il checkout in TWD. Aggiungi TWD con il codice TWD in System > Localisation > Currencies se il tuo negozio non lo ha. Gli importi vengono inviati in TWD interi, perché ECPay non accetta decimali: i totali degli ordini vengono arrotondati al dollaro più vicino. Usa 0 decimali per TWD per evitare arrotondamenti.

Account ECPay: per i pagamenti reali ti servono il MerchantID, l'HashKey e l'HashIV del tuo account commerciante ECPay, dal back-office commerciante di ECPay (vendor.ecpay.com.tw). Per i test non serve alcun account ECPay.

Accesso al sito: il tuo negozio deve essere raggiungibile da internet tramite HTTP/HTTPS sulla porta 80/443, in modo che ECPay possa inviare le notifiche di pagamento. Un firewall o l'autenticazione di base davanti al sito le bloccano.

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

Installazione

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

OpenCart 3

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_ecpay_payment_gateway-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 e scegli il tipo Payments. Trova VibeFox ECPay Payment Gateway e clicca su Install (il pulsante verde +). Il tuo utente amministratore deve avere il permesso di modificare l'elenco delle estensioni di pagamento.

3. Clicca su Edit (il pulsante 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 clicca su Activate (vedi Chiave di licenza).

4. Attiva Enable/Disable, scegli i metodi di pagamento e lascia attivo Test Mode per i primi test. Clicca su Save.

5. Per i pagamenti reali inserisci Merchant ID, Hash Key e Hash IV (vedi Configurazione), disattiva Test Mode e clicca su Save.

OpenCart 4

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

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

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

4. Inserisci la chiave di licenza e le impostazioni come nei passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali nelle due versioni. Cambia solo l'URL di notifica (vedi Notifiche di pagamento).

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra un errore quando la valuta predefinita del negozio non è TWD e non esiste una valuta TWD attiva (in tal caso ECPay non viene mostrato al checkout), oppure un avviso quando TWD è solo una seconda valuta (in tal caso ECPay viene mostrato solo ai clienti che pagano in TWD). Mostra un errore quando la modalità live non ha MerchantID, HashKey e HashIV. Finché la modalità test è attiva, avvisa che i pagamenti vanno alla sandbox di ECPay con il commerciante di test pubblico 3002607, che non viene incassato alcun denaro e che chiunque conosca le chiavi pubbliche della sandbox potrebbe confermare ordini di test, quindi la modalità test deve essere disattivata prima di accettare ordini reali. Senza il diritto 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 e Total un numero pari o superiore a 0; altrimenti non viene salvato nulla. Le altre correzioni vengono salvate con un messaggio sopra le impostazioni (vedi i campi seguenti).

ECPay (綠界)

Enable/Disable: Enable ECPay Payment 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 memorizzato nell'ordine. Predefinito: ECPay (綠界). Obbligatorio.

Description: il testo mostrato al cliente nel passaggio Confirm Order. Predefinito: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).

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

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

Account ECPay

Trova il tuo MerchantID, HashKey e HashIV nel back-office commerciante di ECPay (vendor.ecpay.com.tw) alla voce System development management > System integration settings (系統開發管理 > 系統介接設定).

Test Mode: invia i pagamenti alla sandbox di ECPay (payment-stage.ecpay.com.tw) con il commerciante di test pubblico di ECPay 3002607. Nessun denaro reale. Le credenziali sotto vengono usate solo quando la modalità test è disattivata. Predefinito: attivo. Finché è attiva, i clienti vedono TEST MODE — ECPay sandbox, no real money is charged. nel passaggio Confirm Order.

Merchant ID: il tuo Merchant ID ECPay (produzione). Ignorato in modalità test.

Hash Key: il tuo Hash Key ECPay (produzione). Ignorato in modalità test.

Hash IV: il tuo Hash IV ECPay (produzione). Ignorato in modalità test.

Spazi e interruzioni di riga nelle credenziali incollate rompono ogni firma, quindi vengono rimossi al salvataggio e la pagina te lo segnala. Un Hash Key e un Hash IV salvati non vengono più mostrati: il campo resta vuoto e riporta Saved — leave empty to keep it. Inserisci un nuovo valore solo per modificarlo. Per eliminare un valore salvato, spunta Clear the saved value on save sotto il campo e clicca su Save.

Opzioni di pagamento

Enabled Payment Methods: i metodi offerti ai clienti. Con più di uno, il cliente sceglie nel passaggio Confirm Order. Gli ordini ATM, CVS e Barcode restano nello stato di attesa finché il cliente non paga. Deve essere selezionato almeno un metodo; se nessuno è selezionato, viene attivato Credit Card e la pagina te lo segnala. Predefinito: Credit Card.

Default Payment Method: il metodo preselezionato. Deve essere uno dei metodi attivi; altrimenti viene usato il primo metodo attivo. Predefinito: Credit Card.

Order Prefix: il prefisso del numero di transazione ECPay (MerchantTradeNo), fino a 5 lettere o cifre. Gli altri caratteri vengono rimossi al salvataggio, con un messaggio. Utile quando più negozi condividono un account ECPay: assegna a ogni negozio un prefisso proprio. Predefinito: EC.

Notifiche di pagamento

ECPay invia al tuo negozio i risultati dei pagamenti e i dettagli di ATM, CVS e codici a barre. Questa sezione mostra la Notification URL. Per OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_ecpay_payment_gateway/notify, per OpenCart 4 https://your-store/index.php?route=extension/wcp_ecpay_payment_gateway/payment/wcp_ecpay_payment_gateway.notify. L'URL viene inviato con ogni pagamento, quindi non c'è nulla da configurare in ECPay, ma deve essere raggiungibile da internet sulla porta 80/443, senza firewall o autenticazione di base davanti. La modalità manutenzione non la blocca.

Ogni notifica viene verificata tramite la firma CheckMacValue con le chiavi dell'ambiente (test o live) in cui il pagamento è stato avviato, e tramite il MerchantID di quel pagamento. Le notifiche senza una firma valida vengono rifiutate, e ECPay le invia di nuovo. Senza la notifica, l'ordine non riceve alcuno stato; verifica il pagamento nel back-office di ECPay.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dalla notifica firmata di ECPay. Un pagamento con carta non riuscito o abbandonato lascia l'ordine senza stato, e il cliente può pagare di nuovo. Ogni campo qui sotto elenca gli stati ordine del tuo OpenCart.

Payment accepted: lo stato quando ECPay conferma il pagamento con l'importo previsto. Predefinito: Processing.

Awaiting ECPay payment: lo stato quando il cliente ha ricevuto un conto virtuale ATM, un codice di pagamento CVS o i codici a barre e paga più tardi allo sportello o in negozio. Predefinito: Pending.

ECPay payment on hold: lo stato quando ECPay segnala un importo o una valuta diversi, quando arriva un pagamento della sandbox in modalità live, oppure quando il pagamento arriva dopo che lo stato dell'ordine è stato modificato (per esempio annullato). La nota dell'ordine spiega il motivo. Predefinito: Pending, perché OpenCart non ha lo stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Payment error: lo stato quando l'ultimo pagamento ATM, CVS o a codice a barre di un ordine in attesa non è riuscito. Predefinito: Failed.

Avanzate

Enable Logging: scrive numeri d'ordine, numeri di transazione, importi e codici di risposta di ECPay in ecpay_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 ecpay_p_debug.old.log.php. Nessuna chiave o dato del cliente viene registrato. Gli errori vengono sempre registrati, anche quando questo interruttore è disattivato. Predefinito: disattivato.

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

Delete Data on Uninstall: se attivo, disinstallando l'estensione vengono rimosse le sue impostazioni e il registro. I record dei pagamenti ECPay vengono sempre conservati, quindi gli ordini esistenti continuano a funzionare dopo una reinstallazione. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Hash Key e Hash IV non vengono esportati.

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Hash Key e Hash IV salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita ECPay (綠界)). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the ECPay payment page to complete the payment. Con più metodi attivi, il cliente sceglie anche Credit Card, ATM (Virtual Account), CVS (Convenience Store) o Barcode sotto Payment Method. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco del metodo di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina di checkout; la scelta del metodo ECPay viene mostrata sopra quel pulsante.

Quando il cliente clicca su Confirm Order, la pagina mostra Redirecting to ECPay for payment. Please wait... e invia il cliente alla pagina di pagamento di ECPay. Il totale dell'ordine viene inviato in TWD interi, con i nomi e le quantità dei prodotti. La pagina di ECPay si apre in cinese tradizionale per le lingue taiwanese e di Hong Kong, in cinese semplificato, coreano o giapponese per queste lingue, e in inglese per tutte le altre, secondo la lingua del negozio del cliente.

L'ordine viene segnato come pagato solo dopo che ECPay lo conferma con una notifica firmata dal server. Poi riceve il suo stato nel modo standard di OpenCart, con le consuete email d'ordine e l'aggiornamento del magazzino. Quando il cliente clicca sul link per tornare al negozio nella pagina di ECPay e l'ordine ha già uno stato, si apre la pagina di conferma dell'ordine di OpenCart. Mostra Your ECPay payment has been received. per un ordine pagato, Your ECPay payment was received and is being reviewed by the store. per un ordine in sospeso e le istruzioni di pagamento per un ordine ATM, CVS o Barcode in attesa. Se la notifica non è ancora arrivata, una pagina Payment confirmation mostra We have not received a payment confirmation from ECPay for this order yet. Your order will be confirmed as soon as ECPay confirms the payment. con i pulsanti Check again e Back to checkout. Se ECPay ha segnalato che il pagamento non è riuscito, il cliente torna al checkout con The payment was not completed. You can try again or choose another payment method. Il carrello viene conservato. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout.

Per ATM, CVS e Barcode il cliente riceve prima i dati di pagamento. L'ordine riceve lo stato Awaiting ECPay payment, e il codice banca e il conto virtuale, il codice di pagamento del convenience store o i codici a barre, l'importo e la data Pay before vengono mostrati sotto ECPay payment instructions nella pagina di conferma dell'ordine e, per un cliente con accesso, nei dati dell'ordine del suo account. Quando il cliente paga, ECPay invia un'altra notifica e l'ordine viene segnato come pagato. Le istruzioni di pagamento non vengono aggiunte alle email di OpenCart.

Ogni tentativo crea un nuovo numero di transazione ECPay, perché ECPay rifiuta i numeri riutilizzati. Quindi i nuovi tentativi dopo un pagamento non riuscito funzionano, e se il cliente torna indietro nel browser e clicca di nuovo su Confirm Order, viene avviato un nuovo tentativo. Un carrello può avere fino a 30 tentativi di pagamento. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna, quindi un nuovo tentativo paga lo stesso ordine con un nuovo numero di transazione. Quando un altro ordine dello stesso carrello è già pagato o è in attesa del pagamento ATM o CVS, il cliente va alla pagina di conferma e non viene avviato alcun nuovo pagamento.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio il pagamento ATM o CVS è fallito, oppure lo hai annullato), il cliente torna al checkout con Your previous order was cancelled or its payment failed. Please confirm the order again., e il successivo Confirm Order paga un nuovo ordine del carrello. Se l'ordine è già pagato (o in attesa del pagamento ATM o in negozio) ma il carrello è cambiato da allora, anche con una nuova quantità, il messaggio è Your previous order is already paid (or awaits its ATM / convenience store payment). Please confirm the order again: the cart will be paid with a new order. Un ordine pagato non viene mai mostrato come pagato per un carrello diverso.

Se il pagamento non può essere avviato, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio The order total is too small for ECPay. quando il totale è inferiore a 1 TWD dopo l'arrotondamento. I limiti di importo propri di ECPay per ogni metodo vengono verificati nella pagina di ECPay, non al checkout.

Le notifiche dei pagamenti già avviati vengono accettate anche se disattivi il metodo di pagamento, e il cliente continua a vedere le istruzioni di pagamento degli ordini già effettuati.

L'estensione accetta solo pagamenti unici nella pagina di ECPay. Non prevede rimborsi da OpenCart, carte salvate, abbonamenti o pagamenti ricorrenti (定期定額), rate, Apple Pay, fatture elettroniche o logistica, né una verifica dello stato lato server: se il tuo negozio non riesce a ricevere la notifica, verifica il pagamento nel back-office di ECPay.

Ordini

Stati ordine

No status (missing order): il cliente è stato inviato a ECPay e non ha pagato, il pagamento con carta non è riuscito o la notifica non è ancora arrivata. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Awaiting ECPay payment (default Pending): il cliente ha scelto ATM, CVS o Barcode e ha ricevuto i dati di pagamento. La nota mostra il codice banca e il conto virtuale, il codice di pagamento o i codici a barre e la scadenza.

Payment accepted (default Processing): il pagamento è stato confermato. Una nota mostra il TradeNo di ECPay, il tipo di pagamento, l'importo e il numero di transazione (con un contrassegno di modalità test per i pagamenti della sandbox).

ECPay payment on hold (default Pending): ECPay ha segnalato un importo o una valuta diversi da quelli dell'ordine (per esempio, il carrello è stato modificato in un'altra scheda dopo l'avvio del pagamento), un pagamento della sandbox è arrivato dopo il passaggio alla modalità live (non è stato incassato denaro reale), oppure il pagamento è arrivato dopo che avevi modificato lo stato dell'ordine, per esempio annullandolo. La nota lo spiega. Confronta con il back-office di ECPay, poi evadi l'ordine o rimborsa il pagamento lì.

Payment error (default Failed): ECPay ha segnalato che l'ultimo pagamento ATM, CVS o a codice a barre di un ordine in attesa non è riuscito. La nota mostra il codice di risposta e il messaggio di ECPay.

Le notifiche ripetute vengono ignorate. Un ordine pagato non viene mai riaperto da un fallimento tardivo. Un secondo pagamento per un ordine già pagato, per esempio da due schede del browser, viene registrato una sola volta come nota, così puoi rimborsarlo nel back-office di ECPay. I pagamenti simulati avviati dal back-office di ECPay vengono solo annotati e non segnano mai un ordine come pagato, perché ECPay non incassa denaro per questi.

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

Scheda VibeFox ECPay Payment Gateway

In Sales > Orders apri un ordine pagato con ECPay. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox ECPay Payment Gateway elenca ogni tentativo di pagamento dell'ordine: il MerchantTradeNo con l'etichetta Test mode per i tentativi della sandbox, il metodo, l'importo in TWD, lo stato, il TradeNo di ECPay, il tipo e la data del pagamento, il codice di risposta di ECPay e la data di avvio. Sotto ci sono le ECPay notes dell'ordine. Per un ordine nello stato di attesa, la scheda ti ricorda di confrontarlo con il back-office di ECPay. La scheda è di sola lettura e viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

I rimborsi da OpenCart non sono disponibili. Rimborsa il pagamento nel back-office di ECPay, poi aggiorna manualmente lo stato dell'ordine in OpenCart. I resi di prodotti in Sales > Returns non restituiscono denaro tramite ECPay.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox ECPay Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto ci sono la riga Product: opencart-payment-ecpay 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 o 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, clicca su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

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

Senza una chiave attiva, ECPay 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 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 l'accesso all'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 continuano a essere confermati.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente quando apri la Dashboard 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 serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

ECPay non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che il cliente effettui il checkout in TWD e che, in modalità live, Merchant ID, Hash Key e Hash IV siano impostati. La pagina delle impostazioni mostra un messaggio per la valuta e le credenziali live. Verifica anche che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: la notifica di ECPay non è arrivata al tuo negozio (sito non raggiungibile, firewall, autenticazione di base). ECPay riprova più volte. Puoi anche verificare la transazione nel back-office di ECPay. Attiva Enable Logging per vedere le notifiche ricevute dall'estensione; le notifiche rifiutate vengono comunque registrate come errori.

La notifica risponde 0|CheckMacValue verification failed: l'Hash Key o l'Hash IV non corrispondono al tuo account ECPay, oppure il pagamento è stato avviato nell'altro ambiente. Copiali di nuovo dal back-office di ECPay.

La notifica risponde 0|MerchantID mismatch: la notifica appartiene a un commerciante ECPay diverso da quello con cui è stato avviato il pagamento.

La notifica risponde 0|Order not found: il numero di transazione non è stato emesso da questo negozio, per esempio quando più negozi condividono un account ECPay. Assegna a ogni negozio un proprio Order Prefix.

La notifica risponde 0|Retry: l'ordine era in elaborazione da un'altra notifica nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. ECPay invia di nuovo la notifica. Attiva Enable Logging per vedere il motivo.

L'URL di notifica mostra 0|Method not allowed in the browser: è normale. L'URL accetta solo richieste provenienti da ECPay.

Il cliente vede This payment method is not available. Please reload the checkout page.: la sessione di checkout non corrisponde più all'ordine, oppure nel frattempo il metodo di pagamento è stato disattivato. Il cliente ricarica il checkout.

Il cliente vede The order total is too small for ECPay.: il totale dell'ordine è inferiore a 1 TWD dopo l'arrotondamento e non può essere pagato con ECPay.

Il cliente vede Too many payment attempts for this order: il carrello ha raggiunto 30 tentativi di pagamento. Chiedi al cliente di iniziare un nuovo carrello.

L'ordine è nello stato on hold: leggi le note nella scheda VibeFox ECPay Payment Gateway (vedi Stati ordine), confrontale con il back-office di ECPay, poi evadi l'ordine o rimborsa il pagamento lì.

Per gli sviluppatori: prima che il modulo di pagamento venga inviato a ECPay, l'estensione attiva l'evento OpenCart ecpay_p_request_params con i parametri e l'ordine; il commerciante, il numero di transazione e l'importo non possono essere modificati tramite esso.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox ECPay Payment Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable/Disable, Sort Order, Geo Zone, Total e gli stati ordine della sezione Orders, che tornano ai valori predefiniti in caso di reinstallazione. Anche gli eventi OpenCart dell'estensione vengono rimossi (su OpenCart 4 anche la sua azione di avvio, che lascia passare la notifica in modalità manutenzione). Se Delete Data on Uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità test, credenziali, opzioni di pagamento, registrazione) e il registro. Se è disattivato, vengono conservate per una successiva reinstallazione. I record dei pagamenti ECPay vengono sempre conservati, quindi le notifiche tardive di vecchi pagamenti vengono comunque verificate dopo una reinstallazione. Gli ordini esistenti mantengono le proprie note di pagamento.

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

ECPay è un marchio registrato del rispettivo titolare. Questa estensione non è affiliata né approvata da ECPay.