VibeFox Tap for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Valuta dell'ordine: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR o USD. Per gli ordini in altre valute il metodo di pagamento non viene mostrato al checkout.

Accesso a Internet per il tuo negozio: Tap invia il risultato del pagamento a un webhook del tuo negozio, quindi il sito deve essere raggiungibile da Internet. L'URL del webhook viene inviato con ogni pagamento; non occorre configurare nulla nella dashboard di Tap.

Account Tap: ti servono le chiavi API della tua dashboard Tap (goSell, credenziali API). Le chiavi di test iniziano con pk_test_ / sk_test_, quelle live con pk_live_ / sk_live_. La chiave segreta serve sempre; la chiave pubblicabile solo per il popup del checkout. I metodi di pagamento offerti (mada, KNET, Benefit e altri) e la verifica del dominio per Apple Pay si configurano nel tuo account Tap.

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_tap_payment_gateway-oc3-(versione).ocmod.zip e il pacchetto per OpenCart 4 wcp_tap_payment_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. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_tap_payment_gateway-oc3-(versione).ocmod.zip. L'estensione non contiene modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'installer puoi anche copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Tap Payments 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 chiavi Tap di test e live, scegli l'azione di pagamento, il tipo di checkout e la lingua della pagina Tap (vedi Configurazione).

5. Attiva Enable / Disable e clicca su Save. Prova con le carte di test Tap, poi disattiva Test mode.

OpenCart 4

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

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

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

4. Inserisci la chiave di licenza, le chiavi Tap e le opzioni di pagamento come nei passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni.

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Tap Payments > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra Test mode is on: payments use your Tap test keys and no real money is charged. oppure Live mode: real payments are accepted. Avvisa anche quando mancano le chiavi della modalità attuale (il metodo di pagamento non viene allora mostrato al checkout) e quando la valuta predefinita del negozio non è offerta con Tap. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto né superare 128 caratteri, Sort Order deve essere un numero intero (sono ammessi valori negativi), Total deve essere un numero pari o maggiore di 0 e gli stati dell'ordine devono esistere; altrimenti non viene salvato nulla. Una chiave con il prefisso sbagliato per il suo campo non viene salvata: resta il valore precedente, le altre impostazioni vengono salvate e compare un messaggio come Test secret key was not saved: a Tap key for this field starts with "sk_test_".. Per esempio, una chiave live in un campo di test viene rifiutata.

Tap Payments

Enable / Disable: Enable Tap Payments 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: Tap Payments. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Sort Order: la posizione di Tap tra i metodi di pagamento al checkout. Lascialo vuoto o inserisci un numero intero (sono ammessi valori negativi).

Geo Zone: offri Tap 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 Tap venga offerto. Lascialo vuoto per offrire Tap per qualsiasi totale.

Chiavi API Tap

Trova le chiavi nella dashboard Tap (goSell, credenziali API). La sezione rimanda alla documentazione per sviluppatori di Tap.

Test mode: usa le chiavi di test, non viene addebitato denaro reale. Pagamenti, verifiche dello stato, acquisizioni e rimborsi usano sempre le chiavi della modalità in cui il pagamento è stato effettuato, quindi un pagamento di test viene ancora verificato e rimborsato con la chiave di test anche dopo il passaggio a live. Predefinito: attivo. Finché è attivo, i clienti vedono Test mode: no real payment will be made. al passaggio Confirm Order e nella pagina di pagamento del popup.

Test publishable key: inizia con pk_test_. Necessaria per il popup.

Test secret key: inizia con sk_test_.

Live publishable key: inizia con pk_live_. Necessaria per il popup.

Live secret key: inizia con sk_live_.

Merchant ID: facoltativo. Il tuo ID commerciante Tap; serve solo se Tap ti ha chiesto di indirizzare i pagamenti a un account commerciante specifico.

Le chiavi segrete salvate non vengono mai mostrate di nuovo. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere una chiave salvata, spunta Clear the saved value sotto il campo e clicca su Save. Le chiavi pubblicabili sono pubbliche e restano visibili.

Pagamento

Payment action: cosa succede al denaro quando il cliente paga.

Checkout type: dove paga il cliente.

Tap page language: lingua della pagina di pagamento Tap e del popup: English (predefinito) oppure Arabic.

Notifiche di pagamento (webhook)

