VibeFox HyperPay 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 con l'estensione OpenSSL (decifra i webhook).

Account HyperPay: HyperPay rilascia l'Access Token e l'Entity ID quando viene configurato il tuo account commerciante. Le credenziali di test e quelle live sono diverse. Ti serve anche un webhook di pagamento nella dashboard di HyperPay e la sua chiave di decifratura (webhook key), mostrata in Administration > Webhooks (vedi Configurazione).

Dati della carta: la carta viene inserita solo nel widget di HyperPay, quindi i dati della carta non passano mai dal tuo server (PCI DSS SAQ A).

Chiave di licenza VibeFox: si acquista 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_hyperpay_payment_gateway-oc3-(versione).ocmod.zip e il pacchetto per OpenCart 4 wcp_hyperpay_payment_gateway.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, clicca su Upload e scegli il file wcp_hyperpay_payment_gateway-oc3-(versione).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'installer puoi anche 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 HyperPay 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. Inserisci l'Access Token di test, l'Entity ID e la chiave del webhook rilasciati da HyperPay e lascia attivo Test Mode.

5. Nella dashboard di HyperPay (Administration > Webhooks) aggiungi un webhook di pagamento con l'URL mostrato nella sezione Webhook e copia la sua chiave di decifratura nel campo della chiave del webhook della stessa modalità.

6. Attiva Enable/Disable, clicca su Save ed effettua un pagamento di prova con una carta di test di HyperPay. Poi inserisci le credenziali live e disattiva Test Mode.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_hyperpay_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 ad esso.

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

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

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox HyperPay 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 Test mode is on: payments go to the HyperPay test system and no real money is charged. finché la modalità test è attiva. Ti avvisa quando l'Access Token o l'Entity ID della modalità corrente manca (in questo caso il metodo di pagamento non viene mostrato al checkout) e quando la modalità corrente non ha una chiave del webhook valida (in questo caso i pagamenti vengono confermati solo quando il cliente torna nel negozio). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto e non deve superare 128 caratteri, Transaction Type deve essere valido, Sort Order deve essere un numero intero, Total deve essere un numero pari o superiore a 0, e la zona geografica e gli stati dell'ordine devono esistere; altrimenti non viene salvato nulla. Gli spazi vengono rimossi dalle credenziali. Le impostazioni vengono salvate con un avviso se una chiave del webhook non è una chiave esadecimale di 64 caratteri o se non è selezionato alcun marchio di pagamento.

HyperPay

Enable/Disable: Enable HyperPay Payment attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il titolo che il cliente vede durante il checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Credit/Debit Card (HyperPay). Obbligatorio.

Description: il testo che il cliente vede al passaggio Confirm Order, sopra il pulsante di conferma, sotto un'icona della carta. Predefinito: Pay securely using your credit or debit card.

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

Geo Zone: offri HyperPay solo per gli indirizzi di pagamento della 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 HyperPay. Lascia il campo vuoto per offrire HyperPay con qualsiasi importo.

Credenziali API

L'Access Token, l'Entity ID e la chiave del webhook vengono rilasciati da HyperPay quando viene configurato il tuo account commerciante. Le credenziali di test e quelle live sono diverse. La chiave del webhook è mostrata nella dashboard di HyperPay in Administration > Webhooks. La sezione contiene link al sito di HyperPay e alla documentazione per sviluppatori.

Test Mode: usa il sistema di test di HyperPay (eu-test.oppwa.com) e le credenziali di test. Non viene addebitato denaro reale. Disattivalo per accettare pagamenti reali con le credenziali live (eu-prod.oppwa.com). Predefinito: attivo. Quando è attivo, i clienti vedono Test mode: no real payment will be made. al passaggio Confirm Order.

Test Access Token: il bearer token del tuo account di test di HyperPay.

Test Entity ID: l'Entity ID del canale di pagamento di test.

Test Webhook Key: la chiave esadecimale di 64 caratteri usata per decifrare le notifiche webhook del sistema di test.

