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

Account Worldline: un account commerciante Worldline Direct (in precedenza Ingenico Direct). Gli account di test e quello reale sono separati e hanno credenziali diverse. Per ciascun account servono il Merchant ID (il tuo PSPID), un API Key ID con la relativa Secret API Key e una chiave webhook con il relativo segreto. Tutti si creano nel Worldline Merchant Portal (vedi Configurazione).

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_worldline_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_worldline_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. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_worldline_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. 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 scegli il tipo Payments. Trova VibeFox Worldline 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. Inserisci 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 le credenziali di test, clicca su Save e poi su Test credentials.

5. Aggiungi l'URL del webhook nel Merchant Portal dell'account di test e inserisci la chiave e il segreto del webhook (vedi Configurazione).

6. Attiva Enable/Disable, salva e prova un pagamento di test. Poi inserisci le credenziali reali, ripeti la configurazione del webhook nel tuo account reale, clicca su Live credentials e disattiva Test Mode.

OpenCart 4

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

4. Inserisci la chiave di licenza, le credenziali 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à di test attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Worldline Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina ti avvisa quando le credenziali della modalità corrente (Merchant ID, API Key ID, Secret API Key) sono incomplete, perché il metodo di pagamento resta nascosto al checkout. Finché la modalità di test è attiva mostra Test mode is on (pre-production environment): no real money is charged. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto (massimo 128 caratteri), Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total deve essere un numero pari o maggiore di 0, e la zona geografica e gli stati ordine devono esistere. Altrimenti non viene salvato nulla e la pagina indica il campo. Credenziali incomplete non impediscono il salvataggio.

Worldline (Ingenico)

Enable/Disable: Enable Worldline Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivo.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Worldline. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely via Worldline.

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

Geo Zone: offri Worldline solo per gli indirizzi di pagamento nella zona geografica selezionata. Predefinito: All zones. Le zone geografiche si impostano in System > Localisation > Geo Zones.

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

API Worldline Direct

Ottieni le credenziali nel Worldline Merchant Portal dell'account di test e in quello reale. Il tuo PSPID è il Merchant ID. Developer > Payment API crea l'API Key ID e la Secret API Key; Developer > Webhooks crea la chiave e il segreto del webhook. La sezione contiene i collegamenti a entrambi i portali e alla documentazione Worldline.

Test Mode: cambia sia l'endpoint dell'API sia le credenziali. La modalità di test usa l'ambiente di pre-produzione e le credenziali di test, la modalità reale l'ambiente di produzione e le credenziali reali. Predefinito: attivo. Disattivala per incassare pagamenti reali. Finché la modalità di test è attiva, i clienti vedono Test mode — no real money is charged. nel passaggio Confirm Order.

Account di test (pre-produzione)

Test Merchant ID (PSPID): il PSPID del tuo account di test.

Test API Key ID: l'API Key ID creato in Developer > Payment API dell'account di test.

Test Secret API Key: la Secret API Key associata a quell'API Key ID.

Test Webhook Key ID: facoltativo. Se impostato, vengono accettati solo i webhook inviati con questa chiave.

Test Webhook Secret: il segreto del webhook dell'account di test. Serve a verificare la firma di ogni webhook.

Account reale (produzione)

Live Merchant ID (PSPID): il PSPID del tuo account reale.

Live API Key ID: l'API Key ID creato in Developer > Payment API dell'account reale.

Live Secret API Key: la Secret API Key associata a quell'API Key ID.

Live Webhook Key ID: facoltativo. Se impostato, vengono accettati solo i webhook inviati con questa chiave.

Live Webhook Secret: il segreto del webhook dell'account reale.

Le chiavi segrete e i segreti dei webhook salvati non vengono più mostrati. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo per cambiarlo. Per rimuovere un valore salvato, spunta Clear the saved value sotto il campo e clicca su Save.

Verifica credenziali: i pulsanti Test credentials e Live credentials verificano le credenziali salvate di ciascun account con una chiamata di prova a Worldline. Salva prima le modifiche. La risposta compare sotto i pulsanti, per esempio Test credentials: connection successful., API credentials are not configured. oppure l'errore restituito da Worldline.

Webhook

Il webhook informa il tuo negozio dei pagamenti anche quando il cliente non torna nel negozio, per esempio dopo aver chiuso il browser o quando un pagamento viene confermato più tardi. Nel Merchant Portal apri Developer > Webhooks dell'account di test e aggiungi l'URL mostrato in Endpoint URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_worldline_gateway/webhook, su OpenCart 4 questo: https://your-store/index.php?route=extension/wcp_worldline_gateway/payment/wcp_worldline_gateway.webhook. È costruito a partire dall'indirizzo del negozio della tua installazione OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni: deve rispondere senza redirect ed essere raggiungibile da internet. Inserisci poi l'ID e il segreto della chiave webhook in Test Webhook Key ID e Test Webhook Secret. Ripeti la stessa operazione nell'account reale con i campi reali.