Tap invia il risultato del pagamento all'URL mostrato in Webhook URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook, su OpenCart 4 quello: https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. L'URL viene inviato con ogni pagamento, quindi non occorre configurare nulla nella dashboard di Tap. Assicurati solo che sia raggiungibile da Internet (non bloccato da un firewall o da un'autenticazione HTTP); la modalità manutenzione non lo blocca (su OpenCart 4 un'azione di avvio dell'estensione lascia passare il webhook e il ritorno del cliente). Ogni notifica viene verificata con la firma hashstring (HMAC-SHA256 con la chiave segreta della modalità in cui il pagamento è stato effettuato). I webhook senza una firma valida vengono rifiutati. Anche una notifica firmata non è considerata attendibile di per sé: l'estensione rilegge il pagamento dalle API Tap prima di modificare l'ordine. Senza un webhook funzionante, l'ordine riceve il suo stato solo quando il cliente torna nel negozio dopo aver pagato.

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Tap ha confermato il pagamento tramite API. Ciascun campo sotto elenca i tuoi stati ordine di OpenCart.

Paid Order Status: lo stato dopo un pagamento acquisito. Predefinito: In lavorazione.

Authorized Status: Authorize only: i fondi sono riservati, non ancora acquisiti. Predefinito: In attesa.

On Hold (Review) Status: il pagamento richiede la tua verifica (vedi Stati dell'ordine). Predefinito: In attesa, perché OpenCart non ha lo stato In sospeso. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Voided Status: impostato dopo che Void Tap authorization ha rilasciato i fondi riservati. Predefinito: Annullato.

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

Avanzate

Debug log: scrive gli eventi di pagamento in tap_p_debug.log.php nella cartella dei log di OpenCart (storage/logs, su OpenCart 4 system/storage/logs). Il file non può essere letto dal web e, al raggiungimento di 5 MB, viene spostato in tap_p_debug.old.log.php. Errori e avvisi vengono sempre registrati; attiva questa opzione per registrare anche ogni evento di pagamento. Il registro non contiene mai chiavi, dati della carta o dei clienti. 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 degli ordini vengono sempre conservati. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Le chiavi segrete 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

Al passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Tap Payments). Al passaggio Confirm Order il cliente vede la tua descrizione. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Poi il cliente clicca su Confirm Order. 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.

Tap payment page: l'estensione crea un addebito Tap (oppure un'autorizzazione in modalità Authorize only) per il totale dell'ordine nella valuta dell'ordine, con la descrizione Order # e il numero dell'ordine, e invia il cliente alla pagina di pagamento Tap. Nome, e-mail e telefono del cliente vengono passati a Tap. Lì il cliente sceglie una carta, mada, KNET, Benefit, Apple Pay o Google Pay (come attivati nel tuo account Tap) e paga. Se Tap non può avviare il pagamento, il cliente resta al passaggio Confirm Order con The Tap payment could not be started. Please try again or choose another payment method. e il motivo viene scritto nel registro.

Tap checkout popup: il cliente va alla pagina Tap payment dell'estensione, dove si apre il modulo di pagamento Tap. La pagina mostra anche il collegamento Pay on the Tap payment page instead. Se la finestra viene chiusa, il pulsante Pay now la riapre. Se il modulo non può essere caricato, al cliente viene chiesto di usare la pagina di pagamento Tap. Ricaricare la pagina riutilizza lo stesso tentativo di pagamento.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando Tap lo conferma: l'estensione rilegge il pagamento dalle API Tap con la chiave della modalità del pagamento, verifica che si riferisca a questo ordine e che sia stato avviato dal suo checkout, e confronta importo e valuta con l'ordine. Il solo ID Tap nell'indirizzo di ritorno non modifica mai l'ordine. Il webhook esegue lo stesso controllo in background. L'ordine riceve poi 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 conferma ordine di OpenCart. Su OpenCart 4, quando il cliente torna dalla pagina di pagamento Tap, una pagina intermedia riapre l'indirizzo di ritorno nel tuo negozio, così il carrello e l'accesso del cliente vengono mantenuti. Per un pagamento autorizzato la pagina mostra inoltre Your payment has been authorized. We will process the order as soon as the payment is captured. Per un pagamento in verifica mostra Your payment is being reviewed. We will contact you if anything else is needed.

Se Tap non ha ancora confermato il pagamento quando il cliente torna, una pagina Payment confirmation mostra We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. con i pulsanti Check again e Back to checkout. Il webhook imposta lo stato dell'ordine non appena arriva.

