VibeFox Vindi for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Valuta: il real brasiliano (BRL) deve essere configurato in System > Localisation > Currencies. Vindi addebita solo in BRL, quindi il metodo di pagamento viene mostrato solo quando il cliente paga in BRL.

Account Vindi: ti serve la chiave API del tuo account Vindi. La sandbox di Vindi è un account di prova Vindi separato, con la propria chiave. Anche boleto, PIX e BolePix devono essere attivati nel tuo account Vindi se vuoi offrirli.

Chiave di licenza VibeFox: si acquista 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_vindi_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_vindi_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_vindi_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'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 Vindi 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 a matita) per aprire la pagina delle impostazioni. Inserisci 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. Incolla la Sandbox API key e, quando sei pronto, la Live API key. Scegli i Offered methods.

5. Copia l'URL del webhook dalle impostazioni in Vindi (vedi Configurazione).

6. Attiva Enable / Disable e clicca su Save. Prova un pagamento in modalità sandbox, poi disattiva Sandbox mode per accettare pagamenti reali.

OpenCart 4

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

4. Inserisci la chiave di licenza, le chiavi API, i metodi e il webhook come nei passaggi da 3 a 6 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'URL del webhook (vedi Webhook).

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra la modalità, TEST MODE oppure LIVE, e ti avvisa quando la chiave API della modalità corrente è vuota (il metodo di pagamento non viene mostrato al checkout) oppure quando la valuta predefinita del negozio non è BRL (il metodo di pagamento viene mostrato solo quando il cliente paga in BRL). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, le chiavi vengono salvate come digitate, senza spazi all'inizio e alla fine. Se non è selezionato alcun metodo di pagamento, viene salvata la carta di credito e la pagina mostra Choose at least one payment method — credit card was selected. Un Title vuoto o più lungo di 128 caratteri, un Sort Order che non è un numero intero (sono ammessi valori negativi), un Total che non è un numero maggiore o uguale a 0, oppure una zona geografica o uno stato ordine inesistente non vengono accettati: non viene salvato nulla e la pagina mostra il messaggio, per esempio Enter a title for the payment method (1 to 128 characters).

Vindi

Enable / Disable: Enable Vindi payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento mostrato al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Vindi. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra i campi di pagamento. Predefinito: Pay by credit card on the secure Vindi page, or by boleto / PIX.

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

Geo Zone: proponi Vindi 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 venga proposto Vindi. Lascia vuoto per proporre Vindi con qualsiasi totale.

Chiavi API

Crea le chiavi nel pannello di Vindi, in Settings > API keys: su app.vindi.com.br per il live e su sandbox-app.vindi.com.br per la sandbox. Live e sandbox hanno host e chiavi separati. Ogni pagamento ricorda dove è stata creata la sua fattura, quindi controlli, annullamenti e rimborsi usano sempre quell'ambiente.

Sandbox mode: crea i nuovi pagamenti nella sandbox di Vindi, usando sandbox-app.vindi.com.br con la chiave API della sandbox. Al checkout i clienti vedono una nota TEST MODE: Vindi sandbox: no real charges. Predefinito: attivo. Disattivalo per accettare pagamenti reali.

Live API key: la chiave privata dell'account Vindi live. Viene inviata solo all'API di Vindi.

Sandbox API key: la chiave privata dell'account sandbox di Vindi.

Le chiavi salvate non vengono mai più mostrate. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo per cambiarlo. Per rimuovere una chiave salvata, seleziona Clear the saved key on save sotto il campo e clicca su Save.

Metodi di pagamento

Offered methods: i metodi che i clienti possono scegliere. Predefinito: carta di credito. I metodi devono essere attivi anche nel tuo account Vindi.

Boleto, PIX e BolePix richiedono il CPF o il CNPJ del cliente, richiesto al checkout.

Notifiche di pagamento (webhook)

