VibeFox MercadoPago 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.

Valuta del negozio: la valuta del paese del tuo account MercadoPago deve essere abilitata nel negozio: ARS (Argentina), BRL (Brasile), CLP (Cile), COP (Colombia), MXN (Messico), PEN (Perù) o UYU (Uruguay). MercadoPago addebita nella valuta dell'account e non converte, quindi il metodo di pagamento viene mostrato solo ai clienti che pagano in quella valuta.

Account MercadoPago: ti serve un'applicazione nel pannello sviluppatori di MercadoPago (Your integrations > your application > Credentials) con le sue credenziali di test (che iniziano con TEST-) e di produzione (che iniziano con APP_USR-): una Public Key e un Access Token per ciascuna. Per la verifica facoltativa della firma delle notifiche ti serve anche la firma segreta di your application > Webhooks.

Chiave di licenza VibeFox: acquistata 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_mercadopago_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_mercadopago_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_mercadopago_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 radice del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox MercadoPago 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 forma di 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. Scegli l'Account country, inserisci le credenziali di test e di produzione e, facoltativamente, configura le notifiche nella tua applicazione MercadoPago (vedi Configurazione). Verifica che la valuta dell'account sia abilitata in System > Localisation > Currencies.

5. Attiva Enable / Disable e clicca su Save. Prova un pagamento in modalità test con le carte di test di MercadoPago, poi disattiva Test mode.

OpenCart 4

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

4. Inserisci la chiave di licenza, le credenziali e le notifiche 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 di notifica (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 MercadoPago 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 is on: the TEST- credentials are used and no real money is charged. finché la modalità test è attiva. Ti avvisa quando manca la Public Key o l'Access Token della modalità corrente (in tal caso il metodo di pagamento viene nascosto al checkout), quando la valuta predefinita del negozio non è la valuta del tuo account MercadoPago (in tal caso il metodo viene mostrato solo ai clienti che pagano nella valuta dell'account, oppure viene nascosto se il negozio non ha quella valuta abilitata) e quando le credenziali appartengono a un account di un paese diverso da Account country. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Se salvi con un Title vuoto (o più lungo di 128 caratteri), non viene salvato nulla e la pagina mostra Enter a title for the payment method (1 to 128 characters). Qualsiasi altro valore errato non viene salvato e mantiene il valore precedente, con un errore che indica il campo e termina con — the previous value was kept. Questo vale per una credenziale che non inizia con il prefisso previsto (TEST- per i campi di test, APP_USR- per quelli di produzione), per un Maximum installments fuori dall'intervallo 1–24, per un Sort Order che non è un numero intero (Sort Order must be a whole number), per un Total che non è un numero maggiore o uguale a 0, e per una zona geografica o uno stato dell'ordine che non esistono. Dopo il salvataggio, l'estensione chiede a MercadoPago a quale paese appartiene ciascun access token. Se il token della modalità corrente non può essere verificato, se l'account non si trova in un paese supportato o se il paese è diverso da Account country, viene mostrato un avviso. L'estensione usa allora il paese dell'account.

MercadoPago

Enable / Disable: Enable MercadoPago card payments attiva o disattiva il metodo di pagamento. Il metodo viene mostrato al checkout solo quando le credenziali della modalità attiva sono compilate e il cliente paga nella valuta dell'account MercadoPago. Predefinito: disattivato.

Title: il nome del metodo di pagamento mostrato al cliente al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: Credit or debit card (MercadoPago). Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato sopra i campi della carta nel passaggio Confirm Order. Predefinito: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

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

Geo Zone: offri MercadoPago 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 checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga offerto MercadoPago. Lascia vuoto per offrire MercadoPago per qualsiasi importo.

Account MercadoPago

Ottieni le credenziali della tua applicazione nel pannello sviluppatori di MercadoPago: Your integrations > your application > Credentials (la pagina contiene il collegamento). Le credenziali di test iniziano con TEST-, quelle di produzione con APP_USR-.

Account country: il paese del tuo account MercadoPago. Determina la valuta di addebito, la lingua dei campi della carta e se viene richiesto il documento del titolare. Il cliente deve pagare nella stessa valuta, per esempio ARS per l'Argentina. Al salvataggio delle credenziali il paese viene verificato con l'account. Predefinito: Argentina (ARS).

Test mode: in modalità test vengono usate le credenziali TEST- e paghi con le carte di test di MercadoPago; al checkout compare un badge TEST MODE con Use MercadoPago test cards. No real charges.. Disattivala per addebitare carte reali con le credenziali di produzione. Rimborsi e notifiche usano sempre le credenziali della modalità in cui è stato effettuato il pagamento. Predefinito: attivo.

Test Public Key: inizia con TEST-. Usata nel browser per tokenizzare la carta.

