VibeFox Iugu for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Valuta: real brasiliano (BRL). Iugu incassa solo in BRL, quindi il negozio deve avere la valuta BRL in System > Localisation > Currencies. Il metodo di pagamento viene nascosto quando la valuta del checkout del cliente è un'altra, e per importi totali inferiori a R$ 1,00 (il minimo di Iugu).

Account Iugu: ti servono due token API dalla dashboard di Iugu, uno di tipo "Test" e uno di tipo "Live" (vedi Configuration). Iugu usa un unico indirizzo API per entrambi: il token decide se le fatture sono di test o reali. Non è necessario configurare alcun webhook in Iugu.

CPF/CNPJ (facoltativo): OpenCart non ha un campo CPF proprio. Se aggiungi un campo personalizzato per cliente o indirizzo il cui nome contiene CPF o CNPJ (Customers > Custom Fields), il suo valore viene passato a Iugu.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

L'archivio da scaricare è 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_iugu_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_iugu_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_iugu_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. Invece dell'installer puoi anche copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Iugu 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. Inserisci i token API di test e live (vedi Configuration), lascia attivo Test mode, attiva Enable / Disable e clicca su Save.

5. Effettua un ordine di prova in BRL e pagalo sulla pagina di Iugu con un pagamento di test Iugu. Quando sei pronto, disattiva Test mode.

OpenCart 4

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_iugu_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 Iugu Gateway, clicca su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza e i token API come nei passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'URL delle notifiche (vedi Notifiche di pagamento).

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 Iugu Gateway > 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 (le fatture vengono create con il token API di test, senza addebiti reali) oppure LIVE. Ti avvisa quando manca il token della modalità attiva (in quel caso il metodo di pagamento viene nascosto al checkout) e quando la valuta predefinita del negozio non è BRL (Iugu allora non viene offerto per le altre valute). 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 i 128 caratteri, Sort Order deve essere un numero intero, Total deve essere un numero pari o superiore a 0, e la zona geografica e gli stati dell'ordine selezionati devono esistere. Altrimenti non viene salvato nulla e l'errore indica il campo.

Iugu

Enable / Disable: Enable Iugu payments attiva o disattiva il metodo di pagamento. Predefinito: disattivo.

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

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Paga in sicurezza tramite Iugu. Verrai reindirizzato per completare il pagamento.

Sort Order: la posizione di Iugu tra i metodi di pagamento al checkout. Lascialo vuoto oppure inserisci un numero intero.

Geo Zone: offri Iugu 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 offerto Iugu. Lascialo vuoto per offrire Iugu per qualsiasi totale. Iugu stesso richiede almeno R$ 1,00.

Credenziali API

Crea i token API in Iugu Alia (la sezione rimanda lì): Settings > API integration > New. Crea un token di tipo "Test" e uno di tipo "Live".

Test mode: usa il token API di test, quindi non viene effettuato nessun addebito reale. Predefinito: attivo. Mentre la modalità test è attiva, i clienti vedono SANDBOX — Test mode enabled. No real charges. nel passaggio Confirm Order, sopra la descrizione. I controlli di stato e i rimborsi di un ordine usano sempre il token della modalità in cui è stata creata la sua fattura, quindi cambiare modalità non compromette gli ordini precedenti.

Test API token: il token API Iugu di tipo "Test". Viene usato mentre la modalità test è attiva.

Live API token: il token API Iugu di tipo "Live" (produzione). Viene usato quando la modalità test è disattivata. Tienilo riservato.

I token salvati non vengono mai più mostrati. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi modificarlo. Per rimuovere un token salvato, spunta Clear the saved token on save sotto il campo e clicca su Save.

Notifiche di pagamento

Notification URL: ogni fattura chiede a Iugu di segnalare i cambi di stato a questo URL del tuo negozio. Su OpenCart 3 ha questo formato: https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook. Deve essere raggiungibile da internet. Non c'è nulla da configurare in Iugu. Un trigger aggiuntivo a livello di account che punta allo stesso URL è innocuo. Le notifiche non contengono dati di pagamento di cui il negozio si fida: la fattura viene sempre riletta dalle API di Iugu (stato, importo, valuta) prima che l'ordine cambi.

L'estensione reagisce agli eventi Iugu elencati in questa sezione: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action e invoices. Per ciascuno legge la fattura e ne applica lo stato:

