VibeFox Datatrans for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Account Datatrans: ti servono il merchant ID, la password API server-to-server e, consigliata, la chiave di firma HMAC-SHA256 per i webhook. Le credenziali sandbox si ottengono dal Web Admin sandbox di Datatrans (admin.sandbox.datatrans.com), quelle di produzione dal Web Admin di produzione (admin.datatrans.com). Sandbox e produzione sono account Datatrans separati, con merchant ID e chiavi diversi.

Negozio raggiungibile: Datatrans invia i webhook dai propri server, quindi il tuo negozio deve essere raggiungibile da internet.

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

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_datatrans_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_datatrans_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_datatrans_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non richiede un aggiornamento. 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 Datatrans 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 sandbox dal Web Admin sandbox di Datatrans (vedi Configurazione).

5. Attiva Enable/Disable e clicca su Save. Effettua un pagamento di prova in modalità sandbox. Quando tutto funziona, inserisci le credenziali di produzione e disattiva Sandbox mode.

OpenCart 4

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

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

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

4. Inserisci la chiave di licenza e le credenziali Datatrans e fai il pagamento di prova come nei passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali nelle due versioni. Cambia solo l'URL del webhook (vedi Configurazione).

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità sandbox attiva. L'URL del webhook viene inviato a Datatrans con ogni transazione, quindi non devi configurarlo.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Quando il metodo di pagamento è abilitato ma l'ambiente corrente non ha merchant ID o password API, la pagina mostra Datatrans is hidden at checkout until these settings are filled in: con i campi mancanti. Mentre la modalità sandbox è attiva, la pagina mostra Sandbox mode is on: payments go to the Datatrans sandbox, no real money is charged. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Quando salvi, Title non deve essere vuoto né più lungo di 128 caratteri, Sort Order deve essere un numero intero, Total un numero maggiore o uguale a 0, e la zona geografica e gli stati dell'ordine devono esistere. Altrimenti non viene salvato nulla e la pagina mostra l'errore. Una chiave di firma che non è una stringa esadecimale non viene salvata: resta il valore precedente, gli altri valori vengono salvati e la pagina mostra un avviso con il nome del campo.

Datatrans

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

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

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

Sandbox mode: usa la sandbox di Datatrans: pagamenti di prova, nessun denaro reale. Cambia sia i server di Datatrans sia le credenziali usate per i nuovi pagamenti. Predefinito: attivo. Disattivalo per accettare pagamenti reali. Finché è attivo, i clienti vedono Sandbox mode: no real payment is taken. nel passaggio Confirm Order. Rimborsi e acquisizioni usano sempre l'ambiente in cui è stato effettuato il pagamento, indipendentemente da questo interruttore.

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

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

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

Credenziali sandbox

Copiale dal Web Admin sandbox di Datatrans (admin.sandbox.datatrans.com, la pagina contiene il link). La chiave di firma si trova lì nelle impostazioni di sicurezza.

Sandbox merchant ID: il merchant ID del tuo account sandbox.

Sandbox API password: la password API server-to-server dell'account sandbox.

Sandbox HMAC sign key: la chiave esadecimale usata per verificare l'header Datatrans-Signature dei webhook. Senza di essa ogni webhook viene ricontrollato tramite l'API di stato di Datatrans.

Credenziali di produzione

Copiale dal Web Admin di produzione di Datatrans (admin.datatrans.com).

Production merchant ID: il merchant ID del tuo account di produzione.

Production API password: la password API server-to-server dell'account di produzione.

Production HMAC sign key: la chiave esadecimale usata per verificare l'header Datatrans-Signature dei webhook di produzione. Senza di essa ogni webhook viene ricontrollato tramite l'API di stato di Datatrans.

Le password e le chiavi di firma salvate non vengono più mostrate. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi modificarlo. Per rimuovere un valore salvato, spunta Clear the saved value on save sotto il campo e clicca su Save.

URL del webhook

La sezione mostra l'URL del webhook del tuo negozio. Per OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_datatrans_gateway/webhook, per OpenCart 4 https://your-store/index.php?route=extension/wcp_datatrans_gateway/payment/wcp_datatrans_gateway.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. L'estensione invia questo URL a Datatrans con ogni transazione, quindi non devi inserirlo da nessuna parte. Puoi anche inserirlo nelle impostazioni dei webhook del Web Admin di Datatrans per ricevere aggiornamenti su acquisizioni e annullamenti effettuati lì; copialo esattamente come lo mostrano le impostazioni. I rimborsi effettuati nel Web Admin di Datatrans non vengono riportati nell'ordine.

