VibeFox Conekta 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: la valuta del checkout deve essere MXN o USD. Per le altre valute il metodo di pagamento viene nascosto.

Account Conekta: ti servono le chiavi API private del tuo account Conekta (test e live) e un webhook nel pannello Conekta (vedi Configuration). Vengono usate solo le chiavi private. La chiave pubblica non è necessaria, perché il pagamento avviene nel checkout ospitato da Conekta.

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

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_conekta_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_conekta_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_conekta_gateway-oc3-(version).ocmod.zip. L'estensione non ha modifiche OCMOD, quindi Extensions > Modifications non deve essere aggiornato. In alternativa all'installer, puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Conekta 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 le chiavi private di test e live, scegli la modalità e aggiungi il webhook nel pannello Conekta (vedi Configuration).

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

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_conekta_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 a esso.

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

4. Inserisci la chiave di licenza, le chiavi Conekta e il webhook come nei passaggi 3–5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali nelle due versioni. Cambia solo l'URL del webhook (vedi Webhook).

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

Configuration

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Conekta Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni, la pagina ti avvisa quando Conekta è attivo ma la chiave privata della modalità corrente è vuota (in questo caso il metodo di pagamento viene nascosto al checkout) e quando la valuta predefinita del negozio non è MXN o USD. Con la modalità test attiva, la pagina mostra Test mode is on: payments are simulated with the test private key. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non deve essere vuoto, Sort Order deve essere un numero intero, Total deve essere un numero non negativo, e la zona geografica e gli stati dell'ordine selezionati devono esistere. Se una verifica fallisce, non viene salvato nulla e la pagina elenca gli errori. Due avvisi non bloccano il salvataggio: quando non è selezionato alcun metodo di pagamento (vengono quindi proposti i pagamenti con carta) e quando il gateway è attivo senza la chiave privata della modalità corrente.

Conekta

Enable / Disable: Enable Conekta payments attiva o disattiva il metodo di pagamento. Default: off.

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

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Default: Pay securely with card, OXXO cash or SPEI transfer. Verrai reindirizzato a Conekta per completare il pagamento.

Payment methods: i metodi offerti nella pagina di pagamento di Conekta. Default: card, cash and bank transfer. Contanti, SPEI e BNPL sono disponibili solo per gli ordini in MXN (gli ordini in USD ricevono solo carte) e devono essere attivati nel tuo account Conekta. Se non è selezionato nulla, si usa la carta.

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

Geo Zone: offri Conekta solo per gli indirizzi di pagamento nella zona geografica selezionata. Default: 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 Conekta. Lascia il campo vuoto per offrire Conekta per qualsiasi importo.

Chiavi API

Copia le chiavi private dal pannello Conekta, alla voce Developers > API keys (la pagina contiene un link al pannello). Le chiavi di test e quelle live sono diverse.

Test mode: usa la chiave privata di test. Non viene addebitato denaro reale e il cliente vede TEST MODE — No real charges will be made. nel passaggio Confirm Order. I rimborsi usano sempre la chiave della modalità in cui è stato effettuato il pagamento. Default: on.

Test private key: la chiave API privata della modalità test del tuo account Conekta.

Live private key: la chiave API privata della modalità di produzione del tuo account Conekta. Tienila riservata.

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

Ogni ordine Conekta ricorda la sua modalità: notifiche e rimborsi usano la chiave corrispondente. Mantieni compilate entrambe le chiavi finché restano aperti vecchi ordini di test.

Webhook

Il webhook informa il tuo negozio sui pagamenti, per esempio i pagamenti OXXO o SPEI effettuati dopo che il cliente ha lasciato la pagina di Conekta. Nel pannello Conekta vai su Developers > Webhooks e aggiungi l'URL mostrato in Webhook URL in questa sezione, sia per la modalità test sia per quella live. Per OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_conekta_gateway/webhook, per OpenCart 4 https://your-store/index.php?route=extension/wcp_conekta_gateway/payment/wcp_conekta_gateway.webhook. È generato a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Deve essere raggiungibile da internet.