Una fattura scaduta o annullata di un ordine che non ha ancora uno stato lascia l'ordine senza stato, così il cliente può pagare di nuovo. Gli altri eventi e le fatture non create dal tuo negozio ricevono risposta HTTP 200 e vengono ignorati, senza alcuna richiesta a Iugu. Senza notifiche, una fattura viene controllata solo quando il cliente torna nel negozio dalla pagina di Iugu.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo che Iugu ha segnalato la fattura, tramite notifica o al ritorno del cliente; la fattura viene sempre riletta da Iugu. Ogni campo sotto elenca i tuoi stati ordine di OpenCart.

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

Awaiting Iugu Payment Status: il cliente è tornato dalla pagina di Iugu con un boleto o un PIX emesso; Iugu confermerà il denaro più tardi. Predefinito: In attesa.

Iugu Payment On Hold Status: pagamento con carta autorizzato ma non catturato, pagamento in analisi, pagamento parziale, chargeback, importo o valuta diversi dall'ordine, oppure pagamento arrivato dopo l'annullamento dell'ordine. Una nota spiega il motivo; verificalo manualmente. Predefinito: In attesa, perché OpenCart non ha lo stato "On hold". Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Invoice Expired Status: la fattura di un ordine in attesa è scaduta senza pagamento. Se Iugu la segnala pagata più tardi, l'ordine riceve lo stato dopo il pagamento. Predefinito: Non riuscito.

Invoice Canceled Status: la fattura di un ordine in attesa è stata annullata in Iugu. Predefinito: Annullato.

Refunded Status: impostato dopo che il pagamento è stato rimborsato interamente dalla pagina dell'ordine o dalla dashboard di Iugu. Predefinito: Rimborsato.

Avanzate

Debug log: scrive le richieste API e le notifiche in wc_igu_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Token e dati dei clienti (e-mail, telefono, CPF) non vengono mai registrati. Errori e avvisi vengono sempre scritti, anche con l'interruttore disattivato. Predefinito: disattivo.

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

Delete data on uninstall: se attivo, disinstallando l'estensione vengono rimosse le impostazioni del gateway e il log. Ordini, riferimenti alle fatture Iugu e rimborsi vengono sempre conservati, così i vecchi ordini continuano a funzionare dopo una reinstallazione. Predefinito: disattivo.

Importazione / Esportazione

Export: Download JSON salva le impostazioni in un file JSON. I token API non vengono esportati.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. I token API salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Iugu). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea una fattura Iugu per il totale dell'ordine in BRL, con scadenza a 3 giorni, e invia il cliente alla pagina della fattura Iugu. È richiesta un'e-mail valida. La fattura mostra Order # e il numero dell'ordine. Lì il cliente paga con carta di credito, boleto o PIX, con i metodi abilitati nel tuo account Iugu. Nome e e-mail del cliente vengono passati a Iugu, insieme al CPF/CNPJ di un campo personalizzato chiamato CPF o CNPJ quando ha 11 o 14 cifre. Telefono e indirizzo vengono inviati solo nel formato accettato da Iugu (numeri di telefono brasiliani, indirizzi brasiliani con CEP a 8 cifre; il numero civico viene inviato come s/n).

Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose nel blocco del metodo di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina di checkout. Per impostazione predefinita OpenCart 4 non chiede un indirizzo di pagamento; in questo caso l'estensione usa l'indirizzo e il campo personalizzato CPF/CNPJ dell'indirizzo di spedizione.

Dopo il pagamento il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando Iugu lo conferma: la fattura viene riletta dalle API di Iugu quando il cliente torna e quando Iugu invia una notifica. L'ordine riceve poi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino, e il cliente vede la pagina di conferma ordine di OpenCart.

Se il cliente ha generato un codice boleto o PIX ed è tornato prima di pagare, l'ordine riceve l'Awaiting Iugu Payment Status e la pagina di successo mostra Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. L'ordine passa allo stato pagato quando Iugu segnala il denaro, tramite notifica o quando il cliente riapre il link di ritorno. Per un ordine in sospeso la pagina di successo mostra We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. Se Iugu non era raggiungibile o non ha ancora segnalato il pagamento quando il cliente è tornato, una pagina Payment confirmation mostra lo stesso testo con i pulsanti Check again e Back to checkout.