Test Access Token: inizia con TEST-. Usato solo sul server. Tienilo segreto.

Production Public Key: inizia con APP_USR-.

Production Access Token: inizia con APP_USR-. Usato solo sul server. Tienilo segreto.

Gli access token salvati e il segreto del webhook non vengono mai mostrati di nuovo. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere un valore salvato, spunta Clear the saved value on save sotto il campo e clicca su Save.

Opzioni di pagamento

Maximum installments: il numero massimo di rate (cuotas o parcelas) che il cliente può scegliere, da 1 a 24. 1 = solo pagamento unico. Il limite viene applicato anche sul server. Predefinito: 1.

Notifiche di pagamento (webhook)

I pagamenti con carta di solito ricevono subito una risposta definitiva. I pagamenti che MercadoPago tiene in verifica (in elaborazione o in sospeso) vengono completati dalle notifiche di MercadoPago. L'estensione invia l'URL di notifica con ogni pagamento quando il tuo negozio ha un indirizzo pubblico (non localhost né un dominio .local o .test). Puoi aggiungerlo anche in your application > Webhooks, evento Payments. L'URL è mostrato in Notification URL in questa sezione. Su OpenCart 3 ha un aspetto del tipo https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks. È costruito dall'indirizzo della vetrina della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni.

Una notifica non viene mai considerata attendibile di per sé. L'estensione rilegge il pagamento dalle API di MercadoPago con l'access token dell'ambiente in cui è stato effettuato il pagamento e lo collega a un tentativo di pagamento del tuo negozio. Senza notifiche, gli ordini in verifica restano in Awaiting MercadoPago Status finché non li aggiorni a mano.

L'estensione gestisce questi stati di pagamento di MercadoPago:

Webhook secret signature: facoltativo. La firma segreta mostrata in your application > Webhooks. Se è impostata, le notifiche senza una x-signature valida vengono rifiutate (HTTP 401).

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza stato (un ordine incompleto). Riceve uno stato solo dopo che MercadoPago ha risposto. Una carta rifiutata lascia l'ordine senza stato (una nota ne spiega il motivo) e il cliente resta al passaggio Confirm Order. Ciascuno dei campi seguenti elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: MercadoPago ha approvato il pagamento e importo e valuta corrispondono all'ordine. Predefinito: In lavorazione.

Awaiting MercadoPago Status: il pagamento è in verifica presso MercadoPago (in elaborazione o in sospeso); la notifica completa l'ordine. Predefinito: In sospeso.

On Hold (Review) Status: MercadoPago ha approvato un importo o una valuta diversi dall'ordine, oppure ha restituito uno stato inatteso. Una nota spiega cosa controllare nel pannello di MercadoPago. Predefinito: In sospeso, perché OpenCart non ha lo stato On hold. Puoi creare i tuoi stati in System > Localisation > Order Statuses per distinguere gli ordini in attesa da quelli in verifica.

Payment Failed Status: un pagamento in verifica è stato rifiutato o annullato da MercadoPago. Predefinito: Non riuscito.

Cancelled Status: un ordine in questo stato (o nello stato rimborsato) è chiuso: un'approvazione tardiva di MercadoPago aggiunge solo una nota. Predefinito: Annullato.

Refunded Status: il pagamento viene rimborsato per intero dalla pagina dell'ordine. I rimborsi parziali aggiungono solo una nota. Predefinito: Rimborsato.

Avanzate

Debug log: scrive richieste e notifiche di MercadoPago in wc_mpg_debug.log.php nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Gli errori vengono sempre registrati, anche con questa impostazione disattivata. Access token, token delle carte e dati del pagatore non vengono registrati. Predefinito: disattivato.

Log: mostra la dimensione e le ultime voci del log. 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 record dei pagamenti MercadoPago e i rimborsi restano sempre, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Access token e segreto del webhook non vengono esportati.

Import: incolla il JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. I segreti salvati vengono mantenuti.

Checkout

Al passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit or debit card (MercadoPago)). OpenCart crea l'ordine al passaggio Confirm Order, ancora senza stato. Lì il cliente vede la tua descrizione e compila i campi della carta: Card number, Expiry (MM/YY), Security code e Cardholder name. A seconda del paese e della carta, il cliente sceglie anche il Document type e inserisce il Document number, seleziona il Card issuer e il numero di Installments. Le opzioni di rateizzazione e gli interessi sono forniti da MercadoPago per il totale dell'ordine.

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. I campi della carta compaiono poi nel blocco di conferma dell'ordine in fondo alla pagina di checkout, sopra il pulsante Confirm Order.