Il webhook comunica al tuo negozio che una fattura è stata pagata, annullata, rifiutata o rimborsata. Il campo Webhook URL di questa sezione mostra l'URL. Su OpenCart 3 ha questa forma: https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=..., su OpenCart 4 questa: https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=.... È costruito dall'indirizzo del negozio della tua installazione OpenCart e contiene un token segreto creato dall'estensione. Copialo esattamente come lo mostrano le impostazioni. In Vindi vai su Settings > Webhooks, sia nell'account live sia in quello sandbox, aggiungi questo URL e seleziona questi eventi:

Vindi non firma le sue notifiche, quindi le richieste con token mancante o errato vengono rifiutate, e ogni notifica fa solo rileggere la fattura tramite l'API di Vindi prima che un ordine cambi. L'URL funziona anche quando il negozio è in modalità manutenzione (su OpenCart 4 un'azione di avvio dell'estensione lascia passare il webhook e la pagina di stato del pagamento). Le fatture Vindi non hanno un URL di ritorno: senza il webhook, un pagamento con carta viene rilevato solo quando il cliente conferma di nuovo l'ordine con lo stesso carrello (la fattura pagata viene quindi trovata), e un pagamento con boleto o PIX quando il cliente apre di nuovo l'ordine nel proprio account (My Account > Order History).

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo che Vindi ha segnalato la fattura; la fattura viene sempre riletta da Vindi. Gli ordini con boleto, PIX e BolePix ricevono lo stato di attesa non appena la fattura viene emessa. Ogni campo qui sotto elenca i tuoi stati ordine OpenCart. OpenCart non ha lo stato In sospeso, quindi gli stati di attesa e di sospensione usano In attesa come predefinito; le note dell'ordine li distinguono. Puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui.

Order Status After Payment: impostato dopo un pagamento Vindi verificato. Predefinito: In lavorazione.

Awaiting Vindi Payment Status: boleto, PIX o BolePix emesso al checkout; Vindi conferma poi l'incasso. I dati del pagamento vengono aggiunti al commento della cronologia che il cliente vede. Predefinito: In attesa.

Vindi Payment On Hold Status: la fattura è in verifica presso Vindi, la fattura pagata non corrisponde all'ordine (valuta, importo, codice fattura o cliente Vindi), oppure è stata pagata dopo che l'ordine era stato annullato. Una nota spiega il motivo. Predefinito: In attesa.

Payment Error Status: Vindi ha rifiutato il tentativo di pagamento di un ordine in attesa. Il cliente può ancora pagare la stessa fattura; un pagamento successivo imposta lo stato dopo il pagamento. Predefinito: Fallito.

Canceled Status: la fattura di un ordine in attesa è stata annullata in Vindi. Quando imposti un ordine di questa estensione su questo stato, anche la sua fattura Vindi in attesa viene annullata. Predefinito: Annullato.

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

Avanzate

Debug log: registra chiamate API e notifiche in wc_vdi_debug.log.php, nella cartella dei log di OpenCart (storage/logs, su OpenCart 4 system/storage/logs). Il file non può essere aperto dal web. Errori e avvisi vengono sempre registrati, anche quando questa opzione è disattivata. Chiavi, token del webhook e dati dei clienti non vengono mai registrati. 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, il token del webhook, la cache dei prodotti e il registro. Gli ordini e i riferimenti alle fatture Vindi degli ordini vengono conservati. Predefinito: disattivato.

Import / Export

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

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Vindi). Nel passaggio Confirm Order il cliente vede la tua descrizione. Quando viene proposto più di un metodo, il riquadro di pagamento mostra Pay with e una scelta tra carta di credito, boleto, PIX o BolePix. Quando viene proposto boleto, PIX o BolePix, il riquadro ha anche un campo CPF or CNPJ. È obbligatorio quando non viene proposta la carta di credito; altrimenti mostra Required for boleto and PIX. Il campo viene compilato da un campo personalizzato del cliente o dall'indirizzo chiamato CPF o CNPJ quando contiene un numero valido. Il numero viene verificato con le sue cifre di controllo. Se manca qualcosa, il cliente vede Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. oppure Please enter your CPF or CNPJ — it is required for boleto and PIX. 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 riquadro di pagamento con questi campi e il pulsante Confirm Order si trovano in fondo alla pagina del checkout.

