VibeFox Adyen for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato con 3.0.5.0) o 4.0.2 e successivi (testato con 4.1.0.3).

PHP: 8.0 o successivo.

Account Adyen: ti servono il nome del tuo account commerciante Adyen, una chiave API e una chiave HMAC per ogni ambiente che usi (test e live) e, per i pagamenti reali, il prefisso URL live. La chiave API appartiene a una credenziale API con i ruoli Checkout webservice e Merchant PAL webservice. La chiave HMAC viene generata per il webhook Standard (vedi Configuration). Il Customer Area di test è ca-test.adyen.com, quello live ca-live.adyen.com. Le chiavi di test e quelle live sono separate. Non serve alcuna chiave client, perché la pagina di pagamento è ospitata da Adyen.

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_adyen_gateway-oc3-(versione).ocmod.zip e il pacchetto per OpenCart 4 wcp_adyen_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_adyen_gateway-oc3-(versione).ocmod.zip. L'estensione non contiene modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. In alternativa all'installer, puoi copiare il contenuto della cartella upload dell'archivio nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Adyen 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 il tuo account commerciante, la chiave API di test e la chiave HMAC di test, e più tardi la chiave API live, la chiave HMAC live e il prefisso URL live.

5. Nel Customer Area di Adyen (test e live) aggiungi un webhook Standard con l'URL mostrato nella sezione Webhook delle impostazioni (vedi Configurazione).

6. Attiva Enable/Disable e clicca su Save. Prova un pagamento con Test mode attivo, poi disattivalo.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_adyen_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 di estensione Payments. Trova VibeFox Adyen 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 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 Adyen Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Finché le impostazioni della modalità corrente sono incomplete, la pagina mostra Adyen is hidden at checkout until the test settings are complete (o le impostazioni live) ed elenca ciò che manca: Merchant account, la chiave API, la chiave HMAC e, in modalità live, Live URL prefix. Finché la modalità di test è attiva, la pagina mostra Test mode is on: payment links and refunds go to the Adyen test environment, no real money. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title deve avere da 1 a 128 caratteri, Sort Order deve essere un numero intero e Total un numero pari o maggiore di 0; la zona geografica e gli stati dell'ordine devono esistere. Altrimenti non viene salvato nulla e la pagina indica il campo. Una chiave HMAC non esadecimale o un prefisso URL live con caratteri diversi da lettere, cifre e trattini non vengono salvati: un avviso indica il campo, resta il valore precedente e le altre impostazioni vengono salvate.

Adyen

Enable/Disable: Enable Adyen payment gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

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

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

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

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

Total: l'importo totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere perché venga offerto Adyen. Lascialo vuoto per offrire Adyen per qualsiasi importo.

Account Adyen

Le chiavi API si creano nel Customer Area di Adyen, in Developers > API credentials (la sezione contiene i link al Customer Area di test e a quello live). Compila entrambi i set di chiavi; l'interruttore Test mode seleziona quale viene usato.

Test mode: usa l'ambiente di test di Adyen (nessun denaro reale). Quando è attivo, i link di pagamento e i rimborsi vengono inviati a checkout-test.adyen.com con la chiave API di test. Predefinito: attivo. Disattivalo per accettare pagamenti reali. Finché è attivo, i clienti vedono Test mode: no real payment is taken. nel passaggio Confirm Order.