Il webhook comunica lo stato della transazione. L'estensione agisce in base a questi stati:

Con una chiave di firma HMAC, ogni webhook viene verificato tramite il suo header Datatrans-Signature con la chiave di firma dell'ambiente in cui è stato effettuato il pagamento. I webhook senza una firma valida vengono rifiutati. Senza chiave di firma, l'estensione non si fida del contenuto del webhook e verifica ogni webhook tramite l'API di stato di Datatrans. Senza webhook, un ordine riceve il suo stato solo quando il cliente torna nel negozio dopo aver pagato.

Elaborazione pagamento

Auto settle: acquisisce (regola) i pagamenti immediatamente. Se disattivato, i pagamenti vengono solo autorizzati: l'ordine viene messo in attesa e lo acquisisci più tardi con Capture Datatrans payment nella scheda dell'ordine, oppure lo rilasci con Cancel Datatrans authorization. Predefinito: attivo.

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Datatrans ha confermato il pagamento. Un pagamento non riuscito o annullato lascia l'ordine senza stato, e il carrello viene conservato. Ciascuno dei campi seguenti elenca gli stati degli ordini del tuo OpenCart.

Order status after payment: lo stato dell'ordine una volta regolato il pagamento e quando importo e valuta corrispondono. Predefinito: Processing.

Datatrans payment on hold: pagamenti solo autorizzati (Auto settle disattivo), discrepanze di importo o valuta e pagamenti arrivati dopo l'annullamento dell'ordine. Una nota spiega il motivo. Predefinito: Pending, perché OpenCart non ha lo stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Authorization canceled: impostato quando l'autorizzazione viene rilasciata con Cancel Datatrans authorization o nel Web Admin di Datatrans. Predefinito: Canceled.

Refunded: impostato dopo il rimborso totale del pagamento dalla pagina dell'ordine. Predefinito: Refunded.

Avanzate

Logging: scrive gli eventi di pagamento e le chiamate API in datatrans_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 datatrans_p_debug.old.log.php. Gli errori vengono sempre registrati, anche quando questo interruttore è disattivato. Non vengono scritte chiavi, dati delle carte né dati dei clienti. Predefinito: disattivato.

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

Delete data on uninstall: quando è attivo, la disinstallazione dell'estensione rimuove le impostazioni del modulo e il registro. I record di pagamento Datatrans degli ordini (transazioni, rimborsi) vengono mantenuti. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Password e chiavi di firma non vengono esportate.

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Datatrans). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the Datatrans payment page 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 una transazione Datatrans per il totale dell'ordine nella valuta dell'ordine, con il numero d'ordine di OpenCart come riferimento, e invia il cliente alla pagina di pagamento di Datatrans. La pagina si apre in tedesco, inglese, francese o italiano quando la lingua del negozio è una di queste. Lì il cliente paga con uno qualsiasi dei metodi abilitati nel tuo account Datatrans. Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco del metodo di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina di checkout.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo dopo che Datatrans lo ha confermato: tramite il webhook oppure tramite una richiesta lato server all'API di stato di Datatrans quando il cliente torna. L'indirizzo di ritorno contiene un token casuale del tentativo di pagamento, e l'indirizzo stesso non viene mai considerato attendibile. Poi l'ordine riceve il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento delle scorte, e il cliente vede la pagina di successo dell'ordine di OpenCart con Your payment with Datatrans has been received. Per un pagamento solo autorizzato, la pagina mostra Your payment with Datatrans has been authorized. The amount will be charged when your order is processed. Se Datatrans non ha ancora confermato il pagamento, una pagina Payment confirmation mostra Your payment is being confirmed by Datatrans. You will receive an e-mail as soon as it is confirmed. Please do not pay again. con i pulsanti Check again e Back to checkout; il webhook imposta lo stato dell'ordine non appena arriva. Su OpenCart 4 il browser non invia la sessione del negozio quando Datatrans rimanda il cliente indietro, quindi l'estensione mostra prima una breve pagina che riapre lo stesso indirizzo di ritorno dal tuo negozio: il cliente conserva il carrello e l'accesso.

