VibeFox Pin Payments for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Account Pin Payments: un account commerciante Pin Payments (per le aziende in Australia o Nuova Zelanda; i clienti possono pagare da qualsiasi paese). Ti servono la sua chiave pubblica (publishable key) e la sua chiave segreta (secret key), per il live e, per i test, per l'ambiente di test. Non serve alcun secret di webhook: l'estensione non usa webhook. I dati della carta vengono inviati dal browser del cliente direttamente a Pin Payments tramite Pin.js e non arrivano mai al tuo negozio, quindi il negozio rientra nel questionario PCI SAQ A-EP.

Valuta: AUD, USD, NZD, SGD, EUR, GBP, CAD, HKD, JPY, MYR, THB, PHP, ZAR o IDR. L'ordine viene addebitato nella sua valuta.

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

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Pin Payments 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 License key).

4. Nella dashboard di Pin Payments apri Account > API Keys e copia le tue chiavi di test in Test publishable key e Test secret key. Lascia attivo Test mode, attiva Enable/Disable e clicca su Save.

5. Effettua un ordine di prova con una carta di test di Pin Payments. Quando tutto funziona, inserisci le chiavi live, disattiva Test mode e salva.

OpenCart 4

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

4. Inserisci la chiave di licenza e le chiavi Pin Payments 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à di test attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Pin Payments Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra Pin Payments è in MODALITÀ DI TEST: vengono usate l'API e le chiavi di test, non vengono effettuati addebiti reali. mentre la modalità di test è attiva; un errore finché la publishable key o la secret key della modalità corrente è vuota (il metodo di pagamento resta nascosto nel checkout); e un errore quando Pin Payments non supporta la valuta predefinita del negozio (con l'elenco delle valute supportate). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, se un campo non è corretto non viene salvato nulla: Title non può essere vuoto (Inserisci un titolo per il metodo di pagamento (massimo 128 caratteri).), Sort Order deve essere un numero intero (sono ammessi valori negativi), Total un numero maggiore o uguale a 0, e Geo Zone e gli stati dell'ordine devono esistere.

Pin Payments

Enable/Disable: Enable Pin Payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che il cliente vede nel checkout. È anche il nome del metodo di pagamento memorizzato nell'ordine. Predefinito: Credit card (Pin Payments). Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il modulo della carta. Predefinito: Pay with your credit card via Pin Payments.

Sort Order: la posizione di Pin Payments tra i metodi di pagamento nel checkout. Lascia 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 carrello, nella valuta predefinita del negozio, che un ordine deve raggiungere perché il metodo di pagamento venga offerto. Lascia vuoto per offrirlo per qualsiasi totale.

Chiavi API

Trovi le chiavi nella dashboard di Pin Payments (la pagina rimanda a dashboard.pinpayments.com) in Account > API Keys. Le chiavi di test funzionano solo con l'API di test, le chiavi live solo con l'API live. La chiave pubblica viene usata da Pin.js nel browser del cliente. La chiave segreta non lascia mai il tuo server.

Test mode: usa l'ambiente di test di Pin Payments (test-api.pinpayments.com) e le chiavi di test. Non vengono effettuati addebiti reali e i clienti vedono MODALITÀ DI TEST — non verrà effettuato alcun addebito reale. sopra il modulo della carta. Quando è disattivata, vengono usate l'API live e le chiavi live. I rimborsi di un ordine usano sempre le chiavi dell'ambiente in cui l'ordine è stato pagato. Predefinito: attiva.

Test publishable key: la chiave pubblica del tuo account di test di Pin Payments.

Test secret key: la chiave segreta del tuo account di test di Pin Payments.

Live publishable key: la chiave pubblica del tuo account live di Pin Payments.

Live secret key: la chiave segreta del tuo account live di Pin Payments.

Gli spazi attorno alle chiavi vengono rimossi. Le chiavi segrete salvate non vengono mai mostrate di nuovo. Il campo resta vuoto e mostra Salvato — lascia vuoto per conservarlo. Inserisci un nuovo valore solo se vuoi modificarlo. Per rimuovere una chiave segreta salvata, spunta Clear the saved value on save sotto il campo e clicca su Save.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (ordine mancante). L'ordine riceve uno stato solo dopo che Pin Payments ha risposto all'addebito. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: la carta è stata addebitata esattamente per l'importo e la valuta dell'ordine. Predefinito: Processing.

On Hold (Review) Status: l'importo o la valuta addebitati differiscono dall'ordine, l'addebito è autorizzato ma non acquisito, oppure Pin Payments non ha dato una risposta chiara (timeout, errore del server), quindi un addebito potrebbe esistere. Una nota ti indica cosa controllare nella dashboard di Pin Payments. Predefinito: Pending, perché OpenCart non ha uno stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Refunded Status: impostato dopo che il pagamento è stato rimborsato interamente dalla scheda dell'ordine. Predefinito: Refunded.

