VibeFox dLocal for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Account dLocal Go: ti servono la API key e la API secret del tuo account dLocal Go, dalla pagina Payment integration della dashboard di dLocal Go: dashboard-sbx.dlocalgo.com per la sandbox, dashboard.dlocalgo.com per la produzione. Sandbox e produzione usano credenziali diverse. L'estensione funziona solo con dLocal Go, non con l'API enterprise di dLocal Payments.

Valute e paesi: l'estensione non li limita. dLocal Go decide quali metodi di pagamento offrire per il paese del cliente e la valuta dell'ordine, in base al tuo account dLocal Go.

Negozio raggiungibile: dLocal Go invia le notifiche di pagamento e di rimborso dai propri server, quindi gli URL di notifica devono essere raggiungibili da internet tramite HTTPS.

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

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_dlocal_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_dlocal_payment.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_dlocal_payment-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 dLocal Payment 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 la API key e la API secret per la sandbox e, per i pagamenti reali, quelle per la produzione. Scegli l'Environment (vedi Configurazione).

5. Attiva Enable/Disable e clicca su Save. Effettua un pagamento di prova nella sandbox, poi imposta Environment su Production.

OpenCart 4

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

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

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

4. Inserisci la chiave di licenza e le credenziali dLocal Go e fai il pagamento di prova come nei passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali nelle due versioni. Cambiano solo gli URL di notifica (vedi Notifications (IPN)).

Non serve configurare nulla nella dashboard di dLocal Go: gli URL di notifica e di ritorno vengono inviati con ogni pagamento e ogni rimborso. Una nuova installazione parte con il metodo di pagamento disattivato e la sandbox selezionata.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox dLocal Payment > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Finché non vengono inserite la API key e la API secret dell'ambiente selezionato, la pagina ti avvisa che il metodo di pagamento è nascosto al checkout, per esempio: Inserisci la API key e la API secret della sandbox: fino ad allora il metodo di pagamento è nascosto al checkout. Mentre la sandbox è selezionata e il metodo di pagamento è attivo, viene mostrato La modalità sandbox è attiva: i pagamenti sono simulati, non viene addebitato alcun importo. Senza il diritto di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto né superiore a 128 caratteri, Sort Order deve essere un numero intero, Total un numero pari o superiore a 0, e la zona geografica e gli stati dell'ordine devono esistere. In caso contrario non viene salvato nulla e la pagina mostra l'errore. Se il metodo di pagamento è attivo senza la API key e la API secret dell'ambiente selezionato, le impostazioni vengono salvate con l'avviso sopra.

dLocal Go

Enable/Disable: Enable dLocal Go 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: dLocal Go. Obbligatorio.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Paga con carte locali, bonifico bancario o contanti tramite dLocal Go.

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

Geo Zone: offri dLocal Go 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 carrello, nella valuta predefinita del negozio, che un ordine deve raggiungere perché venga offerto dLocal Go. Lascia il campo vuoto per offrire dLocal Go per qualsiasi importo.

Credenziali API

Copia la API key e la API secret dalla dashboard di dLocal Go, Payment integration: dashboard-sbx.dlocalgo.com (sandbox) o dashboard.dlocalgo.com (produzione). La sezione contiene i collegamenti a entrambe le dashboard.

Environment: quali credenziali e quali server di dLocal Go vengono usati per i nuovi pagamenti.

I rimborsi e le notifiche di un pagamento usano sempre le credenziali dell'ambiente in cui è stato effettuato, quindi conserva le credenziali dell'altro ambiente finché i suoi pagamenti sono ancora aperti o possono essere rimborsati.

Sandbox API Key: la tua API key della sandbox di dLocal Go.

Sandbox API Secret: la tua API secret della sandbox di dLocal Go.

Production API Key: la tua API key di produzione di dLocal Go.

Production API Secret: la tua API secret di produzione di dLocal Go.

Le chiavi e i secret salvati non vengono più mostrati. Il campo resta vuoto e mostra Salvato — lascia vuoto per mantenerlo. Inserisci un nuovo valore solo se vuoi modificarlo. Per eliminare un valore salvato, seleziona Clear the saved value sotto il campo e clicca su Save.

Pagamento