Se il cliente annulla nella pagina di Datatrans, torna al checkout con The payment was canceled. You can try again or choose another payment method. Se il pagamento non è riuscito, il messaggio è The payment was not completed. Please try again or choose another payment method. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout. Il carrello viene conservato. 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, e un nuovo tentativo è una nuova transazione Datatrans dello stesso ordine. Prima che parta un nuovo pagamento, vengono verificate le transazioni Datatrans aperte degli ordini precedenti dello stesso carrello: una transazione pagata o autorizzata viene confermata invece di avviare un nuovo pagamento, una aperta viene annullata in Datatrans. Un carrello viene pagato una sola volta: se un altro ordine dello stesso carrello è già pagato o autorizzato, non viene avviato alcun nuovo pagamento e il cliente va alla pagina di successo. Se arriva comunque un pagamento per un altro ordine di un carrello già pagato, quell'ordine resta senza stato e l'ordine pagato riceve una nota che ti invita a controllare e rimborsare il duplicato in Datatrans.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio annullato, anche dopo l'annullamento di un'autorizzazione, o rimborsato), Confirm Order o il ritorno da Datatrans rimanda il cliente al checkout con Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., e il successivo Confirm Order paga un nuovo ordine del carrello. Se l'ordine è già pagato e il carrello è cambiato da allora (altri prodotti o quantità), il cliente torna al checkout, e il carrello modificato riceve un nuovo ordine e un proprio pagamento; lo stesso carrello va alla pagina di successo senza un nuovo pagamento.

Se Datatrans non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con The payment could not be started. Please try again or choose another payment method. Il motivo tecnico viene scritto nel registro.

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

L'estensione accetta pagamenti unici sulla pagina di pagamento di Datatrans. Non prevede carte o alias salvati, abbonamenti, Lightbox o Secure Fields sul tuo sito, scelta dei metodi di pagamento nelle impostazioni, né acquisizione parziale di un'autorizzazione.

Ordini e rimborsi

Stati degli ordini

No status (missing order): il cliente è stato inviato a Datatrans e non ha pagato, il pagamento non è riuscito o è stato annullato, oppure Datatrans non lo ha ancora confermato. 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 regolato. Una nota mostra l'importo, il metodo di pagamento, l'ID della transazione Datatrans, l'ambiente e come è stato confermato (webhook o ritorno).

Datatrans payment on hold after an authorization (default Pending): Auto settle è disattivo e il pagamento è solo autorizzato. Acquisiscilo o annullalo nella scheda dell'ordine.

Datatrans payment on hold after payment: Datatrans ha segnalato un importo o una valuta diversi dal totale dell'ordine, oppure il pagamento è arrivato dopo che l'ordine era stato annullato. La nota lo spiega. Controlla la transazione nel Web Admin di Datatrans, poi evadi l'ordine oppure rimborsa il pagamento.

Authorization canceled (default Canceled): l'autorizzazione è stata rilasciata, nella scheda dell'ordine o nel Web Admin di Datatrans.

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

Se arriva un secondo pagamento per un ordine già pagato o autorizzato, l'ordine non viene modificato. Una nota ti chiede di controllare e rimborsare il duplicato in Datatrans. Una transazione non riuscita o annullata non declassa mai un ordine pagato. Un pagamento per un ordine già rimborsato aggiunge solo una nota.

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

Scheda VibeFox Datatrans Gateway

In Sales > Orders apri un ordine pagato con Datatrans. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Datatrans Gateway mostra il Transaction ID con l'etichetta Sandbox per i pagamenti sandbox, lo Status di Datatrans, il Payment method, l'Amount, gli importi Paid / refunded, i pulsanti di acquisizione e annullamento oppure il modulo di rimborso, la cronologia dei rimborsi e le Datatrans notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione. Le sue azioni richiedono il permesso di modificare l'estensione (impostato in System > Users > User Groups).

Acquisizione e annullamento

Per un pagamento solo autorizzato, la scheda mostra Capture Datatrans payment e Cancel Datatrans authorization. L'acquisizione regola il pagamento per il totale attuale dell'ordine, che non può superare l'importo autorizzato; poi l'ordine passa a Order status after payment. L'annullamento rilascia l'autorizzazione e imposta l'ordine su Authorization canceled. Entrambe le operazioni vanno all'ambiente del pagamento. Se Datatrans le rifiuta, la scheda mostra l'errore e viene aggiunta una nota.

Rimborsi