L'estensione risponde automaticamente alla richiesta di verifica dell'endpoint di Worldline. Gestisce gli eventi di pagamento (cambi di stato dei pagamenti) e gli eventi di rimborso (cambi di stato dei rimborsi). Gli altri eventi vengono accettati e ignorati. I webhook senza una firma valida vengono rifiutati. Un evento deve essere firmato con il segreto dell'account in cui è stato effettuato il pagamento, quindi un webhook di test non conferma mai un pagamento reale. Un webhook viene anche ignorato se proviene da un Merchant ID diverso da quello dell'account il cui segreto lo ha firmato. Senza il webhook, un ordine viene confermato solo quando il cliente torna nel negozio dopo aver pagato.

Pagina di pagamento e ordini

Payment page template: nome facoltativo di un modello di checkout ospitato (variante) caricato nel Merchant Portal, per esempio SimplifiedCustomPaymentPage. Lascialo vuoto per la pagina predefinita di Worldline.

Order Status After Payment: quale stato assegna un pagamento catturato. I pagamenti vengono sempre richiesti come vendita diretta (autorizzazione e cattura).

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Worldline ha confermato il pagamento. Ogni campo seguente elenca i tuoi stati ordine OpenCart.

Paid Order Status: lo stato dopo un pagamento catturato con Payment accepted (processing). Predefinito: Processing.

Complete Order Status: lo stato dopo un pagamento catturato con Delivered (completed). Predefinito: Complete.

Awaiting Capture Status: il pagamento è autorizzato o la cattura è stata richiesta; il webhook di cattura segna l'ordine come pagato. Predefinito: Pending.

On Hold (Review) Status: l'importo o la valuta pagati non corrispondono all'ordine. Una nota spiega il motivo. Predefinito: Pending, perché OpenCart non ha lo stato On hold. Puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui.

Payment Error Status: Worldline ha rifiutato o annullato il pagamento di un ordine in attesa di cattura. Predefinito: Failed.

Refunded Status: il pagamento è stato rimborsato interamente dalla pagina dell'ordine. Predefinito: Refunded.

Avanzate

Logging: scrive tutte le richieste API e i webhook in wlg_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 wlg_debug.old.log.php. Errori e avvisi vengono sempre registrati, anche quando questa opzione è disattivata. Chiavi, dati della carta e dati personali vengono mascherati. Predefinito: disattivo.

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

Delete Data: se attivo, disinstallando l'estensione vengono rimosse le impostazioni del gateway e il registro. Le transazioni e i rimborsi di Worldline restano sempre, perché gli ordini esistenti ne hanno bisogno per i rimborsi. Predefinito: disattivo.

Import / Export

Export: Download JSON salva le impostazioni in un file JSON. Chiavi segrete e segreti dei webhook non vengono esportati.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. I segreti salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Worldline). Nel 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 crea un checkout ospitato Worldline per il totale dell'ordine nella valuta dell'ordine e invia il cliente alla pagina di pagamento di Worldline. Lì il cliente paga con una carta, un wallet o un altro metodo di pagamento attivato nel tuo account Worldline. Nome di fatturazione, indirizzo, e-mail e telefono vengono passati a Worldline, e la pagina di pagamento si apre nella lingua del cliente quando Worldline la supporta. Ogni tentativo di pagamento riceve un proprio riferimento composto dal numero dell'ordine e da una parte casuale. 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 del checkout.

Dopo il pagamento, il cliente torna nel tuo negozio. L'estensione verifica il ritorno rispetto al tentativo salvato e legge lo stato del pagamento da Worldline lato server. L'ordine viene segnato come pagato solo dopo che Worldline lo conferma: con questa verifica di stato o con un webhook firmato. L'ordine riceve poi 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 successo dell'ordine di OpenCart con Your payment with Worldline has been received. Se il pagamento è autorizzato ma non ancora catturato, la pagina mostra Your payment is authorized. The order is confirmed as soon as Worldline confirms the capture. Se il pagamento di tale ordine fallisce, la pagina mostra Your Worldline payment was not completed. Please contact us about this order.

Se il pagamento non è stato completato, l'ordine non conserva alcuno stato, il carrello viene mantenuto e il cliente torna al checkout con un messaggio:

Se lo stato non può ancora essere verificato, una pagina Payment confirmation mostra We could not confirm your payment yet. If you completed the payment, please do not pay again — you will receive a confirmation as soon as Worldline confirms it. con i pulsanti Check again e Back to checkout. Il webhook imposta lo stato dell'ordine non appena arriva.