Default country: dLocal Go mostra i metodi di pagamento del paese del cliente, preso dall'indirizzo di pagamento e, se manca, dall'indirizzo di spedizione. Questo paese viene usato quando l'ordine non ha nessuno dei due. L'elenco mostra i paesi del tuo negozio. Predefinito: Uruguay.

Auto-complete orders: assegna agli ordini pagati lo Complete Order Status invece del Paid Order Status. Predefinito: disattivato.

Notifications (IPN): le notifiche informano il tuo negozio che un pagamento o un rimborso è cambiato. L'estensione invia gli URL di notifica a dLocal Go con ogni pagamento e ogni rimborso, quindi non c'è nulla da configurare nella dashboard di dLocal Go. Questo campo mostra entrambi gli URL, costruiti dall'indirizzo della vetrina della tua installazione di OpenCart:

Le notifiche vengono verificate con la tua API secret (HMAC-SHA256). Le notifiche senza una firma valida vengono rifiutate. Una notifica deve essere firmata con le credenziali dell'ambiente in cui è stato effettuato il pagamento. Dopodiché lo stato, l'importo e la valuta del pagamento vengono sempre riletti dalla API di dLocal Go; il contenuto della notifica non viene considerato affidabile. Senza notifiche, un ordine riceve il suo stato solo quando il cliente torna nel negozio.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che dLocal Go ha confermato il pagamento. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Paid Order Status: lo stato dell'ordine dopo un pagamento confermato. Predefinito: In lavorazione.

Complete Order Status: lo stato dell'ordine dopo un pagamento confermato quando Auto-complete orders è attivo. Predefinito: Completato.

On Hold (Review) Status: i pagamenti il cui importo o la cui valuta non corrispondono all'ordine, o che arrivano dopo l'annullamento dell'ordine, ricevono questo stato e una nota che spiega il motivo. Predefinito: In attesa, perché OpenCart non ha lo 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 pagina dell'ordine. Predefinito: Rimborsato.

Avanzate

Debug log: scrive le richieste e le notifiche di dLocal Go in dlocal_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web e, al raggiungimento di 5 MB, viene spostato in un file di backup. Le credenziali API e i dati personali non vengono registrati. Errori e avvisi vengono sempre scritti; le altre voci solo mentre questa opzione è attiva. 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 dati di pagamento degli ordini (pagamenti e rimborsi dLocal) vengono sempre conservati, così gli ordini esistenti continuano a funzionare. Predefinito: disattivato.

Importazione / Esportazione

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

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita dLocal Go). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota Sarai reindirizzato alla pagina di pagamento di dLocal Go. In modalità sandbox viene mostrato anche Modalità sandbox: non viene effettuato alcun pagamento reale. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea un pagamento dLocal Go per il totale dell'ordine nella valuta dell'ordine, con paese, nome, e-mail e telefono del cliente, e invia il cliente alla pagina di pagamento di dLocal Go. Lì il cliente paga con un metodo del proprio paese. Nella pagina di dLocal Go il pagamento compare come Order # e il numero d'ordine. 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. Se il negozio non chiede un indirizzo di pagamento (impostazione predefinita di OpenCart 4), vengono usati il paese dell'indirizzo di spedizione e il nome del cliente.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando dLocal Go lo conferma: tramite la notifica firmata o con una richiesta lato server alla API di dLocal Go quando il cliente torna. L'indirizzo di ritorno contiene un token casuale del tentativo di pagamento. 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 successo dell'ordine di OpenCart con Your payment with dLocal Go has been received. Se l'ordine è stato messo nello stato di revisione, la pagina mostra Your dLocal Go payment has been received and is being reviewed by the store. You will be informed when your order is confirmed. Se dLocal Go non ha ancora confermato il pagamento (per esempio un voucher in contanti non ancora pagato, oppure dLocal Go non era raggiungibile), una pagina Payment confirmation chiede al cliente di non pagare di nuovo e propone Check again e Back to checkout. L'ordine riceve il suo stato non appena dLocal Go conferma il pagamento. Su OpenCart 4 il browser non invia la sessione del negozio quando dLocal Go rimanda il cliente indietro, quindi l'estensione mostra prima una breve pagina che riapre lo stesso indirizzo di ritorno dal tuo negozio: il cliente conserva il carrello e l'accesso.