Se la fattura è stata annullata o è scaduta, il cliente torna al checkout con il messaggio The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. Se l'ordine era stato annullato perché la sua fattura Iugu è stata annullata, il messaggio è Your order was cancelled because its Iugu invoice was canceled. Se il carrello è già vuoto (un ordine boleto o PIX aveva raggiunto la pagina di successo prima che la sua fattura scadesse), il cliente vede invece una pagina Payment confirmation con The Iugu invoice of order #... was not paid (it was canceled or has expired), so the order will not be shipped. To buy these items, please place a new order. (o il messaggio di annullamento) e un pulsante Continue. Su OpenCart 4 i messaggi del checkout vengono mostrati 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, quindi dopo una fattura scaduta o annullata il cliente paga lo stesso ordine con una nuova fattura. Un carrello viene pagato una sola volta. Prima di una nuova fattura, l'estensione controlla le fatture precedenti del carrello: se una è pagata, quel pagamento viene applicato e il cliente va alla pagina di successo; se lo stesso ordine ha ancora una fattura aperta con lo stesso importo e modalità, il cliente vi viene rimandato; le altre fatture aperte vengono annullate in Iugu. Se una fattura precedente viene comunque pagata, il pagamento viene comunque abbinato e un pagamento duplicato di un carrello già pagato viene segnalato con una nota. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