Quando il cliente clicca su Confirm Order, l'estensione crea per questo carrello un cliente Vindi a partire dall'indirizzo di pagamento e una fattura Vindi per il totale dell'ordine, in un'unica rata. In Vindi la fattura si chiama Order # seguito dal numero dell'ordine OpenCart.

Carta di credito: il cliente viene inviato alla pagina della fattura di Vindi e paga lì. L'ordine resta senza stato. Vindi non ha un URL di ritorno per le fatture, quindi il cliente non viene riportato automaticamente nel negozio. L'ordine riceve il suo stato quando Vindi conferma il pagamento tramite il webhook. Se il cliente conferma di nuovo l'ordine con lo stesso carrello e la fattura è già pagata, l'ordine pagato viene confermato e il cliente vede la pagina di successo.

Boleto, PIX e BolePix: la fattura viene emessa subito, l'ordine riceve lo stato di attesa e il cliente arriva alla pagina di successo dell'ordine di OpenCart. Lì, e nei dettagli dell'ordine nell'account del cliente, una sezione Payment mostra il codice QR PIX, il codice PIX di copia e incolla con un pulsante Copy code e la sua data di scadenza, e un pulsante Open boleto. L'e-mail dell'ordine e lo storico ordini del cliente contengono il codice PIX e il link del boleto. Se Vindi non restituisce i dati del boleto o del PIX, la fattura viene annullata e il cliente vede un errore.

L'ordine viene contrassegnato come pagato solo dopo la conferma di Vindi: l'estensione rilegge la fattura dall'API di Vindi e verifica la valuta, che la fattura appartenga all'ordine (codice fattura e cliente Vindi) e che l'importo pagato sia uguale al totale dell'ordine. La pagina di successo e la pagina dell'ordine nell'account del cliente ricontrollano tramite API un ordine in attesa, al massimo ogni 15 secondi. Quando il pagamento è stato ricevuto, la pagina di successo mostra Your payment with Vindi has been received. Finché il pagamento non è confermato mostra We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. Per un ordine annullato mostra This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid.

Finché il pagamento non è confermato, la pagina di successo e la pagina dell'ordine nell'account del cliente (per un ordine in attesa o sospeso) mostrano anche un pulsante Check payment status. Controlla l'ultima fattura Vindi dell'ordine. Un ordine confermato o in attesa torna alla pagina di successo con i suoi dati di pagamento. Se la fattura risulta ancora non pagata, la sezione Payment dice Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. e ha i pulsanti Pay at Vindi, Check again e Back to checkout.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 aggiorna l'ordine del checkout, quindi l'estensione paga ogni carrello una sola volta. Se un altro ordine dello stesso carrello è già pagato, in attesa di boleto o PIX, o sospeso, il cliente va alla pagina di successo e non viene emessa alcuna nuova fattura. Un nuovo tentativo per lo stesso ordine riutilizza la sua fattura Vindi in attesa se metodo, importo e ambiente sono gli stessi. Altrimenti la fattura precedente viene annullata in Vindi prima che se ne crei una nuova, così il cliente non può pagare due volte lo stesso carrello. Una modifica del carrello, incluso un nuovo quantitativo, conta come un nuovo carrello che richiede un pagamento proprio.