Merchant account: il nome del tuo account commerciante Adyen (non l'account aziendale), per esempio MyShopECOM. Di solito è lo stesso nel Customer Area di test e in quello live.

Credenziali di test

Usate mentre Test mode è attivo.

Test API key: dal Customer Area di test: Developers > API credentials > la tua credenziale > API key.

Test HMAC key: dal Customer Area di test: Developers > Webhooks > il tuo webhook Standard > HMAC key (esadecimale). Obbligatoria: i webhook senza una firma valida vengono rifiutati.

Credenziali live

Usate quando Test mode è disattivato.

Live API key: dal Customer Area live: Developers > API credentials > la tua credenziale > API key.

Live HMAC key: dal Customer Area live: Developers > Webhooks > il tuo webhook Standard > HMAC key (esadecimale).

Live URL prefix: dal Customer Area live: Developers > API URLs, per esempio 1797a841fbb37ca7-AdyenDemo da https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com. Puoi incollare l'intero URL; il prefisso viene estratto al salvataggio.

Le chiavi API e HMAC salvate non vengono mai 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 clicca su Save.

Webhook

Gli ordini vengono segnati come pagati solo tramite i webhook di Adyen. Nel Customer Area (test e live) vai su Developers > Webhooks e aggiungi un Standard webhook con l'URL mostrato in Webhook URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_adyen_gateway/webhook, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_adyen_gateway/payment/wcp_adyen_gateway.webhook. Viene costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni, perché Adyen non segue i reindirizzamenti. Scegli il metodo JSON, attiva Generate HMAC key e copia la chiave in Test HMAC key o in Live HMAC key.

L'ambiente di ogni notifica seleziona la chiave HMAC, e una notifica viene applicata solo a un link di pagamento creato nello stesso ambiente e con lo stesso account commerciante. Una notifica di test non conferma mai un pagamento reale. I webhook senza una firma valida vengono rifiutati con HTTP 401, e Adyen li ripropone più tardi. Senza il webhook, nessun ordine riceve uno stato.

L'estensione gestisce questi eventi (sono elencati anche in questa sezione):

Gli altri eventi vengono aggiunti alle note dell'ordine. Le notifiche per un ordine senza stato, diverse da AUTHORISATION, vengono ignorate. Le notifiche che non riguardano un ordine di questo negozio, per esempio il pulsante di test del Customer Area, vengono accettate e ignorate. Il webhook funziona anche mentre il negozio è in modalità manutenzione, perché OpenCart lascia passare le richieste delle estensioni di pagamento. Su OpenCart 4 l'estensione aggiunge a questo scopo una startup action.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo quando Adyen conferma il pagamento con il webhook AUTHORISATION firmato e importo e valuta corrispondono all'ordine. Il ritorno del cliente non modifica mai l'ordine. Ciascun campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order status after payment: lo stato impostato da un webhook AUTHORISATION riuscito e firmato. Predefinito: In lavorazione.

On hold (review) status: una mancata corrispondenza di importo o valuta, un'acquisizione non riuscita di un ordine pagato, oppure un pagamento ricevuto dopo che lo stato dell'ordine era già stato cambiato (per esempio annullato). Una nota spiega il motivo. Predefinito: In attesa di pagamento, perché OpenCart non ha lo stato On hold. Puoi creare il tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Cancelled status: impostato quando Adyen annulla il pagamento dell'ordine (CANCELLATION). Predefinito: Annullato.

Refunded status: impostato dopo che il pagamento è stato rimborsato interamente dalla pagina dell'ordine. Se Adyen segnala poi che questo rimborso non è riuscito, l'ordine passa allo stato di revisione con una nota. Predefinito: Rimborsato.

Avanzate

Debug log: scrive le chiamate API e gli eventi dei webhook in adyg_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 adyg_debug.old.log.php. Gli errori vengono sempre registrati, anche con l'interruttore disattivato. I log non contengono mai chiavi API o HMAC, né dati personali degli acquirenti. Predefinito: disattivato.

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

Delete data on uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni del gateway e il registro. I record di pagamento di Adyen (riferimenti PSP, eventi dei webhook, rimborsi) restano sempre, così gli ordini vecchi restano rimborsabili. Predefinito: disattivato.

Importazione / Esportazione

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

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Adyen). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to Adyen to complete the payment securely. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea un link di pagamento Adyen per il totale dell'ordine, nella valuta dell'ordine, e invia il cliente alla pagina di pagamento di Adyen. Lì il cliente paga con qualsiasi metodo abilitato nel tuo account Adyen. L'e-mail, il nome e il paese di fatturazione del cliente (o il paese del negozio) e la lingua del negozio vengono passati ad Adyen, e il pagamento compare come Order # seguito dal numero dell'ordine.

Dopo il pagamento, il cliente torna al tuo negozio. Il ritorno in sé non paga un ordine: l'ordine viene segnato come pagato solo quando Adyen lo conferma con il webhook AUTHORISATION firmato e importo e valuta corrispondono all'ordine. Poi l'ordine riceve il suo stato nel modo standard di OpenCart, con le normali e-mail d'ordine e l'aggiornamento del magazzino. Se il webhook è già arrivato, il cliente vede la pagina di successo dell'ordine di OpenCart con Your payment with Adyen has been received. (oppure Your payment with Adyen has been received and is being reviewed by the store. per un ordine in revisione). Se Adyen ha annullato il pagamento prima, la pagina mostra Your Adyen payment was not completed. Please contact us about this order. Se il webhook non è ancora arrivato, una pagina Payment confirmation mostra Your payment is being confirmed by Adyen. Your order will be confirmed as soon as Adyen confirms the payment, and you will receive an e-mail. con i pulsanti Check again e Back to checkout, per un cliente che non ha completato il pagamento.