Nella scheda inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Datatrans. Conferma la domanda Refund this amount through Datatrans? This cannot be undone. Sono supportati rimborsi totali e parziali, fino all'importo effettivamente addebitato da Datatrans meno i rimborsi precedenti. Il rimborso viene inviato all'ambiente del pagamento, quindi il merchant ID e la password API di quell'ambiente devono essere impostati. Un rimborso ritentato non viene accreditato due volte. Se Datatrans non accetta il rimborso, la scheda mostra l'errore e nessun rimborso viene registrato. Un rimborso riuscito viene aggiunto alla cronologia dei rimborsi e alle note, con l'ID della transazione di rimborso Datatrans. Un rimborso totale imposta l'ordine su Refunded senza avvisare il cliente e senza rimettere i prodotti in magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato.

I rimborsi sono disponibili quando Datatrans ha regolato il pagamento. Un pagamento solo autorizzato viene invece acquisito o annullato, e un'autorizzazione con importo non corrispondente non può essere rimborsata finché non viene regolata.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Datatrans. I rimborsi effettuati nel Web Admin di Datatrans non vengono registrati in OpenCart.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Datatrans Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto si trovano la riga Product: opencart-payment-datatrans 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 spiega 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 che l'indirizzo del negozio è cambiato, 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 dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Datatrans 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 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 all'amministrazione, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati, e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono un 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

Datatrans non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che l'ambiente corrente abbia il merchant ID e la password API: i campi sandbox in modalità sandbox, i campi di produzione altrimenti. La pagina delle impostazioni elenca i campi mancanti. 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: Datatrans non è riuscito a raggiungere l'URL del webhook e il cliente non è tornato nel negozio. Verifica che il negozio sia raggiungibile da internet e che nessun firewall blocchi le richieste all'URL del webhook. Verifica che la chiave di firma nelle impostazioni appartenga all'ambiente del pagamento. Guarda il campo Log nella pagina dell'estensione.

Il webhook risponde Invalid signature: la chiave di firma HMAC nelle impostazioni non corrisponde a quella del Web Admin di Datatrans, oppure appartiene all'altro ambiente. Copia di nuovo la chiave.

Il webhook risponde Not configured o Verification failed: il webhook doveva essere verificato tramite l'API di stato di Datatrans, ma mancano le credenziali di quell'ambiente, oppure Datatrans non ha risposto. Datatrans riprova il webhook.

Il webhook risponde Busy, retry: l'ordine era in fase di conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Datatrans riprova il webhook. Il registro mostra il motivo.

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

La chiave di firma HMAC non viene salvata: la chiave deve essere una stringa esadecimale. Copiala di nuovo dal Web Admin di Datatrans.

Il cliente vede Datatrans payments are not configured yet: manca il merchant ID o la password API dell'ambiente corrente.

Il cliente vede The payment could not be started: guarda il campo Log. Un merchant ID o una password API errati, oppure credenziali dell'ambiente sbagliato, sono le cause più comuni.

Il cliente vede We could not verify the payment: l'indirizzo di ritorno non corrispondeva a nessun tentativo di pagamento dell'ordine. Se il denaro è stato addebitato, il webhook imposta comunque lo stato dell'ordine.

L'ordine è nello stato di attesa dopo il pagamento: leggi le Datatrans notes nella scheda dell'ordine (vedi Stati degli ordini), poi evadi l'ordine oppure rimborsa il pagamento.

L'acquisizione viene rifiutata: il totale dell'ordine è più alto dell'importo autorizzato. Datatrans non può regolare più di quanto è stato autorizzato.

Nella scheda non ci sono pulsanti di acquisizione né modulo di rimborso: la scheda indica il motivo: il pagamento non è ancora regolato, è rimborsato interamente, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure mancano le credenziali dell'ambiente del pagamento.

Il rimborso o l'acquisizione fallisce con un messaggio sulle credenziali mancanti: il pagamento è stato effettuato nell'altro ambiente, e il suo merchant ID o la sua password API non sono impostati. Inseriscili e riprova.

Per gli sviluppatori: prima della creazione della transazione Datatrans, l'estensione attiva l'evento OpenCart datatrans_p_init_request con il corpo della richiesta e l'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Datatrans 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 i quattro stati degli ordini della sezione Payment processing, 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 azione di avvio, che lascia passare Datatrans in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del modulo (titolo, descrizione, modalità sandbox, credenziali, auto settle, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Le transazioni e i rimborsi di Datatrans vengono sempre mantenuti, quindi gli ordini pagati in precedenza possono essere rimborsati o acquisiti anche dopo una reinstallazione. Gli ordini esistenti conservano le loro 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 Datatrans Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

Datatrans è un marchio registrato del rispettivo proprietario. Questa estensione non è affiliata né approvata da Datatrans.