Su OpenCart 4 questi messaggi sono mostrati sopra la pagina del checkout.

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 dopo un annullamento o un rifiuto il cliente paga lo stesso ordine su una nuova pagina di pagamento Worldline. Prima di un nuovo pagamento, l'estensione controlla il carrello: se un altro ordine dello stesso carrello è già pagato, o se il tentativo precedente è stato pagato nel frattempo, il cliente va direttamente alla pagina di successo e non viene addebitato due volte. Se la pagina di pagamento precedente dello stesso ordine è ancora aperta per lo stesso importo e la stessa modalità, ed è stata creata meno di 30 minuti fa, il cliente vi viene rimandato.

Su OpenCart 4, se il pagamento dell'ordine del checkout è stato rifiutato o annullato dopo l'autorizzazione, il successivo Confirm Order riporta il cliente al checkout con il messaggio sul pagamento rifiutato invece della pagina di successo. Se il negozio ha chiuso quell'ordine (per esempio annullandolo o rimborsandolo), il messaggio è Your previous order was closed by the shop (cancelled / refunded). Please confirm the order again to pay with a new order. In entrambi i casi il successivo Confirm Order paga un nuovo ordine. Se l'ordine del checkout è già pagato ma il carrello è cambiato da allora, incluso un nuovo quantitativo, il cliente torna al checkout e il nuovo carrello viene pagato con un nuovo ordine.

Se Worldline non può avviare il pagamento, il cliente resta nel passaggio Confirm Order con il messaggio Payment error: Could not create checkout session. Please try again. sopra il pulsante. Il motivo viene scritto nel registro. Se mancano le credenziali della modalità corrente, il cliente vede This payment method is not available at the moment. Please choose another payment method.

Il webhook e il ritorno del cliente funzionano anche mentre il negozio è in modalità manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, e su OpenCart 4 l'estensione aggiunge per esse un'azione di avvio.

L'estensione accetta pagamenti singoli come vendita diretta sulla pagina di Worldline. Non prevede tokenizzazione né carte salvate, né abbonamenti, né modulo carta incorporato, né modalità di sola autorizzazione con cattura o annullamento da OpenCart, né surcharge, né registrazione automatica dei webhook.

Ordini e rimborsi

Stati ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Worldline e non ha pagato, oppure Worldline non ha ancora confermato il pagamento. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Paid Order Status o Complete Order Status (predefinito Processing o Complete): il pagamento è stato catturato. Lo stato segue Order Status After Payment. Una nota mostra l'importo, l'ID del pagamento Worldline e come è stato confermato (webhook firmato o verifica dello stato).

Awaiting Capture Status (predefinito Pending): Worldline segnala il pagamento come autorizzato o la cattura come richiesta, ma non ancora eseguita. L'ordine passa allo stato pagato quando il webhook conferma la cattura. Se la nota indica che il pagamento non è catturato, catturalo nel Worldline Merchant Portal.

On Hold (Review) Status (predefinito Pending): il pagamento non corrisponde all'ordine, per esempio perché importo o valuta differiscono, o perché il pagamento appartiene a un altro tentativo. La nota mostra l'importo pagato, il totale dell'ordine e il riferimento. Verifica l'ordine ed evadilo, oppure rimborsa il pagamento.

Payment Error Status (predefinito Failed): Worldline ha rifiutato o annullato il pagamento di un ordine in attesa di cattura.

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

Se arriva un pagamento per un ordine annullato o rimborsato, l'ordine non viene riaperto. Una nota ti chiede di annullare o rimborsare il pagamento nel Worldline Merchant Portal, oppure di ripristinare l'ordine manualmente. Il cliente che torna vede Your payment was received after this order had been cancelled. Please contact us — we will restore the order or refund the payment. Se arriva un secondo pagamento per un ordine già pagato, o per un altro ordine di un carrello già pagato, l'ordine non cambia. Una nota sull'ordine pagato ti chiede di rimborsare il secondo pagamento nel Worldline Merchant Portal.

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

Scheda VibeFox Worldline Gateway

In Sales > Orders apri un ordine pagato con Worldline. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Worldline Gateway mostra il blocco Worldline payment: il Payment ID, il Merchant reference, l'Hosted checkout, lo Status del tentativo, l'Amount charged / refunded, un'etichetta Test environment per i pagamenti di test, il modulo di rimborso, la cronologia dei rimborsi e le Payment notes dell'ordine. La scheda è visibile agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Worldline Gateway inserisci l'importo (viene precompilato quello non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Worldline. Conferma la domanda Refund this amount through Worldline? This cannot be undone. Sono supportati rimborsi totali e parziali. Il pagamento deve essere catturato. Serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi vengono eseguiti per l'importo e nella valuta addebitati da Worldline; quindi, dopo una differenza di importo o di valuta, puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. Il rimborso viene sempre inviato all'ambiente del pagamento originale (test o reale) con le credenziali di quell'account, che quindi devono essere impostate. Un rimborso ritentato dopo un timeout non viene eseguito due volte, e per un ordine si esegue un solo rimborso alla volta. Se Worldline rifiuta il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso accettato viene aggiunto alla cronologia dei rimborsi e alle note, con l'ID e lo stato del rimborso Worldline. Un rimborso totale imposta l'ordine su Refunded Status senza notificare il cliente e senza restituire i prodotti al magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Worldline.