Avanzate

Debug log: scrive le chiamate API di Pin Payments in wc_ppg_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_ppg_debug.old.log.php. Errori e avvisi vengono sempre registrati; attiva questa opzione per registrare anche ogni chiamata API. Dati della carta, chiavi API e dati personali dei clienti non vengono mai registrati. Predefinito: disattivato.

Log: mostra la dimensione e le voci più recenti 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 log. I dati di pagamento degli ordini (addebiti e rimborsi) 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 il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Le chiavi segrete salvate vengono mantenute.

Checkout

Il metodo di pagamento viene mostrato quando è attivo, entrambe le chiavi della modalità corrente sono impostate, la valuta dell'ordine è una delle 14 valute supportate, l'indirizzo di pagamento rientra nella Geo Zone selezionata e l'ordine raggiunge il Total.

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit card (Pin Payments)). OpenCart crea l'ordine nel passaggio Confirm Order, ancora senza stato. Lì il cliente vede la tua descrizione, le icone di Visa, Mastercard e American Express e il modulo della carta: Card number, Expiry (MM / YY), CVC e Name on card. 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 in fondo alla pagina del checkout, sopra il pulsante Confirm Order. Prima dell'invio, il modulo controlla la lunghezza del numero della carta, il mese e l'anno di scadenza, un CVC di 3 o 4 cifre e il nome.

Quando il cliente clicca su Confirm Order, Pin.js invia dal browser i dati della carta e l'indirizzo di pagamento dell'ordine (su OpenCart 4, se il checkout non richiede un indirizzo di pagamento, quello di spedizione) direttamente a Pin Payments e ottiene un token della carta monouso. Solo questo token arriva al tuo negozio. L'estensione crea quindi un addebito acquisito per il totale dell'ordine nella valuta dell'ordine, con l'e-mail e l'indirizzo IP del cliente e la descrizione <store name> - Order <order number>. Pin Payments risponde nella stessa richiesta.

Dopo un addebito riuscito, l'ordine riceve il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento delle scorte; il carrello viene svuotato e il cliente vede la pagina di conferma ordine di OpenCart con Your card payment has been received. Se l'ordine è passato allo stato di verifica, la pagina mostra Il tuo pagamento con carta è stato ricevuto ed è in fase di verifica. Aggiorneremo il tuo ordine non appena la verifica sarà completata.

Se Pin Payments non risponde (timeout, errore del server, risposta illeggibile), un addebito potrebbe essere stato comunque creato. L'ordine passa allora allo stato di verifica con una nota, e la pagina di conferma mostra Non siamo riusciti a confermare il tuo pagamento con Pin Payments. Controlla la tua e-mail e l'estratto conto della carta prima di pagare di nuovo, oppure contattaci. Inviare di nuovo lo stesso carrello non crea mai un secondo addebito.

Viene eseguito un solo tentativo di pagamento per carrello alla volta. Un secondo invio riceve Questo ordine è già in fase di pagamento. Attendi un momento e controlla la tua e-mail prima di riprovare. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 aggiorna l'ordine del checkout (dopo un rifiuto della carta il cliente paga lo stesso ordine), quindi un carrello già pagato con un altro ordine va direttamente alla pagina di conferma, e un tentativo precedente che ha addebitato o potrebbe aver addebitato denaro assegna il suo stato all'ordine invece di creare un nuovo addebito. Un token della carta può essere usato una sola volta: dopo un tentativo non riuscito, o quando il cliente cambia i dati della carta, viene creato un nuovo token.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di conferma. Se quell'ordine ha già uno stato quando il cliente conferma un nuovo acquisto (per esempio è stato pagato e la pagina di conferma non è mai stata aperta, oppure l'hai annullato), il cliente torna al checkout e il successivo clic su Confirm Order paga un nuovo ordine del carrello attuale. Sopra la pagina del checkout il cliente vede Il tuo ordine precedente è stato annullato o rimborsato dal negozio. Conferma di nuovo l'ordine per pagare con un nuovo ordine. se l'ordine era chiuso, oppure Il tuo ordine precedente #(number) è già stato effettuato. Il carrello è cambiato: conferma il nuovo ordine per pagarlo. se era stato creato per un carrello precedente. Un ordine pagato non viene mai mostrato come pagato per un carrello diverso.