Seleziona questi eventi (sono elencati anche in questa sezione):

Il corpo del webhook indica solo all'estensione quale ordine Conekta è cambiato. Ogni notifica viene verificata rileggendo l'ordine dalle API di Conekta con la chiave privata della sua modalità; l'intestazione di firma Digest del webhook non viene usata. Le notifiche per ordini Conekta che non sono stati creati da questo negozio per quell'ordine vengono riconosciute e ignorate. Senza il webhook, un ordine viene confermato solo quando il cliente torna nel negozio dopo aver pagato, oppure al successivo tentativo di pagamento dello stesso carrello.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Conekta ha segnalato il pagamento, tramite il webhook o quando il cliente torna; l'ordine viene sempre riletto da Conekta. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: lo stato impostato dopo un pagamento Conekta verificato. Default: Processing.

Awaiting Conekta Payment Status: al cliente è stato emesso un riferimento OXXO o SPEI, e Conekta non ha ancora ricevuto il denaro. Default: Pending.

Conekta Payment On Hold Status: pagato, ma l'importo o la valuta non corrispondono all'ordine, è arrivato un pagamento TEST in modalità live, l'ordine era già stato annullato, oppure il pagamento è solo pre-autorizzato. Una nota spiega il motivo. Default: Pending, perché OpenCart non ha uno stato On hold. Puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui.

Payment Expired / Canceled Status: un ordine in attesa di pagamento il cui riferimento Conekta è scaduto o il cui ordine Conekta è stato annullato. Default: Canceled.

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

Avanzate

Debug log: registra le chiamate API e le notifiche in wc_ckt_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Errori e avvisi vengono sempre registrati, anche quando questo interruttore è disattivato. I log non contengono mai chiavi API o dati di contatto dei clienti. Default: off.

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 e il log. Le transazioni e i rimborsi Conekta e gli ordini vengono sempre conservati, così i vecchi ordini possono ancora essere confermati e rimborsati dopo una reinstallazione. Default: off.

Import / Export

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

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

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Conekta). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to Conekta to complete your payment. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione crea un ordine Conekta per il totale dell'ordine nella valuta dell'ordine, con prodotti, sovrapprezzi, sconti, tasse e spedizione, e invia il cliente al checkout ospitato da Conekta. Nome, e-mail, telefono e indirizzo di spedizione del cliente vengono trasmessi a Conekta, e il pagamento compare nella pagina di Conekta come Order # e il numero dell'ordine. Lì il cliente paga con uno dei metodi consentiti. 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), i dati di fatturazione vengono presi dall'indirizzo di spedizione e dal nome del cliente.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando Conekta lo conferma: l'estensione legge l'ordine dalle API di Conekta quando arriva il webhook e quando il cliente torna. 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. Quando il cliente ha scelto OXXO o SPEI e ha ricevuto un riferimento di pagamento, l'ordine riceve lo stato Awaiting Conekta Payment Status e la pagina di successo mostra Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. Per un ordine in attesa di verifica, la pagina mostra We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again.