Su OpenCart 4 l'ordine resta nel checkout fino alla visualizzazione della pagina di successo. Dopo un pagamento con carta rifiutato o una fattura annullata, il cliente paga di nuovo lo stesso ordine. Se nel frattempo quell'ordine è stato chiuso senza pagamento, il cliente torna al checkout e il successivo Confirm Order paga un nuovo ordine: per un ordine annullato compare This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid., per un ordine fallito Your Vindi payment attempt was rejected. You can try again below. Su OpenCart 4 i messaggi della pagina di stato Payment che riportano al checkout vengono mostrati sopra la pagina del checkout.

Se Vindi non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio per controllare CPF / CNPJ, l'indirizzo di fatturazione (per il boleto sono obbligatori via, CAP, città e stato), l'e-mail o il numero di telefono, oppure che Vindi è temporaneamente non disponibile. Il motivo tecnico viene scritto nel registro.

L'estensione accetta pagamenti singoli in un'unica rata. Non prevede abbonamenti o addebiti ricorrenti, carte salvate, rate né un modulo carta sul tuo sito: la carta viene sempre inserita nella pagina di Vindi. Il numero civico e il quartiere non fanno parte dell'indirizzo OpenCart, quindi non vengono inviati a Vindi.

Ordini e rimborsi

Stati ordine

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

Awaiting Vindi Payment Status (predefinito In attesa): un pagamento con boleto, PIX o BolePix è in attesa. L'ordine passa a Order Status After Payment quando Vindi segnala la fattura come pagata.

Order Status After Payment (predefinito In lavorazione): il pagamento è stato confermato. L'ordine riceve il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino. Una nota mostra la fattura Vindi, l'importo e l'ambiente.

Vindi Payment On Hold Status (predefinito In attesa): la fattura Vindi è in verifica, la fattura pagata non corrisponde all'ordine (valuta, importo, codice fattura o cliente Vindi), oppure la fattura è stata pagata dopo che l'ordine era stato annullato. La nota lo spiega. Controlla l'ordine e il magazzino, poi completa l'ordine o rimborsa il pagamento.

Payment Error Status (predefinito Fallito): Vindi ha rifiutato il tentativo di pagamento di un ordine in attesa. La nota mostra il motivo comunicato dall'acquirente, se presente. Il cliente può ancora pagare la stessa fattura, e un pagamento successivo sposta l'ordine su Order Status After Payment.

Canceled Status (predefinito Annullato): la fattura di un ordine in attesa è stata annullata in Vindi. Quando imposti un ordine su questo stato in OpenCart, anche la sua fattura Vindi in attesa viene annullata, quindi non può più essere pagata. Se non è possibile, una nota ti chiede di annullare la fattura nel pannello di Vindi.

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

Se per un ordine già pagato, oppure per un altro ordine di un carrello già pagato, viene pagata una seconda fattura, l'ordine non viene modificato. Una nota sull'ordine pagato ti chiede di rimborsare un pagamento in Vindi. Le note sono voci della History dell'ordine che il cliente non vede.

Scheda VibeFox Vindi Gateway

In Sales > Orders apri un ordine pagato con Vindi. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Vindi Gateway mostra la Vindi bill, il Charge, l'ambiente (con un badge Sandbox per i pagamenti in sandbox), il Payment method, lo Status, gli importi Paid / refunded, il modulo di rimborso, lo storico dei rimborsi, tutte le Bills of this cart e le Vindi notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Vindi Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Vindi. Conferma la domanda Refund this amount through Vindi? This cannot be undone. Sono supportati rimborsi totali e parziali di pagamenti con carta e PIX. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi sono limitati all'importo effettivamente addebitato da Vindi, quindi dopo una differenza puoi rimborsare fino a quanto ha pagato il cliente, non fino al totale dell'ordine. Il rimborso viene inviato nell'ambiente del pagamento (live o sandbox), quindi la chiave API di quell'ambiente deve essere impostata.

Un rimborso totale annulla anche la fattura in Vindi e imposta l'ordine su Refunded Status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio manuale di stato. Un rimborso parziale non modifica lo stato. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note, con l'addebito Vindi e lo stato. Se Vindi o l'acquirente rifiutano il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. I rimborsi sono disponibili dopo che Vindi ha segnalato la fattura come pagata.