Se il pagamento è stato rifiutato, abbandonato o annullato, l'ordine resta senza stato. Il cliente torna al checkout con Your payment was not completed. Please try again or choose another payment method. (con il motivo di Tap, quando Tap ne fornisce uno). Un pagamento non completato mostra The payment was not completed. You can try again or choose another payment method. Il carrello viene conservato e può essere pagato di nuovo. Su OpenCart 4 questi messaggi compaiono sopra la pagina del checkout.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout. Se un altro ordine dello stesso carrello è già stato pagato, il cliente va direttamente alla pagina di successo invece di pagare di nuovo. Prima di avviare un nuovo pagamento, le pagine di pagamento Tap aperte per l'ordine e per il carrello delle ultime 24 ore vengono verificate presso Tap, così un pagamento effettuato in un'altra scheda viene confermato invece di addebitare due volte. Una modifica del carrello, inclusa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Dopo un pagamento rifiutato o annullato, il successivo Confirm Order avvia un nuovo pagamento Tap per lo stesso ordine. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio lo hai annullato o la sua autorizzazione è stata annullata), 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., e il successivo Confirm Order paga un nuovo ordine.

Altri messaggi al checkout: Tap does not accept payments in seguito dalla valuta, quando la valuta dell'ordine non è supportata, e The order total must be greater than zero to pay with Tap.

L'estensione non prevede carte salvate né tokenizzazione, né abbonamenti, né campi carta incorporati nella pagina di checkout. Capture Tap payment acquisisce sempre il totale dell'ordine; l'acquisizione parziale non è supportata.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Tap e non ha pagato, oppure Tap non ha ancora confermato il pagamento. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders. Su OpenCart 4.1 un ordine così può anche avere lo stato Voided, che OpenCart imposta quando viene mostrato di nuovo il passaggio di conferma; l'estensione lo considera un ordine senza stato.

Paid Order Status (default Processing): Tap ha confermato un pagamento acquisito. Una nota mostra l'importo, l'ID dell'addebito Tap (chg_...), il metodo di pagamento e (in modalità test) per i pagamenti di prova.

Authorized Status (default Pending): il pagamento è stato solo autorizzato e attende acquisizione o annullamento.

On Hold (Review) Status (default Pending): l'importo o la valuta pagati non corrispondevano all'ordine (Tap: amount/currency mismatch — manual review required.), oppure un pagamento è arrivato dopo che l'ordine era stato annullato. La nota lo spiega. Controlla l'ordine ed evadilo, oppure rimborsa il pagamento.

Voided Status (default Canceled): l'autorizzazione è stata annullata con Void Tap authorization, quindi i fondi riservati sono stati rilasciati.

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

Un tentativo fallito non modifica mai un ordine che ha già uno stato. Se per un ordine già pagato arriva un secondo pagamento riuscito, l'ordine non viene modificato. Una nota indica che si tratta di un pagamento duplicato e ti chiede di rimborsarlo nella dashboard di Tap. Un pagamento per un altro ordine di un carrello già pagato lascia quell'ordine senza stato ed è annotato sull'ordine pagato. Un pagamento che si riferisce all'ordine ma non è stato avviato dal suo checkout viene solo annotato.

Le note sono voci della History dell'ordine che il cliente non vede. Iniziano con "Tap".

Scheda VibeFox Tap Payments

In Sales > Orders apri un ordine pagato con Tap. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Tap Payments mostra il Tap ID, l'Authorization e il Charge, il Mode (un'etichetta Test per i pagamenti di prova), lo Status del pagamento e il metodo, Charged / refunded, il modulo di rimborso, lo storico dei rimborsi, i Payment attempts dell'ordine e le Tap notes. La scheda viene mostrata agli utenti che hanno accesso all'estensione; acquisizione, annullamento e rimborsi richiedono il permesso di modificare l'estensione (impostato in System > Users > User Groups).

Acquisizione e annullamento

In modalità Authorize only, apri l'ordine autorizzato. Capture Tap payment (con il totale dell'ordine sul pulsante) acquisisce il totale dell'ordine dopo la domanda Capture the reserved funds of this order through Tap?; l'ordine riceve poi il Paid Order Status. Void Tap authorization chiede Release the reserved funds? The order will be canceled., rilascia i fondi e imposta il Voided Status. Un secondo clic su acquisisci entro 2 minuti viene bloccato. Se Tap rifiuta l'azione, nella scheda compare un errore e viene aggiunto alle note. Questi cambi di stato avvengono senza notificare il cliente e senza modificare le scorte, come un cambio di stato manuale. Se un'autorizzazione viene acquisita direttamente nella dashboard di Tap, il webhook segna l'ordine come pagato; i rimborsi per tale pagamento devono essere eseguiti nella dashboard di Tap.

