VibeFox Authorize.Net for OpenCart — Guida
Requisiti
OpenCart: 3.0.x (testato su 3.0.5.0) o 4.0.2 e successivi (testato su 4.1.0.3).
PHP: 8.0 o successiva.
HTTPS: il checkout deve usare HTTPS. Accept.js non viene eseguito nelle pagine HTTP normali.
Account Authorize.Net: ti servono API Login ID, Transaction Key e Public Client Key del tuo account Authorize.Net, e una Signature Key se usi i webhook. Gli account di produzione (account.authorize.net) e quelli sandbox (sandbox.authorize.net) hanno credenziali diverse. Gli account Authorize.Net sono disponibili per i commercianti di Stati Uniti, Canada, Regno Unito, Europa, Australia e Nuova Zelanda.
Valuta: la valuta dell'ordine deve essere USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD o NZD, e il tuo account Authorize.Net deve regolare i pagamenti in quella valuta. Per le altre valute il metodo di pagamento viene nascosto al checkout.
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_authorizenet_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_authorizenet_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_authorizenet_gateway-oc3-(version).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 dell'archivio nella cartella principale del tuo negozio.
2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Authorize.Net 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 le credenziali degli account sandbox e di produzione (vedi Configurazione). Facoltativamente, configura il webhook.
5. Attiva Enable/Disable, scegli il Transaction type e clicca su Save. Prova un pagamento in modalità sandbox con la carta 4111 1111 1111 1111, una data di scadenza futura qualsiasi e un CVV qualsiasi, poi disattiva Sandbox mode.
OpenCart 4
1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_authorizenet_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 Authorize.Net 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 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'URL del webhook (vedi Webhooks (recommended)).
Una nuova installazione parte con il metodo di pagamento disattivato e la modalità sandbox attiva.
Configurazione
Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Authorize.Net 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 la vetrina non usa HTTPS (Accept.js funziona solo su pagine HTTPS), quando la valuta predefinita del negozio non è supportata da Authorize.Net, quando la modalità attuale non ha API Login ID, Transaction Key o Public Client Key (in quel caso il metodo di pagamento viene nascosto al checkout) e quando la modalità attuale non ha la Signature Key (in quel caso i webhook sono disattivati). Mentre la modalità sandbox è attiva, mostra Sandbox mode is on: test transactions, no real charges. 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, Transaction type deve essere una delle due opzioni, 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. Se un campo non è corretto, non viene salvato nulla e la pagina indica il campo.
Authorize.Net
Enable/Disable: Enable Authorize.Net attiva o disattiva il metodo di pagamento. Predefinito: disattivato.
Title: il nome del metodo di pagamento che i clienti vedono al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Credit Card. Obbligatorio, fino a 128 caratteri.
Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il modulo della carta. Predefinito: Pay securely with your credit card via Authorize.Net.
Sort Order: la posizione del pagamento con carta tra i metodi di pagamento del checkout. Lascialo vuoto o inserisci un numero intero.
Geo Zone: mostra il modulo della carta solo per gli indirizzi di pagamento 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 il metodo di pagamento venga proposto. Lascialo vuoto per proporlo per qualsiasi importo.
API credentials
Nella Merchant Interface di Authorize.Net apri Account > Settings > Security Settings. In API Credentials & Keys copia l'API Login ID e crea una Transaction Key e una Signature Key. In Manage Public Client Key copia la Public Client Key. Sandbox e produzione usano credenziali diverse. La sezione mostra i campi di entrambe le modalità, così puoi conservare entrambi i set.
Sandbox mode: usa la sandbox di Authorize.Net (transazioni di prova, nessun addebito reale). Cambia l'endpoint dell'API, Accept.js e il set di credenziali usato per i nuovi pagamenti. Predefinito: attivo. Disattivalo per accettare pagamenti reali. Mentre è attiva, i clienti vedono Sandbox mode: con la carta di prova 4111 1111 1111 1111 sopra il modulo della carta.
Sandbox API Login ID e Live API Login ID: l'API Login ID dell'account sandbox o di produzione.
Sandbox Transaction Key e Live Transaction Key: la Transaction Key di quell'account.
Sandbox Public Client Key e Live Public Client Key: la chiave pubblica usata da Accept.js nel browser.
Sandbox Signature Key e Live Signature Key: necessarie solo per i webhook. Verifica l'intestazione X-ANET-Signature di ogni notifica.
Le Transaction Key e le Signature Key salvate non vengono più mostrate. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo per modificarlo. Per rimuovere una chiave salvata, seleziona Clear the saved value on save sotto il campo e clicca su Save.
Payment
Transaction type: il modo in cui viene addebitata la carta. Un'autorizzazione scade dopo 30 giorni.
Webhooks (recommended)
Senza webhook, gli ordini trattenuti da Fraud Detection Suite, oppure acquisiti o annullati nel pannello di Authorize.Net, devono essere aggiornati a mano. Nella Merchant Interface vai su Account > Settings > Business Settings > Webhooks e clicca su Add Endpoint, sia nell'account sandbox sia in quello di produzione. Usa l'URL mostrato in Endpoint URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_authorizenet_gateway/webhook, su OpenCart 4 quello: https://your-store/index.php?route=extension/wcp_authorizenet_gateway/payment/wcp_authorizenet_gateway.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Seleziona questi eventi (sono elencati anche in questa sezione):
Inserisci la Signature Key di ciascun account in Sandbox Signature Key o Live Signature Key. I webhook senza firma valida vengono rifiutati. Una notifica deve essere firmata con la chiave della modalità in cui è stato effettuato il pagamento; una notifica dell'altra modalità non cambia nulla. Per ogni notifica l'estensione chiede inoltre ad Authorize.Net lo stato attuale e l'importo della transazione prima di modificare l'ordine, quindi le notifiche ripetute non cambiano nulla. Il webhook funziona anche quando il negozio è in modalità manutenzione, perché OpenCart lascia passare le richieste delle estensioni di pagamento.
Orders
OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo che Authorize.Net ha risposto per la carta. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.
Order Status After Payment: la carta è stata addebitata (Authorize and capture, oppure un'acquisizione successiva). Predefinito: Processing.
Authorized Status: Authorize only: i fondi sono riservati, non ancora acquisiti. Capture payment nella scheda dell'ordine viene proposto solo in questo stato. Predefinito: Pending.
On Hold (Review) Status: trattenuto per verifica da Fraud Detection Suite, oppure l'importo addebitato o acquisito non corrisponde 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.
Canceled Status: rifiutata, annullata o scaduta in Authorize.Net senza pagamento (webhook), oppure l'autorizzazione è stata annullata dalla scheda dell'ordine. Predefinito: Canceled.
Refunded Status: impostato dopo che il pagamento è stato rimborsato per intero (o una transazione pagata è stata annullata) dalla scheda dell'ordine. Predefinito: Refunded.
Advanced
Debug log: scrive richieste e risposte API in wc_ang_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 wc_ang_debug.old.log.php. Chiavi, token delle carte e dati personali vengono mascherati. Predefinito: disattivato. Gli errori, come pagamenti rifiutati o non riusciti, errori API e rimborsi falliti, vengono sempre registrati, anche quando questa opzione è disattivata.
Log: mostra la dimensione e le ultime voci del log. Clicca su Clear log per svuotarlo.
Delete data on uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni e il log. Le transazioni e i rimborsi di Authorize.Net restano sempre, quindi gli ordini pagati in precedenza possono essere acquisiti e rimborsati anche dopo una nuova installazione. Predefinito: disattivato.
Import / Export
Export: Download JSON salva le impostazioni in un file JSON. Le Transaction Key e le Signature Key non vengono esportate.
Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Le chiavi segrete salvate vengono mantenute.
Checkout
Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit Card). Nel passaggio Confirm Order il cliente vede la tua descrizione e inserisce il numero della carta, la data di scadenza (MM/YY) e il codice di sicurezza (CVV) nel modulo sopra il pulsante di conferma. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Accept.js viene caricato da Authorize.Net solo con questo modulo. Quando il cliente clicca su Confirm Order, Accept.js scambia i dati della carta con un token monouso nel browser. I campi della carta non hanno nomi di form, quindi il numero della carta e il CVV non vengono mai inviati al tuo server.
L'estensione addebita il token tramite l'API di Authorize.Net per il totale dell'ordine nella valuta dell'ordine. Indirizzo di fatturazione, e-mail e indirizzo IP vengono inviati con la transazione per la verifica dell'indirizzo e i filtri antifrode, e il numero dell'ordine viene inviato come numero di fattura. L'ordine viene segnato come pagato solo dopo che Authorize.Net lo conferma: se la transazione è approvata, l'ordine riceve il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino, il carrello viene svuotato e il cliente vede la pagina di successo dell'ordine di OpenCart con Your card payment has been received. Con Authorize only la pagina mostra Your card payment has been authorized. The amount will be charged when your order is processed. Se Fraud Detection Suite trattiene la transazione, viene mostrato Your payment is being reviewed. We will update your order as soon as the review is complete.
Se la carta viene rifiutata, il cliente resta nel passaggio Confirm Order e vede Payment failed: seguito dal motivo sotto il modulo, ad esempio una carta rifiutata, un codice di sicurezza errato o una carta scaduta. L'ordine resta senza stato, il carrello viene conservato e il cliente può inserire un'altra carta. Gli errori di configurazione e di API non vengono mostrati ai clienti: vedono un messaggio generico, e i dettagli vanno nel log. Se il negozio non riesce a raggiungere Authorize.Net, il cliente vede Payment error: unable to connect to the payment gateway. Please try again. Se i campi della carta sono vuoti, il modulo chiede Please enter the card number, expiry date and card code.
Un doppio clic, una seconda scheda o un invio ripetuto non addebitano mai due volte un ordine. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, quindi un solo carrello può avere più ordini (su OpenCart 4 un ordine precedente o una seconda scheda del browser possono ancora contenere lo stesso carrello): una volta pagato uno di essi, un altro ordine dello stesso carrello non viene addebitato. Il cliente vede This cart has already been paid with order #…. Please check your order history — do not pay again. Un secondo tentativo mentre il primo è ancora in corso mostra Your payment is already being processed. Please wait a moment and check your order history before trying again. Se un pagamento è stato approvato ma non è stato possibile impostare lo stato dell'ordine, il cliente vede Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. L'ordine riceve poi il suo stato dal pagamento approvato al tentativo successivo o tramite il webhook, senza addebitare di nuovo la carta.
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. Il modulo della carta compare poi nel blocco di conferma dell'ordine in fondo alla pagina del checkout, sopra Confirm Order. Su OpenCart 4 l'indirizzo di pagamento è facoltativo: senza di esso, l'indirizzo di spedizione viene inviato ad Authorize.Net come indirizzo di fatturazione. OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna, quindi dopo una carta rifiutata il cliente paga lo stesso ordine. Se quell'ordine nel frattempo è stato chiuso (per esempio l'hai annullato), oppure è già pagato e il carrello ora contiene un nuovo acquisto, Confirm Order riporta il cliente alla pagina del checkout, e il successivo Confirm Order paga un nuovo ordine. Sopra la pagina del checkout il cliente vede Your previous order is closed (cancelled or refunded by the store). Please confirm the order again: the cart will be paid with a new order. quando l'ordine è stato chiuso, oppure Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order. quando è stato pagato per un carrello precedente. Una modifica del carrello, inclusa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.
Se l'importo addebitato non corrisponde al totale dell'ordine, l'ordine passa allo stato On Hold (Review) Status con una nota, e il pagamento viene registrato per l'importo effettivamente addebitato.
L'estensione non prevede carte salvate né profili cliente, abbonamenti o pagamenti ricorrenti, eCheck/ACH, Apple Pay, Google Pay, PayPal o 3-D Secure, né acquisizione parziale di un'autorizzazione né conversione automatica della valuta.
Ordini e rimborsi
Order statuses
No status (missing order): la carta è stata rifiutata o il pagamento non è riuscito. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.
Order Status After Payment (default Processing): la carta è stata addebitata (Authorize and capture), oppure un'autorizzazione è stata acquisita. Una nota mostra l'importo, il Trans ID, il codice di autorizzazione, il tipo di carta e le ultime quattro cifre.
Authorized Status (default Pending): i fondi sono solo autorizzati (Authorize only). Acquisiscili prima dell'evasione.
On Hold (Review) Status (default Pending): Fraud Detection Suite ha trattenuto la transazione per verifica, l'importo addebitato non corrisponde al totale dell'ordine, oppure un'acquisizione segnalata dal webhook non corrisponde all'importo dell'ordine. La nota lo spiega. Approva o rifiuta una transazione trattenuta nel pannello di Authorize.Net; con i webhook l'ordine viene aggiornato automaticamente.
Canceled Status (default Canceled): un webhook ha segnalato che la transazione è stata rifiutata, annullata o è scaduta prima del pagamento dell'ordine, oppure hai annullato un'autorizzazione non acquisita. Se la transazione di un ordine pagato viene annullata nel pannello di Authorize.Net, il suo stato non cambia e viene aggiunta una nota di avviso.
Refunded Status (default Refunded): il pagamento è stato rimborsato o annullato per intero tramite l'estensione.
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 un ordine del genere come un ordine senza stato: un pagamento o un webhook successivo ne imposta comunque lo stato.
Le note sono voci della History dell'ordine che il cliente non vede.
VibeFox Authorize.Net Gateway tab
In Sales > Orders apri un ordine pagato con Authorize.Net. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Authorize.Net Gateway mostra il Trans ID con l'etichetta Sandbox per i pagamenti sandbox, il Transaction type, lo Status della transazione, la Card e il codice di autorizzazione, gli importi Charged / order / refunded, il pulsante di acquisizione, il modulo di rimborso, lo storico dei rimborsi e le Authorize.Net notes dell'ordine. La scheda è mostrata agli utenti che hanno accesso all'estensione. Acquisizione e rimborsi richiedono il permesso di modificare l'estensione (impostato in System > Users > User Groups).
Capture
Per un ordine in Authorized Status, clicca su Capture payment nella scheda e conferma Capture the authorized amount through Authorize.Net? L'importo autorizzato viene acquisito e l'ordine riceve l'Order Status After Payment. Se l'acquisizione non riesce, viene mostrato l'errore e aggiunto alle note. Puoi anche acquisire nel pannello di Authorize.Net; con i webhook l'ordine viene aggiornato automaticamente.
Refunds
Nella scheda inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), clicca su Refund via Authorize.Net e conferma Refund this amount through Authorize.Net? This cannot be undone. Un rimborso dell'importo totale annulla prima la transazione, se non è ancora stata regolata, oppure un'autorizzazione che non è stata acquisita. Le transazioni regolate, di solito dopo 24 ore, possono essere rimborsate in tutto o in parte. Prima della regolazione non è possibile un rimborso parziale: rimborsa l'importo totale per annullare la transazione, oppure riprova dopo la regolazione. I rimborsi vengono eseguiti nell'importo e nella valuta addebitati da Authorize.Net, quindi dopo una differenza di importo puoi rimborsare fino a quanto il cliente ha realmente pagato, non fino al totale dell'ordine. Se Authorize.Net non accetta il rimborso, la scheda mostra l'errore e nessun rimborso viene registrato. Un rimborso o un annullamento riuscito viene aggiunto allo storico dei rimborsi e alle note. Un rimborso totale imposta l'ordine su Refunded Status (Canceled Status quando è stata annullata solo un'autorizzazione) senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio manuale di stato. Un rimborso parziale non cambia lo stato. Mentre una transazione è trattenuta per verifica, i rimborsi non vengono proposti.
Acquisizioni, rimborsi e verifiche webhook di un ordine usano le credenziali della modalità in cui l'ordine è stato pagato, quindi gli ordini dell'altra modalità possono ancora essere acquisiti e rimborsati dopo che hai cambiato Sandbox mode. Conserva le credenziali di quella modalità nei rispettivi campi finché questi ordini non sono completati.
Le restituzioni di prodotti in Sales > Returns non rimborsano denaro tramite Authorize.Net. I rimborsi effettuati nel pannello di Authorize.Net non vengono comunicati al negozio: aggiorna l'ordine manualmente.
Chiave di licenza
L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco di licenza License — VibeFox Authorize.Net Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Authorize.Net Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (ad esempio la data fino a cui 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-authorizenet 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, ad esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo una modifica dell'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 solo dominio: l'indirizzo del negozio della configurazione di OpenCart. Rimuovere la chiave dal negozio non libera lo slot del dominio. Libera lo slot nel tuo account vibefox.net.
Senza una chiave attiva, il pagamento con carta di Authorize.Net 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 con (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 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 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
Il pagamento con carta non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità attuale abbia API Login ID, Transaction Key e Public Client Key. La pagina delle impostazioni mostra un avviso se ne manca una. Controlla che la valuta del cliente sia supportata, 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 nello stato autorizzato o in revisione: il tipo di transazione è Authorize only (acquisiscila nella scheda dell'ordine), oppure Authorize.Net ha trattenuto la transazione per verifica. Approvala o rifiutala nel pannello di Authorize.Net. Per far aggiornare automaticamente questi ordini, configura il webhook: verifica che l'endpoint esista nell'account della modalità che usi, che il suo URL sia esattamente quello mostrato in Endpoint URL, che i quattro eventi siano selezionati e che la Signature Key di quell'account sia inserita.
Risposta del webhook: webhooks are not configured: non è inserita nessuna Signature Key per nessuna delle due modalità.
Risposta del webhook: invalid signature: la Signature Key appartiene a un altro account, oppure in Authorize.Net è stata cambiata una chiave. Crea o copia di nuovo la Signature Key e incollala nel campo della sua modalità.
Risposta del webhook: mode mismatch: la notifica è stata firmata con la chiave di una modalità, ma il pagamento è stato effettuato nell'altra. Verifica che le Signature Key sandbox e live non siano scambiate.
Risposta del webhook: verification failed, retry later: il negozio non è riuscito a leggere la transazione tramite l'API di Authorize.Net, oppure mancano le credenziali della modalità del pagamento. Authorize.Net ripete la consegna.
Risposta del webhook: busy, retry later: nello stesso momento l'ordine era in aggiornamento da un'altra richiesta, oppure l'elaborazione non è riuscita. Authorize.Net ripete la consegna. Guarda il campo Log per il motivo.
L'URL del webhook mostra method not allowed nel browser: è normale. L'URL accetta solo richieste da Authorize.Net.
Il modulo della carta mostra The secure card form (Accept.js) could not be loaded: il checkout deve usare HTTPS, e la Public Client Key e l'API Login ID della modalità attuale devono essere corrette.
Payment error: the card could not be tokenized: Accept.js non ha restituito un token. Il cliente deve inserire di nuovo i dati della carta e riprovare.
Il cliente vede This payment method is not available: la sessione di checkout non corrisponde più all'ordine, il metodo di pagamento è stato disattivato nel frattempo, le credenziali mancano o il totale dell'ordine è zero. Con Please reload the checkout page il cliente ricarica il checkout.
Il cliente vede un errore generico: controlla il campo Log nella pagina dell'estensione; gli errori vengono sempre scritti lì. Una valuta non supportata dall'account viene rifiutata da Authorize.Net.
Un rimborso parziale non riesce perché la transazione non è ancora regolata: rimborsa l'importo totale per annullare la transazione, oppure riprova dopo la regolazione, di solito entro 24 ore.
Rimborso o acquisizione non riescono con un messaggio sulla modalità: il pagamento è stato effettuato in modalità sandbox o live, e l'API Login ID e la Transaction Key di quella modalità non sono impostate. Inseriscile e riprova.
Disinstallazione
Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Authorize.Net 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 dell'ordine della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi, compreso quello che mostra il messaggio sopra la pagina del checkout, e la sua azione di avvio, che lascia passare il webhook in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità sandbox, credenziali, tipo di transazione, registrazione) e il log. Se è disattivo, vengono conservate per una reinstallazione futura. Le transazioni e i rimborsi di Authorize.Net vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere acquisiti e rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano le loro note di pagamento.
Su OpenCart 4, per rimuovere anche i file dell'estensione, dopo la disinstallazione vai su Extensions > Installer e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox Authorize.Net Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.
Authorize.Net è un marchio del rispettivo proprietario. Questa estensione non è affiliata né approvata da Authorize.Net.