Se il cliente lascia la pagina di dLocal Go senza pagare, torna al checkout e vede The payment at dLocal Go was not completed. You can try again or choose another payment method. Se il pagamento è stato rifiutato o è scaduto, il messaggio è Your dLocal payment was not completed: it was declined or it expired. Please try again or choose another payment method. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout. Il carrello viene conservato. Ogni clic su Confirm Order crea un nuovo pagamento dLocal Go. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna, quindi il nuovo pagamento appartiene allo stesso ordine. Un link di pagamento precedente può essere ancora pagato e conferma il suo ordine. Prima che inizi un nuovo pagamento, vengono letti da dLocal Go i pagamenti aperti dello stesso ordine e della stessa sessione del cliente (ultime 24 ore): se uno è pagato, il suo ordine viene confermato e il cliente passa alla pagina di successo senza un secondo pagamento.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio annullato o rimborsato), Confirm Order o il ritorno da dLocal Go rimanda il cliente al checkout con Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., e il successivo Confirm Order paga un nuovo ordine del carrello.

Se dLocal Go non riesce ad avviare il pagamento, il cliente resta al passaggio Confirm Order con un breve messaggio, per esempio dLocal could not start the payment: seguito dal motivo indicato da dLocal. Questo accade anche quando il paese del cliente e la valuta dell'ordine non sono abilitati nel tuo account dLocal Go. Se dLocal Go rifiuta le tue credenziali, il cliente vede This payment method is temporarily unavailable. Please choose another payment method or contact us. Il motivo tecnico viene scritto nel log.

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

L'estensione accetta solo pagamenti una tantum nella pagina di dLocal Go. Non ha un modulo carta sul tuo sito, né carte salvate, abbonamenti o autorizzazione e acquisizione separate.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a dLocal Go e non ha pagato, il pagamento è stato rifiutato o è scaduto, oppure è ancora in sospeso presso dLocal Go. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Paid Order Status (predefinito In lavorazione) o Complete Order Status (predefinito Completato): il pagamento è stato confermato. L'ordine riceve il Complete Order Status quando Auto-complete orders è attivo. Una nota mostra l'ambiente e l'ID del pagamento dLocal.

On Hold (Review) Status (predefinito In attesa): dLocal Go ha segnalato un importo o una valuta diversi dal totale dell'ordine, oppure il pagamento è arrivato dopo che l'ordine era stato annullato. La nota lo spiega. Verifica nella dashboard di dLocal Go, poi evadi l'ordine o rimborsa il pagamento.

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

Un pagamento rifiutato, scaduto o annullato non modifica mai un ordine che ha già uno stato. Se arriva un secondo pagamento per un ordine già pagato, l'ordine non viene modificato. Una nota ti chiede di rimborsare il pagamento duplicato nella dashboard di dLocal Go. Lo stesso tipo di nota viene aggiunto all'ordine pagato quando lo stesso carrello (stessa sessione del cliente e stesso contenuto) è stato pagato di nuovo con un altro ordine, per esempio in una seconda scheda del browser; quell'altro ordine non mantiene alcuno stato.

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

Scheda VibeFox dLocal Payment

In Sales > Orders apri un ordine pagato con dLocal Go. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox dLocal Payment mostra il Payment ID, l'Environment (sandbox o produzione), lo Status del pagamento, gli importi Paid / refunded, il modulo di rimborso, lo storico dei rimborsi e le dLocal Go notes dell'ordine. La scheda è mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox dLocal Payment inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via dLocal Go. Conferma la domanda Refund this amount through dLocal Go? This cannot be undone. Sono supportati rimborsi totali e parziali. Ti serve il diritto di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi vengono effettuati nell'importo e nella valuta addebitati da dLocal Go, quindi dopo una discrepanza di importo o valuta puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. Il rimborso viene inviato all'ambiente in cui è stato effettuato il pagamento, con le credenziali di quell'ambiente. Se dLocal Go non accetta il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso accettato viene aggiunto allo storico dei rimborsi e alle note, con ID, stato e motivo del rimborso. Un rimborso totale imposta l'ordine su Refunded Status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato. I rimborsi sono disponibili dopo che dLocal Go ha confermato il pagamento.