Se al ritorno del cliente il pagamento non può ancora essere confermato, una pagina Payment confirmation mostra lo stesso testo e un pulsante Check again. Il webhook imposta lo stato dell'ordine non appena arriva. Su OpenCart 4 il browser non invia la sessione del negozio quando Conekta 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 pagamento viene rifiutato, l'ordine resta senza stato e il cliente torna al checkout con The Conekta payment was not completed. Please try again or choose another payment method. Se il checkout è scaduto o è stato annullato, il messaggio è The Conekta payment has expired or was cancelled. Please try again. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout. Il carrello viene conservato. Ogni nuovo tentativo (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) legge prima i checkout Conekta precedenti del carrello. Un checkout aperto dello stesso ordine con lo stesso importo viene riutilizzato; altrimenti quello precedente viene annullato in Conekta prima di crearne uno nuovo, così un vecchio link non può essere pagato due volte. Se un checkout precedente era già stato pagato, il suo ordine viene confermato invece di addebitare di nuovo. Un carrello viene pagato una sola volta: quando un altro ordine dello stesso carrello ha già un pagamento Conekta o un riferimento OXXO / SPEI emesso, non viene avviato nessun nuovo pagamento e il cliente va alla pagina di successo. Se arriva comunque un secondo pagamento per lo stesso carrello, il suo ordine resta senza stato e l'ordine pagato riceve una nota che invita a rimborsare il duplicato nel pannello Conekta.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso (per esempio il suo riferimento OXXO o SPEI è scaduto, oppure lo hai annullato), Confirm Order rimanda il cliente al checkout con The Conekta payment has expired or was cancelled. Please try again., e il successivo Confirm Order paga un nuovo ordine del carrello. Se l'ordine ha già uno stato e nel frattempo il carrello è cambiato (altri prodotti o quantità), il cliente torna al checkout, e il carrello modificato riceve un nuovo ordine e un proprio pagamento.

Se Conekta non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio The payment could not be started. Please try again in a moment or choose another payment method. I messaggi di validazione di Conekta, come un importo minimo, vengono mostrati così come li invia Conekta. Il motivo tecnico viene scritto nel log.

Il webhook 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 il webhook.

L'estensione accetta pagamenti solo nella pagina di Conekta. Non ha un modulo carta nella pagina di checkout, né carte salvate, abbonamenti, pre-autorizzazione e acquisizione o rate mensili (MSI).

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Conekta e non ha pagato, il pagamento è stato rifiutato, oppure Conekta 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 (default Processing): Conekta ha confermato il pagamento con lo stesso importo e la stessa valuta. Una nota mostra il metodo di pagamento (per esempio il marchio della carta e le ultime quattro cifre, OXXO / contanti o bonifico SPEI), l'ordine Conekta e l'addebito.

Awaiting Conekta Payment Status (default Pending): il cliente ha ricevuto un riferimento di pagamento OXXO o SPEI. L'ordine passa a Order Status After Payment quando Conekta segnala il pagamento.

Conekta Payment On Hold Status (default Pending): l'importo o la valuta ricevuti da Conekta non corrispondono all'ordine, è arrivato un pagamento in modalità test mentre il negozio è in modalità live (non è stato incassato denaro reale), oppure il pagamento è arrivato per un ordine già annullato. La nota lo spiega. Controlla l'ordine, poi evadilo oppure rimborsa il pagamento. Un ordine che in Conekta è solo pre-autorizzato viene anch'esso messo in attesa, con una nota che invita ad acquisirlo o annullarlo nel pannello Conekta.

Payment Expired / Canceled Status (default Canceled): il riferimento OXXO o SPEI di un ordine in attesa è scaduto, oppure il suo ordine Conekta è stato annullato.

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

Un ordine pagato o rimborsato non viene mai retrocesso né riaperto. Se arriva un altro pagamento Conekta per un ordine già pagato, una nota WARNING ti chiede di rimborsarlo nel pannello Conekta.

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

Scheda VibeFox Conekta Gateway

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

Rimborsi

Nella scheda VibeFox Conekta Gateway inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Conekta. Conferma la domanda Refund this amount through Conekta? This cannot be undone. Sono supportati rimborsi totali e parziali. Devi avere il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi sono limitati all'importo e alla valuta effettivamente addebitati da Conekta, quindi in caso di differenza di importo puoi rimborsare fino a quanto ha pagato il cliente, non il totale dell'ordine. Il rimborso va all'ordine Conekta che contiene il pagamento e usa la chiave della modalità in cui è stato effettuato il pagamento, quindi quella chiave deve essere impostata. Se Conekta non accetta il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con importo, modalità, ordine Conekta, ID del rimborso e motivo. Un rimborso totale imposta l'ordine su Refunded Status senza avvisare il cliente e senza riportare i prodotti in magazzino, come un cambio di stato manuale. Un rimborso parziale non modifica lo stato. I rimborsi sono disponibili quando Conekta ha segnalato il pagamento.

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