Quando il cliente clicca su Confirm Order, MercadoPago trasforma la carta in un token monouso e il tuo negozio crea il pagamento sul server per il totale dell'ordine nella valuta dell'ordine. L'e-mail e il nome del cliente e il documento vengono trasmessi a MercadoPago; il pagamento appare come Order #, il numero dell'ordine e il nome del tuo negozio. Gli importi in CLP e COP vengono addebitati senza decimali.

Un pagamento approvato imposta lo stato dell'ordine 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 successo dell'ordine di OpenCart. Un pagamento in verifica imposta Awaiting MercadoPago Status, e la pagina mostra anche MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. Un ordine nello stato di verifica mostra Your payment is being reviewed. We will update your order as soon as the review is complete.

Una carta rifiutata lascia l'ordine senza stato. Il cliente resta al passaggio Confirm Order con un motivo breve, per esempio Your card has insufficient funds. Please use another card or payment method. oppure Please check the security code of your card. Il cliente può correggere i dati o usare un'altra carta; per ogni tentativo viene creato un nuovo token della carta. Se mancano i dati della carta compare Please fill in all card fields.

Se MercadoPago non risponde, il cliente vede We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. Il tentativo successivo cerca prima il pagamento, così la carta non viene addebitata due volte. Un secondo clic mentre il carrello è in pagamento mostra This order is already being paid. Please wait a moment and check your e-mail before trying again. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 mantiene un ordine per il checkout e, dopo una carta rifiutata, il cliente paga lo stesso ordine. In ogni caso un carrello con un ordine pagato o in attesa non viene mai addebitato di nuovo; il cliente viene inviato alla pagina di successo.

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 senza pagamento (per esempio l'hai annullato), non viene addebitato e il cliente vede Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. Se l'ordine è già stato inserito e il carrello è cambiato da allora, il messaggio è Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

L'URL di notifica funziona anche quando 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) per essa.

L'estensione accetta solo carte di credito e di debito. Non ha reindirizzamento a Checkout Pro, wallet o saldo del conto MercadoPago, nessun pagamento in contanti (Rapipago, OXXO, boleto e altri), nessun Pix, PSE o Yape, nessuna carta salvata o abbonamento, nessuna autorizzazione e cattura separate, nessuna sfida 3-D Secure e nessuna conversione di valuta.

Ordini e rimborsi

Stati dell'ordine

No status (missing order): la carta è stata rifiutata, oppure MercadoPago non ha ancora risposto. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Order Status After Payment (predefinito In lavorazione): MercadoPago ha approvato il pagamento e importo e valuta corrispondono all'ordine. Una nota mostra l'ID del pagamento, l'ambiente e il numero di rate.

Awaiting MercadoPago Status (predefinito In sospeso): il pagamento è in verifica (in elaborazione o in sospeso) e attende la notifica di MercadoPago. L'ordine passa a Order Status After Payment quando MercadoPago lo approva.

On Hold (Review) Status (predefinito In sospeso): l'importo o la valuta approvati differiscono dall'ordine, oppure MercadoPago ha restituito uno stato inatteso. La nota lo spiega. Controlla l'ordine e poi evadilo o rimborsa il pagamento.

Payment Failed Status (predefinito Non riuscito): un pagamento in verifica è stato rifiutato o annullato. La nota mostra lo stato e il suo dettaglio.

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

Se MercadoPago approva un pagamento per un ordine già annullato o rimborsato, lo stato non cambia e una nota ti chiede di completare l'ordine o di rimborsare il pagamento. Se arriva un altro pagamento per un ordine o un carrello già pagato, una nota ti chiede di rimborsare il pagamento in eccesso nel pannello di MercadoPago.

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

Scheda VibeFox MercadoPago Gateway

In Sales > Orders apri un ordine pagato con MercadoPago. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox MercadoPago Gateway mostra il Payment ID, lo Status del pagamento, l'Environment (un'etichetta Test per i pagamenti di test), le Installments, gli importi Charged / order, l'importo Refunded, il modulo di rimborso, lo storico dei rimborsi e le MercadoPago notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox MercadoPago Gateway inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via MercadoPago. Conferma la domanda Refund this amount through MercadoPago? This cannot be undone. 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 addebitato da MercadoPago, quindi dopo una differenza di importo puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non al totale dell'ordine. Il rimborso viene inviato con le credenziali dell'ambiente in cui è stato effettuato il pagamento (test o produzione), quindi l'access token di quell'ambiente deve essere impostato. Se MercadoPago rifiuta il rimborso, la scheda mostra MercadoPago refused the refund con il motivo e non viene registrato alcun rimborso. Un rimborso approvato o in elaborazione viene aggiunto allo storico dei rimborsi e alle note con l'ID del rimborso. Un rimborso totale imposta l'ordine su Refunded Status senza avvisare il cliente e senza riportare i prodotti in magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato.

Le restituzioni di prodotti in Sales > Returns non rimborsano denaro tramite MercadoPago.