dLocal Go comunica poi lo stato finale del rimborso tramite la notifica di rimborso, e questo viene aggiunto alle note. Se in seguito dLocal Go rifiuta o annulla un rimborso che aveva accettato, la nota avvisa che il denaro non è stato restituito al cliente. Rimborsa di nuovo il cliente o in un altro modo.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite dLocal Go. I rimborsi effettuati nella dashboard di dLocal Go non vengono registrati come rimborsi in OpenCart. Aggiorna l'ordine manualmente, se necessario.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox dLocal Payment è il primo blocco in Extensions > Extensions > Payments > VibeFox dLocal Payment > 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 a cui 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-dlocal e il link Manage licenses and domains in your account, che apre il tuo account di 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 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 di vibefox.net.

Senza una chiave attiva, dLocal Go non viene mostrato ai clienti al checkout. Se comunque viene avviato un pagamento, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore che ha effettuato l'accesso all'area di 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 continuano a essere confermati e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene ricontrollato 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

dLocal Go non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la API key e la API secret dell'Environment selezionato siano impostate. La pagina delle impostazioni mostra un avviso se mancano. 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: dLocal Go non è riuscito a raggiungere l'URL di notifica (firewall, autenticazione di base o assenza di un indirizzo HTTPS pubblico) e il cliente non è tornato nel negozio. Attiva il Debug log, controlla il campo Log e verifica il pagamento nella dashboard di dLocal Go. Appena arriva una notifica o il cliente clicca su Check again, l'ordine riceve il suo stato.

La notifica risponde Missing signature o Invalid signature: la API key e la API secret nelle impostazioni non appartengono all'account che ha inviato la notifica. Le notifiche vengono verificate con le credenziali dell'ambiente del pagamento, quindi i pagamenti avviati prima di cambiare Environment vengono comunque confermati, finché le credenziali del loro ambiente restano nelle impostazioni.

La notifica risponde Gateway not configured: mancano le credenziali dell'ambiente del pagamento. Inseriscile; dLocal Go ripete la notifica.

La notifica risponde API verification failed: non è stato possibile raggiungere la API di dLocal Go per leggere il pagamento. dLocal Go ripete la notifica.

La notifica risponde Temporarily unavailable: l'ordine era in conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. dLocal Go ripete la notifica. Il motivo è nel log.

La notifica risponde Order not found: il pagamento non appartiene a un ordine di questo negozio, per esempio perché è stato creato da un altro sito con lo stesso account dLocal Go.

Il cliente vede This payment method is temporarily unavailable: dLocal Go ha rifiutato la API key o la API secret. Controlla le credenziali dell'ambiente selezionato.

Il cliente vede Payment gateway is not properly configured: mancano le credenziali dell'ambiente selezionato.

L'ordine è nello stato di revisione dopo il pagamento: leggi le note nella scheda VibeFox dLocal Payment. L'importo o la valuta pagati non corrispondevano all'ordine, oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Evadi l'ordine o rimborsa il pagamento.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: il pagamento non è ancora confermato, è stato rimborsato interamente, il tuo gruppo utenti non ha il diritto di modificare l'estensione, oppure mancano le credenziali dell'ambiente del pagamento.

Il rimborso fallisce con un messaggio sulle credenziali mancanti: il pagamento è stato effettuato nell'altro ambiente, le cui credenziali non sono impostate. Inseriscile e riprova.

Per gli sviluppatori: l'estensione attiva gli eventi di OpenCart dlocal_p_payment_data (la richiesta di pagamento e l'ordine, prima che il pagamento venga creato) e dlocal_p_currency_decimals (i decimali di una valuta).

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox dLocal Payment. 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 degli ordini della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 i suoi eventi e la sua azione di avvio, che lascia passare dLocal Go in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, ambiente, credenziali, paese predefinito, completamento automatico, registrazione) e il log. Se è disattivo, vengono conservate per una reinstallazione successiva. I pagamenti e i rimborsi dLocal degli ordini vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti conservano le proprie 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 dLocal Payment nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

dLocal è un marchio del rispettivo proprietario. Questa estensione non è affiliata a dLocal né approvata da dLocal.