I rimborsi effettuati nel pannello Conekta arrivano tramite il webhook e vengono aggiunti come nota con l'importo rimborsato in Conekta e in OpenCart. Non vengono registrati automaticamente. Aggiorna l'ordine manualmente senza usare Refund via Conekta. Anche un chargeback segnalato da Conekta viene aggiunto come nota.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Conekta Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Conekta 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-conekta 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 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 lo slot del dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Conekta 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'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato da (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 vengono toccati: 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 un 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

Conekta non compare al checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo, che la chiave privata della modalità corrente sia compilata (Test private key in modalità test, Live private key in modalità live) e che la valuta del checkout sia MXN o USD. La pagina delle impostazioni mostra un avviso quando la chiave manca o la valuta del negozio non è supportata. Verifica inoltre che l'indirizzo di pagamento rientri 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: il webhook non funziona. Nel pannello Conekta verifica che il webhook esista per la modalità che usi (test o live), che il suo URL sia esattamente quello mostrato in Webhook URL e che gli eventi siano selezionati. Verifica che la chiave privata di quella modalità sia impostata, perché ogni notifica viene verificata con essa. L'ordine riceve comunque il suo stato quando il cliente torna nel negozio o quando tenta di pagare di nuovo lo stesso carrello.

Il webhook risponde Temporarily unavailable: non è stato possibile raggiungere le API di Conekta, manca la chiave privata della modalità dell'ordine, l'ordine era in elaborazione da un'altra richiesta, oppure non è stato possibile impostare lo stato dell'ordine. Conekta riprova il webhook. Controlla il campo Log per il motivo.

Il webhook risponde Verification failed, Invalid payload o Invalid order id: le API di Conekta non hanno confermato l'ordine, oppure la notifica non era un evento valido di ordine Conekta.

Il webhook risponde Ignored: la notifica appartiene a un ordine Conekta che non è stato creato da questo negozio per quell'ordine (per esempio un altro negozio o un link di pagamento sullo stesso account), oppure a un oggetto diverso da un ordine.

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

Il cliente vede We could not check the status of your previous payment attempt: il checkout Conekta precedente del carrello non è stato possibile leggerlo, quindi non ne viene creato uno nuovo per evitare un doppio pagamento. Riprova tra poco.

Il cliente vede Payment gateway is not configured: manca la chiave privata della modalità corrente.

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

Il cliente vede Payment verification failed: il link di ritorno da Conekta non corrispondeva all'ordine. Controlla l'ordine nel pannello Conekta; il webhook conferma comunque un pagamento reale.

L'ordine è nello stato in attesa o in sospeso: leggi le Conekta notes nella scheda dell'ordine. Il cliente non ha ancora pagato il riferimento OXXO o SPEI, l'importo o la valuta non corrispondevano, è arrivato un pagamento in modalità test mentre il negozio è in modalità live, oppure il pagamento è solo pre-autorizzato.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: Conekta non ha ancora segnalato il pagamento, è stato rimborsato interamente, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure la chiave privata della modalità del pagamento non è impostata.

Il rimborso fallisce con un messaggio sulla modalità test o live: il pagamento è stato effettuato in quella modalità, e la sua chiave privata non è impostata. Inseriscila e riprova.

Per gli sviluppatori: gli eventi OpenCart wc_ckt_supported_currencies, wc_ckt_order_request, wc_ckt_allowed_payment_methods e wc_ckt_refund_reason permettono ad altre estensioni di modificare le valute supportate, la richiesta d'ordine Conekta, i metodi di pagamento e il motivo del rimborso.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Conekta Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable / Disable, Sort Order, Geo Zone, Total e gli stati dell'ordine della sezione 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 il webhook in modalità manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, metodi di pagamento, modalità test, chiavi private, registrazione) e il log. Se è disattivo, vengono conservate per una successiva reinstallazione. Le transazioni e i rimborsi Conekta vengono sempre conservati, quindi gli ordini pagati in precedenza possono comunque 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 Conekta Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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