Live Access Token: il bearer token del tuo account live di HyperPay.

Live Entity ID: l'Entity ID del canale di pagamento live.

Live Webhook Key: la chiave esadecimale di 64 caratteri usata per decifrare le notifiche webhook del sistema live.

Gli Access Token e le chiavi del webhook 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.

Webhook

Il webhook comunica al tuo negozio i pagamenti anche quando il cliente chiude il browser prima di tornare nel negozio. Nella dashboard di HyperPay (Administration > Webhooks) aggiungi un webhook per i pagamenti con l'URL mostrato in Webhook URL in questa sezione. In OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_hyperpay_payment_gateway/webhook, in OpenCart 4: https://your-store/index.php?route=extension/wcp_hyperpay_payment_gateway/payment/wcp_hyperpay_payment_gateway.webhook. È costruito a partire dall'indirizzo del negozio della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Poi copia la chiave di decifratura del webhook in Test Webhook Key o Live Webhook Key, per la stessa modalità.

I webhook di HyperPay sono cifrati (AES-256-GCM). Un webhook che non può essere decifrato con le tue chiavi viene rifiutato. Vengono elaborate solo le notifiche di pagamento, e il pagamento deve appartenere al checkout di uno dei tuoi ordini, creato nella stessa modalità della chiave che lo ha decifrato. Le notifiche di test di HyperPay vengono confermate. Il webhook segnala anche acquisizioni, storni, rimborsi e contestazioni effettuati nella dashboard di HyperPay (vedi Ordini e rimborsi). Senza il webhook, un pagamento viene confermato solo quando il cliente torna nel negozio dopo aver pagato. Il webhook funziona anche quando il negozio è in modalità manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, e in OpenCart 4 l'estensione aggiunge un'azione di avvio che lascia passare il webhook e il ritorno del cliente da HyperPay.

Payment

Transaction Type: come viene addebitata la carta.

Payment Brands: i marchi mostrati nel widget di pagamento: VISA, Mastercard, mada, American Express, STC Pay, Apple Pay. Predefinito: VISA e Mastercard. Se non è selezionato alcun marchio, la pagina ti avvisa e il widget mostra VISA e Mastercard. Seleziona solo i marchi che HyperPay ha attivato per il tuo Entity ID; mada, STC Pay e Apple Pay spesso usano una propria entità, che questa estensione non supporta.

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che HyperPay ha confermato il pagamento. Un pagamento rifiutato o abbandonato lascia l'ordine senza stato e il carrello viene conservato. Ciascun campo qui sotto elenca i tuoi stati ordine di OpenCart. OpenCart non ha lo stato «On hold», quindi tre di essi hanno Pending come predefinito; puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui.

Order Status After Payment: impostato quando HyperPay conferma un addebito con l'importo e la valuta corretti, oppure quando una pre-autorizzazione viene acquisita. Predefinito: In lavorazione.

Authorized (Capture Required) Status: una pre-autorizzazione ha riservato l'importo; acquisiscilo nella scheda dell'ordine. Uno storno nella dashboard di HyperPay annulla l'ordine finché ha questo stato. Predefinito: In sospeso.

Awaiting Payment Status: HyperPay ha segnalato un pagamento in attesa di conferma; il webhook lo confermerà più tardi. Predefinito: In sospeso.

On Hold (Review) Status: l'importo o la valuta pagati non corrispondono all'ordine, oppure un pagamento è arrivato dopo che l'ordine era stato annullato. Una nota spiega il motivo. Predefinito: In sospeso.

Canceled Status: impostato quando la pre-autorizzazione viene stornata in HyperPay. Un pagamento per un ordine in questo stato lo mette in attesa invece di riaprirlo. Predefinito: Annullato.

Refunded Status: un pagamento ricevuto per un ordine in questo stato viene solo annotato; l'ordine non cambia. Predefinito: Rimborsato.

Avanzate