Su OpenCart 4 l'ordine resta nel checkout fino a quando non viene mostrata la pagina di successo. Se nel frattempo l'ordine è stato chiuso (per esempio il boleto è scaduto o l'hai annullato), il cliente torna al checkout con il messaggio The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay., oppure, se era stato pagato prima della chiusura, con This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. Se l'ordine è già stato inserito e nel carrello c'è ora un nuovo acquisto, Confirm Order ricarica la pagina del checkout. In ogni caso, il successivo clic su Confirm Order paga un nuovo ordine del carrello.

Se Iugu non riesce a creare la fattura, il cliente resta al passaggio Confirm Order con un breve messaggio, per esempio Iugu could not create the invoice: con il motivo e l'invito a verificare i dati di fatturazione, oppure Could not connect to Iugu. Please try again in a moment. Il motivo tecnico viene scritto nel log.

L'URL delle notifiche funziona anche quando il negozio è in 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 la notifica e il ritorno del cliente.

L'estensione accetta solo pagamenti una tantum. Non ha un modulo carta sul sito, carte salvate, abbonamenti o addebiti ricorrenti, carnê, pagamenti suddivisi né impostazioni di rate: per le rate usa le impostazioni della pagina Iugu. I metodi di pagamento offerti nella pagina Iugu non possono essere scelti nelle impostazioni dell'estensione: vengono offerti tutti i metodi abilitati nel tuo account Iugu.

Ordini e rimborsi

Stati degli ordini

Nessuno stato (ordine mancante): il cliente è stato inviato a Iugu e non ha pagato, la fattura è scaduta o è stata annullata, oppure Iugu non ha ancora confermato il pagamento. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (predefinito In lavorazione): Iugu ha confermato il pagamento. Una nota mostra l'ID della fattura e il metodo di pagamento (carta di credito, boleto o PIX).

Awaiting Iugu Payment Status (predefinito In attesa): il cliente è tornato con un boleto o un PIX emesso. L'ordine passa allo stato pagato quando Iugu segnala il pagamento.

Iugu Payment On Hold Status (predefinito In attesa): il pagamento con carta è autorizzato ma non ancora catturato (catturalo in Iugu e l'ordine viene completato quando Iugu segnala la fattura pagata), il pagamento è in analisi, la fattura è stata pagata solo parzialmente, è stato aperto un chargeback, Iugu ha segnalato un importo o una valuta diversi da quelli dell'ordine, oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Le note lo spiegano. Controlla l'ordine e completalo oppure rimborsa il pagamento.

Invoice Expired Status (predefinito Non riuscito): la fattura di un ordine in attesa è scaduta senza pagamento. Se Iugu segnala più tardi la fattura come pagata, l'ordine passa allo stato pagato.

Invoice Canceled Status (predefinito Annullato): la fattura di un ordine in attesa è stata annullata in Iugu.

Refunded Status (predefinito Rimborsato): il pagamento è stato rimborsato interamente tramite l'estensione o dalla dashboard di Iugu.

Se un'altra fattura dello stesso ordine o carrello risulta anch'essa pagata, l'ordine non viene modificato. Una nota ti chiede di rimborsare il pagamento duplicato in Iugu. Le note sono voci della History dell'ordine che il cliente non vede. Quando un ordine in attesa viene pagato, scade o viene annullato più tardi, OpenCart comunica al cliente il nuovo stato.

Scheda VibeFox Iugu Gateway

In Sales > Orders apri un ordine pagato con Iugu. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Iugu Gateway mostra l'ID della Iugu invoice (collegato alla fattura in Iugu) con l'etichetta Test mode per le fatture di test, il Payment method, lo Status, gli importi Paid / refunded, il modulo di rimborso, lo storico dei rimborsi e le Iugu notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Iugu Gateway inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Iugu. Conferma la domanda Refund this amount through Iugu? This cannot be undone. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Il rimborso viene inviato con il token della modalità in cui è stata creata la fattura, quindi quel token deve essere impostato.

I rimborsi si calcolano sull'importo che Iugu ha effettivamente incassato per la fattura, quindi dopo una differenza di importo puoi rimborsare fino a quanto ha pagato il cliente, non il totale dell'ordine. Possono essere rimborsate solo le fatture pagate, e non più dell'importo ancora rimborsabile in Iugu. Un rimborso si considera effettuato solo quando Iugu lo conferma. Se Iugu rifiuta il rimborso o non lo conferma, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note, con l'ID della fattura e il motivo. Un rimborso totale imposta l'ordine a Refunded Status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio di stato manuale. Un rimborso parziale non modifica lo stato. I rimborsi sono disponibili una volta che Iugu ha segnalato la fattura come pagata.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite Iugu.

Un rimborso totale effettuato dalla dashboard di Iugu imposta l'ordine a Refunded Status con una nota. I rimborsi parziali effettuati dalla dashboard non vengono importati.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco di licenza License — VibeFox Iugu Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Iugu 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 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-iugu 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 incluse le versioni inglese e russa).

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 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. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Iugu 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 continua a vedere 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 il login dell'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 continuano a essere confermati, e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato 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 a settimana. Non serve alcun cron job. Disinstallare l'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Iugu non compare al checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo e che sia impostato il token della modalità attiva: Test API token in modalità test, Live API token in modalità live. La valuta del checkout del cliente deve essere BRL e il totale almeno R$ 1,00. Controlla anche 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 se il token o la valuta sono errati.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: la notifica di Iugu non è arrivata al tuo negozio oppure non è stato possibile verificarla. Attiva il Debug log e controlla il campo Log nella pagina dell'estensione. Verifica che il negozio sia raggiungibile da internet all'indirizzo della Notification URL e che il token della modalità in cui è stata creata la fattura sia ancora inserito. La fattura viene controllata anche quando il cliente torna nel negozio dopo aver pagato.

La notifica risponde verification failed: in quel momento non è stato possibile leggere la fattura dalle API di Iugu, per esempio per un errore di rete, un token errato o il token mancante per la modalità della fattura. Iugu ripete la notifica.

La notifica risponde busy: il carrello era in elaborazione da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Iugu ripete la notifica. Il log mostra il motivo.

La notifica risponde invalid invoice id: la notifica non aveva un ID fattura valido. Non viene modificato nulla.

L'ordine è nell'Iugu Payment On Hold Status: leggi le Iugu notes nella scheda dell'ordine. Un pagamento con carta attende la cattura, il pagamento è in analisi, pagato parzialmente o contestato, l'importo pagato non corrispondeva all'ordine, oppure il pagamento è arrivato dopo l'annullamento dell'ordine.

Il cliente vede "Iugu payments are not available right now": il token API manca o è errato. Controlla il token della modalità attiva.

Il cliente vede "A valid billing email is required for Iugu": l'ordine non ha un indirizzo e-mail valido.

Il cliente vede "This order already has an Iugu payment that the store has to review": una fattura precedente dell'ordine è autorizzata, in analisi o pagata parzialmente. Controlla la fattura in Iugu e il log.

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 nel frattempo. Il cliente ricarica il checkout.

Il rimborso non riesce: leggi il messaggio nella scheda. I pagamenti boleto non possono essere rimborsati tramite Iugu, i pagamenti PIX possono essere rimborsati solo per intero, e solo le fatture pagate possono essere rimborsate. Se il messaggio dice che il pagamento è stato fatto in modalità test o live e non è configurato alcun token, inserisci il token di quella modalità. Se Iugu non ha confermato il rimborso, controlla la fattura in Iugu prima di riprovare.

Per gli sviluppatori: prima della creazione della fattura, l'estensione attiva l'evento OpenCart wc_igu_invoice_data con la richiesta di fattura e l'ordine, per esempio per limitare i metodi di pagamento con payable_with.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Iugu 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 ordine della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio (startup action), che lascia passare le notifiche e il ritorno del cliente in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità test, token API, interruttore del debug log) e il log. Se è disattivo, vengono conservate per una futura reinstallazione. I riferimenti alle fatture Iugu e i rimborsi vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere ancora rimborsati e le notifiche tardive continuano a essere abbinate dopo una reinstallazione. Gli ordini esistenti conservano le proprie note di pagamento.

Su OpenCart 4, per rimuovere anche i file dell'estensione, dopo la disinstallazione vai su Extensions > Installer e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox Iugu Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

Iugu è un marchio di proprietà dei rispettivi titolari. Questa estensione non è affiliata a Iugu né approvata da Iugu.