Vindi non può rimborsare i pagamenti con boleto. La scheda mostra Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually.

I resi di prodotti in Sales > Returns non rimandano denaro tramite Vindi. I rimborsi effettuati nel pannello di Vindi arrivano tramite il webhook charge_refunded e vengono aggiunti alle note. Lo stato dell'ordine non cambia automaticamente. Aggiornalo manualmente se necessario.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Vindi Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit, sopra le impostazioni. Inserisci 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 controllare 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-vindi 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 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 cambia l'indirizzo del negozio, o dopo che liberi 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 dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo posto dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Vindi non viene mostrato ai clienti al checkout. Se comunque un pagamento viene avviato, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore che è connesso al pannello 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 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: le fatture già create vengono comunque confermate dal webhook di Vindi, e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard dell'amministrazione o la pagina Edit: 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

Vindi non appare al checkout: controlla che la licenza sia attiva, che Enable / Disable sia attivo, che il cliente paghi in BRL, che almeno un metodo sia selezionato in Offered methods e che la modalità corrente abbia una chiave API: Sandbox API key in modalità sandbox, Live API key in modalità live. La pagina delle impostazioni mostra un avviso quando la chiave manca o la valuta del negozio non è BRL. Controlla 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 o nello stato di attesa: il webhook non funziona. In Vindi controlla che il webhook esista nell'account che usi (live o sandbox), che il suo URL sia esattamente quello mostrato nelle impostazioni, token compreso, e che siano selezionati tutti e quattro gli eventi.

Il webhook risponde Forbidden: il token nell'URL manca o è errato. Copia di nuovo l'URL dalle impostazioni.

Il webhook risponde Verification failed, retry later: non è stato possibile leggere la fattura dall'API di Vindi (per esempio è stata rimossa la chiave API di quell'ambiente), il carrello era in aggiornamento da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Vindi invierà di nuovo la notifica. Il registro mostra il motivo.

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

Il cliente vede This payment method is temporarily unavailable: Vindi ha rifiutato la chiave API. Controlla la chiave della modalità corrente.

Il cliente vede un errore dopo Confirm Order: guarda il campo Log nella pagina dell'estensione. Gli errori vengono registrati anche quando Debug log è disattivato. Per il boleto, l'indirizzo di fatturazione deve avere via, CAP, città e stato.

L'ordine è nello stato sospeso: leggi le note nella scheda VibeFox Vindi Gateway (vedi Stati ordine), poi completa l'ordine o rimborsa il pagamento.

Vecchi ordini sandbox dopo il passaggio al live: ogni pagamento conserva l'ambiente della sua fattura. Controlli, annullamenti e rimborsi degli ordini sandbox continuano a usare la chiave sandbox finché resta nelle impostazioni.

Il rimborso non riesce: leggi il messaggio. I pagamenti con boleto non possono essere rimborsati tramite Vindi, e la chiave API dell'ambiente del pagamento deve essere impostata. Senza il permesso di modificare l'estensione, la scheda dice You do not have permission to refund orders (modify this extension).

Per gli sviluppatori: prima della creazione del cliente e della fattura Vindi, l'estensione attiva gli eventi OpenCart wc_vdi_customer_request e wc_vdi_bill_request con i dati della richiesta e l'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Vindi Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le impostazioni proprie 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. Vengono rimossi anche gli eventi OpenCart dell'estensione (su OpenCart 4 anche la sua azione di avvio, che lascia passare il webhook e la pagina di stato del pagamento in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni (titolo, descrizione, modalità sandbox, chiavi API, metodi di pagamento, registrazione), il token del webhook, la cache dei prodotti e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Le fatture e i rimborsi Vindi degli ordini vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati 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 Vindi Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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