Quando il pagamento non riesce, l'ordine resta senza stato. Il cliente rimane nel passaggio Confirm Order, il carrello viene conservato e sopra il modulo della carta compare uno di questi messaggi: La tua carta è stata rifiutata. Usa un'altra carta o contatta la tua banca.; La tua carta non ha fondi sufficienti. Usa un'altra carta.; La tua carta è scaduta. Usa un'altra carta.; Il codice di sicurezza della carta (CVC) non è corretto.; Questo tipo di carta non è accettato. Usa Visa, Mastercard o American Express.; Pagamento non riuscito: con il motivo di Pin Payments per i dati rifiutati; I dati della tua carta sono scaduti. Inseriscili di nuovo e riprova. quando il token non può essere usato; Impossibile caricare il modulo sicuro della carta. Ricarica la pagina o scegli un altro metodo di pagamento. quando Pin.js non si carica; I pagamenti con carta non sono disponibili temporaneamente. Riprova più tardi o scegli un altro metodo di pagamento. quando Pin Payments rifiuta la chiave segreta; Impossibile elaborare il pagamento. Riprova o scegli un altro metodo di pagamento. per altri errori. Il motivo tecnico viene scritto nel log.

L'estensione non prevede un flusso 3-D Secure. Se il tuo account Pin Payments richiede il 3-D Secure, l'addebito resta in sospeso, l'ordine non riceve alcuno stato e il cliente vede Impossibile completare il pagamento con carta (è richiesta un'ulteriore verifica). Prova un'altra carta o un altro metodo di pagamento. Non esistono una modalità di sola autorizzazione con acquisizione successiva, carte salvate, abbonamenti, Apple Pay o Google Pay, né webhook.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): la carta è stata rifiutata, l'addebito richiedeva il 3-D Secure, oppure il cliente non ha pagato. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (predefinito Processing): Pin Payments ha segnalato un addebito riuscito e acquisito per esattamente l'importo e la valuta dell'ordine. Una nota mostra l'importo e il token dell'addebito (e MODALITÀ DI TEST per i pagamenti di prova).

On Hold (Review) Status (predefinito Pending): l'addebito richiede una tua verifica. La nota spiega il motivo: Pin Payments ha addebitato un importo o una valuta diversi dall'ordine, l'addebito è autorizzato ma non acquisito (acquisiscilo nella dashboard di Pin Payments, poi cambia lo stato dell'ordine), oppure Pin Payments non ha dato una risposta chiara (cerca la descrizione dell'addebito nella dashboard di Pin Payments prima della spedizione dell'ordine).

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

Se per un carrello già pagato viene effettuato un secondo addebito, l'ordine pagato non cambia. Una nota ti chiede di verificarlo e rimborsarlo nella dashboard di Pin Payments.

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

VibeFox Pin Payments Gateway tab

In Sales > Orders apri un ordine pagato con Pin Payments. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Pin Payments Gateway mostra il token dell'addebito (Charge) con l'etichetta Test per i pagamenti di prova, lo Status, il marchio della Card e le ultime quattro cifre, gli importi Charged / order / refunded (addebitato / ordine / rimborsato), la Charge description, il modulo di rimborso, lo storico dei rimborsi e le Pin Payments notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Pin Payments Gateway inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Pin Payments. Conferma la domanda Rimborsare questo importo tramite Pin Payments? Questa operazione non può essere annullata. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi sono limitati all'importo e alla valuta effettivamente addebitati da Pin Payments, quindi dopo una differenza di importo o valuta puoi rimborsare fino a quanto ha pagato il cliente, non il totale dell'ordine. Il rimborso viene inviato all'ambiente (test o live) in cui l'ordine è stato pagato, quindi la secret key di quella modalità deve essere impostata. Pin Payments elabora i rimborsi in modo asincrono, quindi lo stato è di solito Pending. Una richiesta riuscita viene aggiunta allo storico dei rimborsi e alle note, con il token di rimborso di Pin Payments e il suo stato. Un rimborso totale imposta l'ordine al Refunded Status senza avvisare il cliente e senza riportare i prodotti a magazzino, come un cambio manuale di stato. Un rimborso parziale non cambia lo stato. Se Pin Payments rifiuta il rimborso o non risponde, la scheda mostra l'errore e non viene registrato alcun rimborso.

Quando per l'ordine non è registrato alcun addebito (Pin Payments non ha dato una risposta chiara), la scheda non mostra il modulo di rimborso e ti indica quale descrizione cercare nella dashboard di Pin Payments.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Pin Payments. I rimborsi effettuati nella dashboard di Pin Payments non vengono sincronizzati con OpenCart, quindi effettuali dalla pagina dell'ordine.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Pin Payments Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Pin Payments 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 è valida 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-pinpayments 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 sull'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 oppure License expired on seguito da una data. Dopo aver cambiato l'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 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, Pin Payments non viene mostrato ai clienti nel checkout. Se un pagamento viene avviato comunque, il cliente vede Questo metodo di pagamento non è disponibile. Scegline un altro. Un utente amministratore che ha effettuato l'accesso all'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato come (senza licenza — visibile solo agli amministratori), 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 rimborsi degli ordini pagati in precedenza continuano a funzionare.

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