Se il pagamento viene rifiutato, l'ordine resta senza stato e il cliente può pagare di nuovo tramite lo stesso link oppure tornare al checkout. Ogni nuovo tentativo (OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout) rende invalidi i link di pagamento precedenti dell'ordine e del carrello, così non possono essere pagati nemmeno quelli. Se l'ordine ha già uno stato, il cliente va alla pagina di successo invece di avviare un nuovo pagamento.

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. L'indirizzo di pagamento è facoltativo su OpenCart 4: senza di esso, il nome del cliente viene passato come nome del pagatore e il paese dell'indirizzo di spedizione (o il paese del negozio) come paese. OpenCart 4 mantiene un unico ordine per il checkout e lo aggiorna: Back to checkout e un nuovo Confirm Order creano un nuovo link di pagamento per lo stesso ordine e fanno scadere il precedente. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio se Adyen ha annullato il pagamento o hai annullato tu l'ordine), il cliente torna al checkout con il messaggio Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. sopra la pagina del checkout, e il successivo Confirm Order paga un nuovo ordine. Se l'ordine del checkout era già stato pagato per un carrello diverso, il cliente torna al checkout e paga un nuovo ordine. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

Se il link di pagamento non può essere creato, il cliente resta nel passaggio Confirm Order con Payment could not be initiated. Please try again or choose another payment method. Il motivo viene scritto nel log. Se le impostazioni sono incomplete, il messaggio è Payment gateway is not configured properly. Please contact the store administrator.

L'estensione non prevede abbonamenti o pagamenti ricorrenti, carte salvate, campi carta sul sito (Drop-in o Components), pulsanti di acquisizione o annullamento in OpenCart, né autenticazione di base per i webhook.

Ordini e rimborsi

Stati dell'ordine

No status (missing order): il cliente è stato inviato ad Adyen e non ha pagato, il pagamento è stato rifiutato, oppure Adyen 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): il pagamento è stato autorizzato. Una nota mostra l'importo, il riferimento PSP e il metodo di pagamento.

On hold (review) status (default Pending): Adyen ha confermato un importo o una valuta diversi dal totale dell'ordine, un'acquisizione non è riuscita, un rimborso totale non è riuscito, oppure il pagamento è arrivato dopo che lo stato dell'ordine era stato cambiato, per esempio in annullato. La nota lo spiega. Controlla il pagamento nel Customer Area, poi evadi l'ordine o rimborsa il pagamento. Un pagamento corretto per un ordine in revisione dopo una mancata corrispondenza lo segna come pagato.

Cancelled status (default Canceled): il pagamento di questo ordine è stato annullato in Adyen.

Refunded status (default Refunded): il pagamento è stato rimborsato interamente tramite l'estensione. Viene impostato quando il rimborso viene inviato; se Adyen segnala poi che questo rimborso non è riuscito, l'ordine passa allo stato di revisione.

Se arriva un secondo pagamento riuscito per un ordine già pagato, per esempio da un vecchio link di pagamento, l'ordine non viene modificato. Una nota ti chiede di verificare nel Customer Area un eventuale addebito duplicato e, se necessario, di rimborsarlo lì. Lo stesso vale per un carrello: una volta che uno degli ordini del carrello è pagato, non viene creato alcun nuovo link di pagamento per un altro ordine dello stesso carrello, e un pagamento che arriva ancora per un ordine del genere non gli assegna uno stato; l'ordine pagato riceve la nota.

Su 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.

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

Scheda VibeFox Adyen Gateway

In Sales > Orders apri un ordine pagato con Adyen. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Adyen Gateway mostra la PSP reference con l'etichetta Test mode per i pagamenti di test, il Payment link, il Merchant account, lo Status del pagamento, gli importi Paid / refunded, il modulo di rimborso, lo storico dei rimborsi e le Adyen notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Adyen Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Adyen. Conferma la domanda Refund this amount through Adyen? This cannot be undone. Sono supportati rimborsi totali e parziali. Serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi vengono eseguiti per l'importo e nella valuta autorizzati da Adyen, quindi dopo una mancata corrispondenza di importo o valuta puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. Il rimborso viene inviato all'ambiente e all'account commerciante con cui è stato effettuato il pagamento, quindi la chiave API di quell'ambiente deve essere impostata. Per ogni ordine viene eseguito un solo rimborso alla volta. Se Adyen non accetta la richiesta, la scheda mostra l'errore e nessun rimborso viene registrato. I rimborsi sono disponibili una volta che Adyen ha autorizzato il pagamento.