I cambi di stato dei rimborsi arrivano da Worldline via webhook, aggiornano la cronologia dei rimborsi e vengono aggiunti alle note. I rimborsi effettuati nel Merchant Portal non cambiano lo stato dell'ordine; 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 Worldline Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Worldline Gateway > Edit, sopra le impostazioni. Inserisci la chiave in License key e clicca su Activate. Poi 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 compaiono la riga Product: opencart-payment-worldline e il collegamento 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 un cambio dell'indirizzo del negozio, o dopo aver liberato un posto per il 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 dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il posto per il dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Worldline non viene mostrato ai clienti al checkout. Se comunque un pagamento viene avviato, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore connesso 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 i 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 dell'amministrazione o la pagina Edit: 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

Worldline non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità corrente abbia un Merchant ID, un API Key ID e una Secret API Key: i campi di test in modalità di test, quelli reali in modalità reale. La pagina delle impostazioni mostra un avviso quando mancano. Verifica 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. Nel Merchant Portal dell'account che usi (test o reale) verifica che l'endpoint esista e che il suo URL sia esattamente quello mostrato in Endpoint URL, senza redirect. Verifica che il segreto del webhook di quell'account sia nel campo corrispondente (Test Webhook Secret o Live Webhook Secret) e che il campo dell'ID della chiave webhook sia vuoto o coincida con la chiave. L'ordine riceve comunque il suo stato quando il cliente torna nel negozio dopo aver pagato.

Il webhook risponde Webhook secret not configured: nessuno dei due segreti del webhook è impostato. Inserisci il segreto del webhook nelle impostazioni. Worldline ritenta il webhook.

Il webhook risponde Invalid signature: il segreto del webhook appartiene a un altro account o un'altra chiave, oppure l'ID della chiave webhook non corrisponde alla chiave che ha inviato il webhook. Verifica che i segreti di test e reali non siano stati scambiati.

Il webhook risponde Missing signature, Empty body o Invalid JSON: la richiesta non è arrivata da Worldline nel formato atteso, oppure un proxy o un redirect l'ha modificata. Verifica che l'URL risponda senza redirect.

Il webhook risponde Ignored: il webhook proviene da un Merchant ID diverso da quello delle impostazioni di quella modalità. Verifica Test Merchant ID (PSPID) o Live Merchant ID (PSPID).

Il webhook risponde Retry later: l'ordine era in conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Worldline ritenta il webhook. Guarda il campo Log per il motivo.

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

Test credentials o Live credentials mostra un errore: salva prima le impostazioni, poi verifica che Merchant ID, API Key ID e Secret API Key provengano dallo stesso account e che i valori di test siano nei campi di test e quelli reali nei campi reali.

Il cliente vede un errore dopo Confirm Order: guarda il campo Log nella pagina dell'estensione. Gli errori vengono registrati anche quando Logging è disattivato. Per i dettagli completi delle richieste, attiva Logging e riprova.

I pagamenti di test non confermano un pagamento reale: test e reale sono separati. Imposta Test Mode sulla modalità che vuoi usare e utilizza le credenziali e il webhook di quell'account.

L'ordine è in stato di verifica o in attesa di cattura dopo il pagamento: leggi le note nella scheda VibeFox Worldline Gateway (vedi Stati ordine). Worldline non ha ancora confermato la cattura (il webhook completa l'ordine), oppure l'importo o la valuta pagati non corrispondevano all'ordine.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: nessun pagamento Worldline catturato, pagamento rimborsato interamente, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure le credenziali dell'ambiente del pagamento non sono impostate.

Il rimborso fallisce con un messaggio sull'ambiente: il pagamento è stato effettuato nell'ambiente di test o reale, e le credenziali di quell'ambiente non sono impostate. Inseriscile e riprova.

Per gli sviluppatori: prima che venga creato il checkout ospitato, l'estensione attiva l'evento OpenCart wlg_hosted_checkout_data con i dati della richiesta e l'ordine, per esempio per limitare i metodi di pagamento mostrati.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Worldline 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 Payment page and orders, che tornano ai valori predefiniti in caso di reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che in modalità manutenzione lascia passare il webhook e il ritorno del cliente). Se Delete Data è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità di test, credenziali, segreti dei webhook, modello di pagina, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Le transazioni e i rimborsi di Worldline vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano 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 Worldline Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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