Pin Payments non compare nel checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che entrambe le chiavi della modalità corrente siano inserite (Test publishable key e Test secret key in modalità di test, altrimenti le chiavi live) e che la valuta dell'ordine sia una delle 14 valute supportate. Controlla anche che l'indirizzo di pagamento rientri nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni. La pagina delle impostazioni mostra un errore per le chiavi mancanti e per una valuta del negozio non supportata.

Il pagamento è andato a buon fine, ma l'ordine è nello stato di verifica: leggi le note nella scheda VibeFox Pin Payments Gateway (vedi Stati dell'ordine). Se Pin Payments non ha dato una risposta chiara, cerca nella dashboard di Pin Payments un addebito con la descrizione <store name> - Order <order number>, poi evadi l'ordine o rimborsa l'addebito nella dashboard.

Il cliente vede il messaggio «Your payment was received, but the order could not be completed automatically»: la carta è stata addebitata, ma non è stato possibile impostare lo stato dell'ordine (per esempio perché nel frattempo l'ordine è stato eliminato). Il motivo è nel log. Al cliente viene chiesto di non pagare di nuovo; inviare di nuovo lo stesso carrello assegna lo stato all'ordine senza un nuovo addebito.

Il cliente vede il messaggio «This payment method is not available. Please reload the checkout page.»: la sessione di checkout non corrisponde più all'ordine, oppure il metodo di pagamento è stato disattivato nel frattempo. Il cliente ricarica il checkout.

I clienti vedono il messaggio «Card payments are temporarily unavailable»: Pin Payments ha rifiutato la chiave segreta, oppure manca la chiave della modalità corrente. Le chiavi di test funzionano solo in modalità di test, le chiavi live solo in modalità live. Il log mostra il motivo.

Gli ordini falliscono con il messaggio «additional verification is required»: il tuo account Pin Payments richiede il 3-D Secure, che l'estensione non supporta. Chiedi a Pin Payments di disattivare l'obbligatorietà del 3-D Secure.

Impossibile caricare il modulo sicuro della carta: Pin.js dalla CDN di Pin Payments non si è caricato nel browser, per esempio a causa di un blocco degli script o di un'estensione che combina o modifica gli script. Escludi il checkout da tali ottimizzazioni.

Pin Payments non ha risposto: il token della carta non è stato creato nel browser entro 30 secondi. Il cliente può controllare la connessione e riprovare; non è stato addebitato nulla.

Pagamento non riuscito con un motivo di Pin Payments: Pin Payments ha rifiutato i dati dell'addebito, per esempio un importo inferiore al suo addebito minimo per la valuta. Il cliente vede il motivo, e il log contiene il codice di errore.

Il rimborso non riesce: leggi il messaggio nella scheda. Un messaggio su modalità TEST o LIVE indica che la secret key della modalità in cui è stato pagato l'ordine è vuota. Pin Payments did not confirm the refund significa che non è arrivata alcuna risposta; controlla l'addebito nella dashboard di Pin Payments prima di riprovare. at most indica l'importo ancora rimborsabile dall'addebito.

Pagamenti di prova: la modalità di test usa l'ambiente di test e le chiavi di test. Usa le carte di test della documentazione per sviluppatori di Pin Payments, per esempio 4200 0000 0000 0000 (riuscito), con una data di scadenza futura qualsiasi e un CVC qualsiasi. Gli ordini mantengono la modalità in cui sono stati pagati, quindi i rimborsi vanno all'ambiente giusto anche dopo un cambio di modalità.

Dove trovare gli errori: gli errori vengono sempre scritti nel log; vedi il campo Log nella pagina dell'estensione. Attiva Debug log per vedere ogni chiamata API.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Pin Payments 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 Ordini, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 vengono rimossi anche i suoi due eventi, che mostrano i messaggi sulla pagina di conferma e sopra la pagina del checkout). Se Delete data on uninstall è attivo, vengono rimosse anche le altre impostazioni del gateway (titolo, descrizione, modalità di test, chiavi, interruttore del debug log) e il log. Se è disattivato, vengono conservate per una reinstallazione successiva. Gli addebiti e i rimborsi di Pin Payments vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti mantengono le 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 Pin Payments Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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