Adyen elabora i rimborsi in modo asincrono: la richiesta viene aggiunta allo storico dei rimborsi e alle note con lo stato received, e il risultato finale arriva tramite il webhook REFUND o REFUND_FAILED. Un rimborso non riuscito non conta più come rimborsato. Quando i rimborsi inviati raggiungono l'importo pagato, l'ordine passa allo Refunded status senza notificare il cliente e senza rimettere in magazzino i prodotti, come un cambio di stato manuale. Un rimborso parziale non modifica lo stato. Con l'acquisizione manuale in Adyen, si possono rimborsare solo i pagamenti acquisiti.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Adyen. I rimborsi effettuati nel Customer Area di Adyen arrivano tramite webhook e vengono aggiunti alle note. Lo stato dell'ordine non viene modificato automaticamente.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Adyen Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Adyen Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo di ciò 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 di essi si trovano la riga Product: opencart-payment-adyen 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 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, Adyen 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. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede il login dell'amministrazione, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non 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 verificato di nuovo 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 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

Adyen non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che le impostazioni della modalità corrente siano complete: Merchant account, la chiave API e la chiave HMAC di quella modalità e, in modalità live, Live URL prefix. La pagina delle impostazioni elenca ciò che manca. 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: il webhook non funziona. Nel Customer Area dell'ambiente che usi (test o live) verifica che esista il webhook Standard, che il suo URL sia esattamente quello mostrato in Webhook URL e che il metodo sia JSON. Verifica che la chiave HMAC di quel webhook sia nel campo corretto (Test HMAC key o Live HMAC key). Con una chiave HMAC non valida o mancante, l'estensione risponde HTTP 401 e Adyen riprova la consegna più tardi, quindi l'ordine riceve lo stato automaticamente non appena la chiave viene corretta. Il log mostra che la firma HMAC non è valida o che la chiave HMAC non è configurata.

Il webhook risponde [rejected] HMAC key not configured: la chiave HMAC dell'ambiente della notifica è vuota. Incollala nelle impostazioni.

Il webhook risponde [rejected] invalid HMAC signature: la chiave HMAC appartiene a un altro webhook o a un altro ambiente. Se un elemento di un lotto ha una firma errata, viene rifiutato l'intero lotto.

Il webhook risponde [rejected] busy, retry later: l'ordine era in elaborazione da un'altra consegna nello stesso momento, oppure l'elaborazione non è riuscita. Adyen riprova il webhook automaticamente. Il motivo è nel log.

L'URL del webhook mostra [rejected] POST required nel browser: è normale. L'URL accetta solo notifiche da Adyen.

Avviso sulla chiave HMAC al salvataggio: il campo deve contenere la chiave HMAC esadecimale del Customer Area. È stato mantenuto il valore precedente.

Il cliente vede Payment could not be initiated: guarda il campo Log nella pagina dell'estensione (gli errori vengono sempre registrati). Verifica la chiave API, l'account commerciante e, in modalità live, il prefisso URL live.

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.

L'ordine è nello stato di revisione dopo il pagamento: leggi le note nella scheda VibeFox Adyen Gateway. L'importo o la valuta confermati da Adyen non corrispondevano all'ordine, un'acquisizione non è riuscita, oppure il pagamento è arrivato dopo che lo stato dell'ordine era stato cambiato.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: Adyen non ha ancora autorizzato il pagamento, è già rimborsato per intero, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure le credenziali dell'ambiente in cui è stato effettuato il pagamento non sono configurate.

Il rimborso non riesce: la scheda mostra il messaggio di Adyen. Con l'acquisizione manuale, si possono rimborsare solo i pagamenti acquisiti. Se è in corso un altro rimborso dell'ordine, attendi un momento e riprova.

Per gli sviluppatori: prima che il link di pagamento venga creato, l'estensione attiva l'evento OpenCart adyg_payment_link_request con i dati della richiesta e l'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Adyen 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 in caso di reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 i suoi eventi e la sua startup action, che lascia passare il webhook in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse anche le altre impostazioni del gateway (titolo, descrizione, modalità di test, account commerciante, chiavi, prefisso URL live, registrazione) e il registro. Se è disattivo, vengono conservate per una futura reinstallazione. I record di pagamento di Adyen (riferimenti PSP, eventi dei webhook, rimborsi) vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti mantengono le note di pagamento.

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

Adyen è un marchio registrato del suo proprietario. Questa estensione non è affiliata ad Adyen né approvata da Adyen.