Enable Logging: registra richieste e risposte API in hyperpay_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 hyperpay_p_debug.old.log.php. Errori e avvisi vengono sempre registrati. I log non contengono dati della carta, chiavi 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, disinstallando l'estensione vengono rimosse le impostazioni e i file di log. Ordini e tentativi di pagamento HyperPay vengono sempre conservati, perché i webhook in ritardo e le acquisizioni degli ordini esistenti ne hanno bisogno. Predefinito: disattivato.

Import / Export

Export: Download JSON salva le impostazioni in un file JSON. Gli Access Token e le chiavi del webhook non vengono esportati.

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Gli Access Token e le chiavi del webhook salvati vengono conservati.

Checkout

Al passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit/Debit Card (HyperPay)). Al passaggio Confirm Order il cliente vede la tua descrizione. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione prepara un checkout HyperPay per il totale dell'ordine nella valuta dell'ordine e apre la pagina HyperPay payment del tuo negozio con il widget HyperPay e Please complete your payment below:. Il widget usa la lingua del cliente quando HyperPay la supporta. In modalità test la pagina mostra Test mode: use a HyperPay test card, no real payment will be made. Il cliente inserisce i dati della carta nel widget, oppure segue Choose another payment method per tornare al checkout. Ricaricando la pagina viene riutilizzato lo stesso checkout per un massimo di 25 minuti, finché il totale dell'ordine non cambia; dopo, ne viene preparato uno nuovo.

In 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 del checkout. Per impostazione predefinita OpenCart 4 non chiede un indirizzo di fatturazione; l'estensione invia quindi a HyperPay l'indirizzo di spedizione come indirizzo di fatturazione.

Dopo il pagamento, il cliente torna nel tuo negozio. L'estensione verifica che il pagamento appartenga a uno dei checkout di questo ordine e chiede a HyperPay il risultato con una richiesta server-to-server, nella modalità in cui il checkout è stato creato. L'ordine viene segnato come pagato solo dopo la conferma di HyperPay: con quella richiesta o con il webhook. Importo e valuta devono corrispondere all'ordine. Un ritorno e un webhook arrivati nello stesso momento, così come i risultati di due ordini dello stesso carrello, vengono gestiti uno dopo l'altro, in modo che il pagamento non venga mai applicato due volte. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con le consuete email d'ordine e l'aggiornamento del magazzino, e il cliente vede la pagina di successo dell'ordine di OpenCart.

Se il pagamento non è andato a buon fine, il cliente torna al checkout con un messaggio: Payment failed: e il motivo fornito da HyperPay, Payment was not completed. Please try again., oppure We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. Il carrello viene conservato e il cliente può pagare di nuovo. Se il modulo di pagamento non può essere preparato, il cliente resta al passaggio Confirm Order con un breve messaggio, per esempio che il fornitore di pagamenti non ha accettato alcuni dati di fatturazione, oppure che il modulo di pagamento non è disponibile per un errore di configurazione del pagamento. Il motivo tecnico viene scritto nel log.

In OpenCart 4 questi messaggi vengono mostrati sopra la pagina del checkout. 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 pagamento rifiutato il cliente paga lo stesso ordine con un nuovo tentativo di pagamento. Se lo stesso carrello è già stato pagato con un altro ordine, il cliente va alla pagina di successo invece di pagare di nuovo. Una modifica del carrello, inclusa una nuova quantità, conta come un nuovo carrello che richiede il proprio pagamento.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se quell'ordine è stato chiuso nel frattempo senza pagamento (per esempio l'hai annullato), il cliente torna al checkout con Payment failed. Please try again or use another card. Se è stato pagato e poi annullato o rimborsato, il messaggio è Your previous order was closed by the store. Please confirm the order again to pay with a new order. Se è già pagato e il carrello contiene ora un nuovo acquisto, il messaggio è Your previous order #(numero) has already been placed. Your cart has changed: please confirm the new order to pay for it. In ogni caso, il successivo Confirm Order paga un nuovo ordine del carrello. Un ordine pagato non viene mai mostrato come pagato per un carrello diverso.