Rimborsi

Nella scheda inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Tap. Conferma la domanda Refund this amount through Tap? This cannot be undone. Sono supportati rimborsi totali e parziali per addebiti Tap acquisiti. Puoi rimborsare fino all'importo e alla valuta effettivamente addebitati da Tap, anche se l'ordine è stato modificato in seguito. Il rimborso viene inviato con la chiave segreta della modalità in cui il pagamento è stato effettuato, quindi quella chiave deve essere impostata. Un rimborso accettato da Tap viene aggiunto allo storico dei rimborsi e alle note con l'ID e lo stato del rimborso Tap. Se Tap lo rifiuta, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso totale imposta il Refunded Status senza notificare il cliente e senza restituire i prodotti alle scorte; un rimborso parziale non cambia lo stato. Per un ordine autorizzato i rimborsi sono disponibili solo dopo l'acquisizione dell'autorizzazione. Un ordine in verifica dopo una differenza di importo o valuta si rimborsa nella dashboard di Tap.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Tap. I rimborsi eseguiti nella dashboard di Tap non compaiono in OpenCart.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox Tap Payments è il primo blocco di Extensions > Extensions > Payments > VibeFox Tap Payments > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo, 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-tap 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 sull'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 o License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato un posto 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 posto dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Tap Payments 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 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 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 rimborsi, acquisizione e annullamento 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 per i 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

Tap Payments non compare al checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo e che la modalità attuale abbia una chiave segreta (e una chiave pubblicabile quando Checkout type è il popup). Verifica che la valuta dell'ordine sia una tra AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD, che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni. La pagina delle impostazioni mostra un avviso per le chiavi mancanti e per una valuta del negozio non supportata.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: il webhook non riesce a raggiungere il tuo negozio. Verifica che l'URL mostrato in Webhook URL sia raggiungibile da Internet (nessun firewall né autenticazione HTTP) e attiva Debug log per vedere le risposte nel campo Log. L'ordine riceve comunque il suo stato quando il cliente torna da Tap.

Webhook answers invalid signature: la notifica non è stata firmata con la chiave segreta della modalità del pagamento. Verifica le chiavi segrete nelle impostazioni.

Webhook answers gateway not configured: la chiave segreta della modalità del pagamento (test o live) è vuota. Inseriscila.

Webhook answers verification failed: non è stato possibile raggiungere le API Tap per verificare il pagamento. Tap riproverà il webhook più tardi.

Webhook answers order not found: la notifica indica un ordine che non ha alcun tentativo di pagamento Tap in questo negozio.

Webhook answers busy, retry later or order could not be updated, retry later: l'ordine era in conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Tap riproverà il webhook. Controlla il campo Log per il motivo.

Una chiave non viene salvata: la chiave deve iniziare con il prefisso del suo campo: pk_test_, sk_test_, pk_live_ o sk_live_.

Il cliente vede The Tap payment could not be started: consulta il campo Log nella pagina dell'estensione. Lì viene registrata una chiave errata o una richiesta rifiutata.

Il cliente vede This payment method is not available: la sessione di checkout non corrisponde più all'ordine, oppure il metodo di pagamento è stato disattivato o ha perso le chiavi nel frattempo. Il cliente ricarica il checkout.

Il cliente vede We could not match this payment to an order: il pagamento non appartiene a questo ordine o non è stato avviato dal suo checkout. Se il denaro è stato addebitato, verifica il pagamento nella dashboard di Tap.

L'ordine è nello stato di verifica: leggi le note nella scheda VibeFox Tap Payments. L'importo o la valuta pagati non corrispondevano all'ordine, oppure il pagamento è arrivato dopo che l'ordine era stato annullato.

Il rimborso fallisce con un messaggio sulla modalità: il pagamento è stato effettuato in modalità test o live, e per quella modalità non è configurata alcuna chiave segreta. Inseriscila e riprova. Se la scheda indica che non è stato trovato alcun addebito Tap acquisito, rimborsa il pagamento nella dashboard di Tap.

Per gli sviluppatori: gli eventi OpenCart tap_p_charge_payload, tap_p_supported_currencies e tap_p_currency_decimals permettono di modificare la richiesta di pagamento, le valute supportate e i decimali delle valute.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Tap Payments. 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 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 lascia passare il webhook e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, chiavi, opzioni di pagamento, interruttore del registro di debug) e il registro. Se è disattivo, restano conservate per una reinstallazione successiva. I tentativi di pagamento Tap e i rimborsi vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano 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 Tap Payments nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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