I rimborsi, gli storni e le mediazioni effettuati nel pannello di MercadoPago arrivano tramite notifica 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 acquistata su vibefox.net. Il blocco della licenza License — VibeFox MercadoPago Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo di che 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 ci sono la riga Product: opencart-payment-mercadopago e il collegamento Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify 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 indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato 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 della configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, MercadoPago non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore che ha effettuato l'accesso all'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato con (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 vengono comunque confermati e i rimborsi funzionano.

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

Risoluzione dei problemi

MercadoPago non compare al checkout: controlla che la licenza sia attiva, che Enable / Disable sia attivo e che la modalità corrente abbia entrambe le credenziali con il prefisso corretto: le chiavi TEST- in modalità test, le chiavi APP_USR- in produzione. Controlla che il cliente paghi nella valuta del tuo account MercadoPago (la valuta deve essere abilitata nel negozio), che l'indirizzo di pagamento rientri nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni. La pagina delle impostazioni indica quale manca.

Il pagamento è andato a buon fine, ma l'ordine resta in Awaiting MercadoPago Status: la notifica non è arrivata. L'estensione invia l'URL di notifica solo quando il tuo negozio ha un indirizzo pubblico (non localhost né un dominio .local o .test). Aggiungi l'URL da Notification URL in your application > Webhooks con l'evento Payments. Se Webhook secret signature è impostato, verifica che sia il segreto della stessa applicazione. Il pannello di MercadoPago mostra la risposta del tuo negozio per ogni notifica.

La notifica risponde invalid signature: la firma segreta appartiene a un'altra applicazione, oppure la notifica non ha una x-signature valida. Copia di nuovo il segreto o lascia il campo vuoto.

La notifica risponde no credentials for test oppure no credentials for live: l'access token dell'ambiente in cui è stato effettuato il pagamento non è impostato. Inseriscilo; MercadoPago ripeterà la notifica.

La notifica risponde not for this store: il pagamento non appartiene a un tentativo di pagamento di questo negozio. Nessun ordine viene modificato.

La notifica risponde order busy oppure payment could not be read: l'ordine era in aggiornamento da un'altra richiesta nello stesso momento, oppure MercadoPago non era raggiungibile. MercadoPago ripete automaticamente la notifica.

Una credenziale non viene salvata: l'errore must start with indica che il valore ha il prefisso sbagliato per quel campo. I campi di test accettano credenziali TEST-, quelli di produzione credenziali APP_USR-.

Il cliente vede «This payment method is not configured correctly. Please choose another payment method or contact the store.»: le credenziali della modalità corrente mancano, hanno il prefisso sbagliato o sono state rifiutate da MercadoPago. Controllale nella pagina delle impostazioni.

Il cliente vede «MercadoPago cannot process payments in»: la valuta dell'ordine non è quella del tuo account MercadoPago. MercadoPago non converte le valute.

Il modulo sicuro della carta non si carica: il cliente vede The secure card form could not be loaded. Please reload the page or choose another payment method. Controlla la Public Key della modalità corrente.

Il cliente vede «Your session has expired. Please reload the page and try again.»: il modulo della carta non appartiene più alla sessione di checkout del cliente. Il cliente ricarica la pagina di checkout.

Il cliente vede «Your payment was received, but the order could not be completed automatically»: MercadoPago ha incassato il pagamento, ma OpenCart non è riuscito a impostare lo stato dell'ordine. Controlla il campo Log nella pagina dell'estensione: gli errori vengono sempre registrati. Al cliente viene chiesto di non pagare di nuovo; il tentativo di pagamento successivo o la notifica successiva per il carrello imposta lo stato senza un nuovo addebito.

L'ordine è nello stato di verifica dopo il pagamento: leggi le MercadoPago notes nella scheda dell'ordine (vedi Stati dell'ordine), poi evadi l'ordine o rimborsa il pagamento.

Il rimborso non riesce con un messaggio sulla modalità: il pagamento è stato effettuato in modalità test o produzione, e l'access token di quella modalità non è impostato. Inseriscilo e riprova.

Il rimborso non riesce con MercadoPago did not answer the refund request: controlla il pagamento nel pannello di MercadoPago prima di riprovare.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox MercadoPago 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 degli ordini della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Anche l'evento OpenCart dell'estensione viene rimosso (su OpenCart 4 anche la sua azione di avvio (startup action), che lascia passare le notifiche in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, account country, modalità test, credenziali, rate, segreto del webhook, registrazione), il controllo dell'account salvato e il log. Se è disattivato, vengono conservate per una reinstallazione successiva. I record dei pagamenti MercadoPago e i rimborsi restano sempre, 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, dopo la disinstallazione vai su Extensions > Installer e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox MercadoPago Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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