Gli importi vengono inviati con due decimali, come richiede l'API di HyperPay. Nelle valute a 3 decimali (KWD, BHD, JOD, OMR) il totale dell'ordine viene arrotondato a due decimali.

L'estensione non prevede rimborsi o storni da OpenCart, né carte salvate o tokenizzazione, né abbonamenti, né verifica del dominio per Apple Pay, né un'entità separata per marchio, né Tabby, Tamara o altri metodi buy-now-pay-later.

Ordini e rimborsi

Stati dell'ordine

No status (missing order): il cliente è stato inviato alla pagina di pagamento e non ha pagato, il pagamento è stato rifiutato, oppure HyperPay 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): un addebito è stato confermato, oppure una pre-autorizzazione è stata acquisita. Una nota mostra il codice risultato di HyperPay, la descrizione e l'ID del pagamento. Se HyperPay ha segnalato il pagamento per una verifica manuale, la nota lo indica; controllalo nella dashboard di HyperPay prima della spedizione.

Authorized (Capture Required) Status (default Pending): l'importo è stato riservato da una pre-autorizzazione. Acquisiscilo nella scheda dell'ordine o nella dashboard di HyperPay; il webhook di acquisizione porta poi l'ordine a Order Status After Payment.

Awaiting Payment Status (default Pending): HyperPay ha segnalato il pagamento come in attesa. L'ordine passa a Order Status After Payment quando HyperPay lo conferma.

On Hold (Review) Status (default Pending): HyperPay ha segnalato un importo o una valuta diversi da quelli dell'ordine (per esempio, il carrello è stato modificato dopo l'apertura della pagina di pagamento), oppure il pagamento è arrivato dopo che l'ordine era stato annullato. La nota lo spiega. Controlla il pagamento nella dashboard di HyperPay, poi evadi l'ordine o rimborsa il pagamento.

Canceled Status (default Canceled): una pre-autorizzazione è stata stornata nella dashboard di HyperPay, e il webhook di storno annulla l'ordine autorizzato.

Un risultato di rifiuto non modifica mai un ordine che ha già uno stato. Se arriva un altro pagamento riuscito per un ordine già pagato, oppure se viene pagato un altro ordine di un carrello già pagato, l'ordine pagato non cambia. Una nota ti chiede di rimborsare il duplicato nella dashboard di HyperPay. Un pagamento riuscito per un ordine nello Refunded Status aggiunge solo una nota.

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

Scheda VibeFox HyperPay Payment Gateway

In Sales > Orders apri un ordine pagato con HyperPay. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox HyperPay Payment Gateway mostra l'ID del pagamento (e l'ID dell'acquisizione dopo un'acquisizione) con l'etichetta Test mode per i pagamenti di prova, il tipo di transazione, l'ID del checkout, l'ID della transazione del commerciante, l'importo inviato a HyperPay, il risultato e le HyperPay notes dell'ordine. La scheda è mostrata agli utenti che hanno accesso all'estensione.

Acquisizione

Per un ordine pre-autorizzato che non è ancora stato acquisito, la scheda mostra Capture payment con l'importo. Clicca e conferma Capture the pre-authorized amount through HyperPay?. Viene acquisito il totale attuale dell'ordine, nella modalità in cui è stata fatta la pre-autorizzazione, quindi devono essere impostati l'Access Token e l'Entity ID di quella modalità. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Dopo un'acquisizione riuscita, l'ordine riceve Order Status After Payment e l'ID dell'acquisizione viene aggiunto alla scheda e alle note. Lo stato viene scritto direttamente, senza email d'ordine né aggiornamento del magazzino. Se HyperPay rifiuta l'acquisizione, vengono mostrati e aggiunti alle note il codice risultato e la descrizione, e l'ordine resta autorizzato. Un doppio clic non acquisisce due volte. Lo storno (void) di una pre-autorizzazione si fa nella dashboard di HyperPay.

Rimborsi

I rimborsi da OpenCart non sono supportati. I resi di prodotti in Sales > Returns non rimandano denaro tramite HyperPay. Rimborsa il pagamento nella dashboard di HyperPay. I rimborsi e le contestazioni effettuati in HyperPay vengono aggiunti all'ordine come nota dal webhook; lo stato dell'ordine non cambia. Aggiornalo manualmente se necessario.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox HyperPay Payment Gateway è il primo blocco in Extensions > Extensions > Payments > VibeFox HyperPay Payment Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca 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 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-hyperpay e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached oppure License expired on seguito da una data. Dopo che l'indirizzo del negozio cambia, 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 solo dominio: l'indirizzo del negozio della 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, HyperPay 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 al pannello nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso dell'amministratore, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati, e acquisizioni e rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene ricontrollato automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: una volta al giorno nei primi 14 giorni dopo l'inserimento della chiave, poi una volta 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

HyperPay non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità corrente abbia il suo Access Token e il suo Entity ID: quelli di test in modalità test, quelli live in modalità live. La pagina delle impostazioni mostra un avviso se mancano. Controlla anche che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: il webhook non funziona e il cliente non è tornato nel negozio. Nella dashboard di HyperPay verifica che il webhook di pagamento esista per la modalità che usi, che il suo URL sia esattamente quello mostrato in Webhook URL e che la sua chiave di decifratura sia nel campo della chiave del webhook della stessa modalità. Attiva Enable Logging e controlla il campo Log nella pagina dell'estensione.

Il webhook risponde Decryption failed: la chiave del webhook appartiene a un altro webhook o a un'altra modalità. Copia di nuovo la chiave dalla dashboard di HyperPay.

Il webhook risponde Webhook key not configured: non è impostata alcuna chiave del webhook valida. Incolla la chiave di 64 caratteri nelle impostazioni. HyperPay riproverà il webhook.

Il webhook risponde Busy, retry later: l'ordine era in elaborazione con un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. HyperPay riproverà il webhook. Il motivo è nel log.

Il log mostra Webhook ignored: il pagamento non appartiene a un ordine di questo negozio, oppure è stato effettuato nell'altra modalità. I pagamenti di test e quelli live restano separati.

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

Il modulo di pagamento non si carica: controlla il log. Un errore di configurazione indica di solito un Access Token o un Entity ID errato per la modalità corrente. Un messaggio sui dati di fatturazione significa che HyperPay non ha accettato alcuni dati del cliente. Assicurati che i Payment Brands selezionati siano attivi per il tuo Entity ID.

Il cliente vede The payment session was not found. Please confirm the order again.: il link alla pagina di pagamento non è più valido per questo ordine. Il cliente conferma di nuovo l'ordine al checkout.

Order is in the on hold status: leggi le note nella scheda dell'ordine (vedi Stati dell'ordine), controlla il pagamento nella dashboard di HyperPay, poi evadi l'ordine o rimborsa il pagamento.

L'acquisizione non riesce: leggi il codice risultato e la descrizione nella scheda e nelle note. L'acquisizione viene inviata nella modalità della pre-autorizzazione, quindi le credenziali di quella modalità devono essere impostate; altrimenti la scheda indica che Access Token / Entity ID di quella modalità sono vuoti.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox HyperPay 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 degli ordini della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Su OpenCart 4 vengono rimossi anche i suoi eventi e la sua azione di avvio, che lascia passare il webhook e il ritorno del cliente in modalità manutenzione. Se Delete Data on Uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità test, credenziali, chiavi del webhook, tipo di transazione, marchi, log) e i file di log. Se è disattivo, vengono conservate per una reinstallazione successiva. I tentativi di pagamento HyperPay vengono sempre conservati, quindi i webhook in ritardo e le acquisizioni degli ordini esistenti continuano a funzionare dopo una reinstallazione. Gli ordini esistenti conservano le loro note di pagamento.

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

HyperPay è un marchio del suo rispettivo titolare. Questa estensione non è affiliata né approvata da HyperPay.