VibeFox Yoco for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Valuta del negozio: il rand sudafricano (ZAR) deve essere una valuta attiva in System > Localisation > Currencies. Yoco accetta solo ZAR. Quando il cliente paga in un'altra valuta, il metodo di pagamento viene nascosto al checkout. L'importo dell'ordine deve essere di almeno R2.00.

Account Yoco: un account Yoco con pagamenti online. Ti servono le sue chiavi segrete, che trovi nello Yoco Business Portal sotto Selling Online > Payment Gateway. Si inseriscono solo le chiavi segrete. Il webhook viene registrato dall'estensione, e il suo segreto di firma viene compilato per te.

Sito pubblico: Yoco invia webhook al tuo negozio, quindi deve essere raggiungibile da internet.

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

Installazione

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

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Yoco Pay Gateway e fai clic su Install (il pulsante verde +). Il tuo utente amministratore deve avere il permesso di modificare l'elenco delle estensioni di pagamento.

3. Fai clic su Edit (il pulsante con la matita) per aprire la pagina delle impostazioni. Inserisci la tua chiave di licenza VibeFox in License key, nel blocco della licenza in cima alla pagina, e fai clic su Activate (vedi License key).

4. Incolla la chiave segreta di test (sk_test_...) e, quando sei pronto, la chiave segreta di produzione (sk_live_...). Fai clic su Save. Il webhook viene registrato per ogni modalità che ha una chiave.

5. Attiva Enable/Disable e fai clic su Save. Effettua un pagamento di prova con una carta di test Yoco mentre Test mode è attiva, poi disattiva Test mode per accettare pagamenti reali.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_yoco_pay.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. Fai clic su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox Yoco Pay Gateway, fai clic su Install (il pulsante verde +), poi su Edit (il pulsante a matita).

4. Inserisci la chiave di licenza e le chiavi Yoco come nei passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia solo l'URL del webhook (vedi Webhook); viene registrato presso Yoco al salvataggio nello stesso modo.

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

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Sopra le impostazioni la pagina mostra la modalità attiva (Test mode: the test secret key is used, no real money is charged. oppure Live mode: real payments are accepted.). Ti avvisa se la valuta predefinita del negozio non è ZAR (in tal caso Yoco viene proposto solo quando il cliente paga in ZAR, o non viene proposto affatto se nessuna valuta ZAR è attiva) e se la modalità corrente non ha una chiave segreta, per esempio Enter the test secret key to offer Yoco at checkout (test mode).

Al salvataggio, Title può avere al massimo 128 caratteri, Sort Order deve essere un numero intero (sono ammessi valori negativi), Total deve essere un numero pari o superiore a 0, e la zona geografica e gli stati dell'ordine devono esistere. Altrimenti non viene salvato nulla e la pagina indica il campo. Poi l'estensione verifica le chiavi e i segreti dei webhook e registra i webhook. I messaggi in merito compaiono sopra le impostazioni.

Yoco

Enable/Disable: Enable Yoco attiva o disattiva il metodo di pagamento. Predefinito: off.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento memorizzato nell'ordine. Predefinito: Card or Instant EFT (Yoco). Fino a 128 caratteri; se è vuoto, i clienti vedono Card or Instant EFT (Yoco).

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

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

Geo Zone: proponi Yoco solo per gli indirizzi di pagamento nella zona geografica selezionata. Predefinito: All zones. Le zone geografiche si impostano in System > Localisation > Geo Zones.

Total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga proposto Yoco. Lascialo vuoto per proporre Yoco per qualsiasi totale. Yoco stesso richiede sempre almeno R2.00.

Chiavi API

Copia le chiavi segrete dallo Yoco Business Portal sotto Selling Online > Payment Gateway (la sezione contiene i collegamenti). Yoco ha un'unica API per entrambe le modalità: è la chiave a decidere se un pagamento è di prova o reale. La modalità di test usa solo la chiave di test, la modalità di produzione solo la chiave di produzione.

Test mode: usa la chiave segreta di test. Non viene addebitato denaro reale; paga con le carte di test Yoco. Predefinito: on. Disattivalo per accettare pagamenti reali. Finché è attiva, i clienti vedono Test mode — use a Yoco test card; no real money is charged. nel passaggio Confirm Order.

Test secret key: la chiave segreta della modalità di test. Inizia con sk_test_.

Live secret key: la chiave segreta della modalità di produzione. Inizia con sk_live_.

Una chiave che non inizia con il prefisso previsto non viene salvata: la pagina mostra un errore, per esempio Yoco: the test secret key must start with sk_test_ — the previous value was kept. Le altre impostazioni vengono salvate. Se Yoco segnala durante la registrazione del webhook che una chiave appartiene all'altra modalità, la pagina te lo dice.

Le chiavi e i segreti salvati 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 modificarlo. Per rimuovere un valore salvato, spunta Clear the saved value sotto il campo e fai clic su Save.

Webhook

Yoco conferma pagamenti e rimborsi all'URL mostrato in Webhook URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_yoco_pay/webhook, su OpenCart 4 questo: https://your-store/index.php?route=extension/wcp_yoco_pay/payment/wcp_yoco_pay.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Non devi creare il webhook nel portale Yoco. Al salvataggio delle impostazioni, l'estensione registra l'URL presso Yoco per ogni modalità che ha una chiave segreta ma non un segreto del webhook, e memorizza il segreto di firma nel campo di quella modalità. Registra di nuovo l'URL quando cambiano la chiave segreta di quella modalità o l'URL del webhook. Quando l'URL cambia, la vecchia registrazione viene rimossa.

Per ogni modalità (Test e Live) la sezione mostra lo stato del webhook:

L'estensione gestisce questi eventi (sono elencati anche in questa sezione):

I webhook senza firma valida vengono rifiutati. Un evento deve essere firmato con il segreto della modalità in cui è stato effettuato il pagamento, quindi un segreto di test non conferma mai un pagamento reale.

Test webhook secret: compilato automaticamente quando il webhook viene registrato. Incolla un segreto (whsec_...) solo se hai registrato tu l'URL del webhook.

Live webhook secret: compilato automaticamente quando il webhook viene registrato. Svuotalo e salva per registrare di nuovo il webhook.

Un segreto del webhook deve avere la forma whsec_ seguita da testo in base64. Qualsiasi altro valore non viene salvato, e resta quello precedente. Svuotare un segreto del webhook e salvare registra di nuovo il webhook.

Ordini

OpenCart crea l'ordine al passaggio Confirm Order senza stato (un ordine mancante). L'ordine riceve uno stato solo dopo che Yoco ha confermato il pagamento tramite API. Ciascuno dei campi seguenti elenca i tuoi stati d'ordine OpenCart.

Paid Order Status: lo stato dopo un pagamento confermato. Predefinito: Processing.

On Hold Status: un pagamento il cui importo o la cui valuta non corrisponde al totale dell'ordine mette l'ordine in questo stato, con una nota. Un pagamento successivo con l'importo corretto lo risolve. Predefinito: Pending, perché OpenCart non ha lo stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Refunded Status: impostato quando i rimborsi raggiungono l'importo pagato. Predefinito: Refunded.

Avanzate

Debug log: scrive richieste e webhook di Yoco in yoco_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs, su OpenCart 4 system/storage/logs). Il file non può essere aperto dal web e, al raggiungimento di 5 MB, viene spostato in yoco_p_debug.old.log.php. Errori e avvisi, come richieste fallite a Yoco e webhook rifiutati, vengono sempre registrati. Chiavi, segreti dei webhook e indirizzi e-mail sono mascherati. Predefinito: off.

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

Delete data: se attivo, disinstallare l'estensione rimuove le impostazioni del gateway, il registro e i webhook che l'estensione ha registrato presso Yoco. I dati degli ordini (ID dei checkout e dei pagamenti Yoco, rimborsi) vengono sempre conservati, perché sono necessari per i rimborsi. Predefinito: off.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Le chiavi segrete e i segreti dei webhook non vengono esportati.

Import: incolla un JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni. I segreti salvati vengono mantenuti, e nessun webhook viene registrato da un'importazione.

Checkout

Il metodo di pagamento viene mostrato quando il cliente paga in ZAR e l'importo dell'ordine è di almeno R2.00. Al passaggio Payment Method il cliente lo sceglie (per impostazione predefinita Card or Instant EFT (Yoco)). Al passaggio Confirm Order il cliente vede la tua descrizione. OpenCart crea l'ordine in questo passaggio, ancora senza stato. 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 del checkout. Quando il cliente fa clic su Confirm Order, l'estensione crea un checkout Yoco per il totale dell'ordine in centesimi e invia il cliente alla pagina di pagamento Yoco, dove paga con carta o Instant EFT.

Dopo il pagamento il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando Yoco lo conferma: l'estensione chiede il checkout a Yoco quando il cliente torna e di nuovo quando arriva il webhook firmato. Poi l'ordine riceve 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 Yoco has been received. Se Yoco non ha ancora confermato il pagamento quando il cliente torna, una pagina Payment confirmation mostra We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. con i pulsanti Check again e Back to checkout; il webhook imposta lo stato dell'ordine non appena arriva. Su OpenCart 4, quando il cliente torna dalla pagina di Yoco, una breve pagina intermedia riapre l'indirizzo di ritorno del tuo negozio, così il carrello e l'accesso del cliente vengono conservati.

Se il cliente annulla sulla pagina di Yoco, torna al checkout con The Yoco payment was cancelled. Your cart is saved — you can pay again or choose another payment method. Se il pagamento non va a buon fine, il messaggio è The Yoco payment was not successful. Please try again or choose another payment method., e viene aggiunta una nota all'ordine. Il carrello viene conservato. Su OpenCart 4 questi messaggi sono mostrati sopra la pagina del checkout.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 aggiorna l'ordine del checkout. Prima di un nuovo pagamento l'estensione controlla il carrello: se un altro ordine dello stesso carrello è già pagato, il cliente va direttamente alla pagina di successo. I checkout Yoco non pagati di questo ordine e del carrello delle ultime 24 ore vengono prima verificati presso Yoco; se nel frattempo uno è stato pagato, viene confermato quel pagamento invece di crearne uno nuovo. Se il checkout aperto dello stesso ordine è per lo stesso importo e modalità ed è stato creato meno di 30 minuti fa, il cliente riceve di nuovo la stessa pagina Yoco. Altrimenti viene creato un nuovo checkout Yoco. Una modifica del carrello, incluso un nuovo quantitativo, conta come un nuovo carrello che richiede un pagamento proprio.

Su OpenCart 4 l'ordine resta nel checkout fino alla visualizzazione della pagina di successo, quindi dopo un pagamento non riuscito o annullato il cliente paga di nuovo lo stesso ordine. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio l'hai annullato), il cliente torna 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.

Se Yoco non riesce ad avviare il pagamento, il cliente resta al passaggio Confirm Order con Yoco could not start the payment. Please try again in a moment or choose another payment method. sopra il pulsante, e il motivo viene scritto nel registro e nelle note dell'ordine. Un ordine sotto R2.00 riceve Yoco requires an order total of at least R2.00.

Il webhook funziona anche mentre il negozio è in modalità manutenzione, perché OpenCart lascia passare le richieste delle estensioni di pagamento. Su OpenCart 4 un'azione di avvio dell'estensione lascia passare il webhook e il ritorno del cliente.

I pagamenti vengono addebitati immediatamente sulla pagina di Yoco. L'estensione non prevede carte salvate, abbonamenti o pagamenti ricorrenti, né un modulo di pagamento con carta nel negozio, né autorizzazione e cattura separate, e non funziona con valute diverse da ZAR.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Yoco e non ha pagato, ha annullato sulla pagina di Yoco, oppure Yoco non ha ancora confermato il pagamento. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders. Su OpenCart 4.1 a questo ordine può essere assegnato anche lo stato Voided, che OpenCart imposta quando il passaggio di conferma viene mostrato di nuovo; l'estensione lo considera un ordine senza stato.

Paid Order Status (predefinito Processing): il pagamento è stato confermato. Una nota mostra l'importo, gli ID di pagamento e di checkout Yoco, la modalità e come è stato confermato il pagamento (il ritorno del cliente, il webhook o un controllo prima di un nuovo tentativo di pagamento).

On Hold Status (predefinito Pending): Yoco ha comunicato un importo o una valuta diversi dal totale dell'ordine, per esempio perché il carrello è stato modificato in un'altra scheda dopo l'avvio del pagamento. La nota lo spiega, e il cliente vede We received your payment and are reviewing it. We will contact you if anything else is needed. Controlla il pagamento prima della spedizione. Se il cliente paga poi l'importo corretto con un altro tentativo, l'ordine passa a Paid Order Status.

Refunded Status (predefinito Refunded): i rimborsi hanno raggiunto l'importo pagato.

Se arriva un pagamento per un ordine con un altro stato, per esempio annullato o rimborsato, l'ordine non viene modificato. Una nota ti chiede di rimborsare il pagamento nel portale Yoco o di ripristinare l'ordine manualmente. Il cliente vede Your payment was received after the order had been cancelled. Please contact us — do not pay again.

Se arriva un secondo pagamento per un ordine già pagato, o per un altro ordine di un carrello già pagato, l'ordine non viene modificato. Una nota sull'ordine pagato ti chiede di rimborsarlo nel portale Yoco.

Le note sono voci della History dell'ordine che il cliente non vede. Iniziano con la parola Yoco.

Scheda VibeFox Yoco Pay Gateway

In Sales > Orders apri un ordine pagato con Yoco. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Yoco Pay Gateway mostra il Checkout ID, il Payment ID, il Mode (con l'etichetta Test per i pagamenti di prova), lo Status, gli importi Paid / refunded, il modulo di rimborso, la tabella Yoco checkouts of this order, la cronologia dei Refunds e le Yoco notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox Yoco Pay Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e fai clic su Refund via Yoco. Conferma la domanda Refund this amount through Yoco? 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 calcolati sull'importo addebitato da Yoco, quindi puoi rimborsare al massimo quello che il cliente ha effettivamente pagato, anche se l'ordine è stato modificato in seguito. Il rimborso viene inviato nella modalità in cui è avvenuto il pagamento (test o produzione), quindi la chiave segreta di quella modalità deve essere impostata. Un rimborso ripetuto dopo una risposta persa non viene pagato due volte.

Un rimborso riuscito viene aggiunto alla cronologia dei rimborsi e alle note con l'ID del rimborso Yoco. Quando i rimborsi raggiungono l'importo pagato, l'ordine riceve il Refunded Status senza avvisare il cliente e senza rimettere i prodotti in magazzino; un rimborso parziale non cambia lo stato. Se Yoco rifiuta il rimborso, la scheda mostra Yoco refused the refund: con il motivo, e nessun rimborso viene registrato. Se Yoco segnala il rimborso come in attesa, la scheda lo indica. Non ripeterlo: verrà registrato quando Yoco lo confermerà tramite webhook. I rimborsi sono disponibili per gli ordini pagati con un checkout Yoco. Un ordine in On Hold Status non ha un pagamento confermato da rimborsare; rimborsalo nel portale Yoco.

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

I rimborsi effettuati nel portale Yoco arrivano tramite il webhook refund.succeeded e vengono registrati nella cronologia dei rimborsi e nelle note. Quando raggiungono l'importo pagato, l'ordine riceve il Refunded Status. Un rimborso superiore all'importo che resta da rimborsare non viene registrato, e una nota ti chiede di controllare l'ordine. Un rimborso fallito aggiunge una nota che indica che il denaro non è stato restituito al cliente.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Yoco Pay Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit, sopra le impostazioni. Inserisci la chiave in License key e fai clic su Activate. Dopo, 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 ci sono la riga Product: opencart-payment-yoco 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 oppure License expired on seguito da una data. Dopo che l'indirizzo del negozio è cambiato, o dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un dominio: l'indirizzo del negozio nella configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Yoco non viene mostrato ai clienti al checkout. Se comunque un pagamento viene avviato, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore connesso al pannello nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso dell'amministratore, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: 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 dell'amministrazione o la pagina Edit: 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

Yoco non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità corrente abbia una chiave segreta: Test secret key in modalità di test, Live secret key in modalità di produzione. Il cliente deve pagare in ZAR, e il totale dell'ordine deve essere di almeno R2.00. La pagina delle impostazioni mostra un avviso quando la chiave manca o la valuta del negozio non è ZAR. Verifica 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: il webhook non funziona. Apri la sezione Webhooks delle impostazioni e controlla lo stato della modalità che usi. Se non è registrato, o è registrato per un altro URL, salva le impostazioni. Se la registrazione fallisce, la pagina mostra il motivo. Se hai inserito tu il segreto, verifica che appartenga al webhook di questo URL e di questa modalità. L'ordine riceve comunque il suo stato quando il cliente torna nel negozio dopo aver pagato, e quando il cliente prova di nuovo a pagare.

Impossibile registrare il webhook: i pagamenti vengono comunque confermati quando i clienti tornano nel negozio. Correggi il motivo mostrato nel messaggio, per esempio che il negozio deve essere raggiungibile da internet, e salva di nuovo. Puoi anche registrare tu l'URL e incollare il segreto di firma.

I webhook vengono rifiutati: i webhook rifiutati vengono scritti nel registro. webhook secret not configured significa che non è impostato alcun segreto del webhook. invalid signature significa che il segreto appartiene a un'altra registrazione o modalità. timestamp outside the tolerance significa che l'orologio del server è errato: le firme vengono accettate entro 5 minuti dall'ora del server. checkout not completed yet — retry e could not confirm the checkout with Yoco — retry sono temporanei; Yoco rinvia il webhook.

L'URL del webhook mostra solo POST nel browser: è normale. L'URL accetta solo richieste da Yoco.

Errore al salvataggio The secret key must start with sk_test_ / sk_live_: una chiave è stata incollata nel campo sbagliato. La chiave di test inizia con sk_test_, quella di produzione con sk_live_. Il valore precedente è stato mantenuto.

Il cliente vede un errore dopo Confirm Order: controlla il campo Log nella pagina dell'estensione. Yoco is not available at the moment. Please choose another payment method. significa che la modalità corrente non ha una chiave segreta.

Al cliente viene detto che un pagamento deve essere controllato: un tentativo è stato pagato con un importo diverso, oppure dopo l'annullamento dell'ordine. Leggi le note nella scheda VibeFox Yoco Pay Gateway e evadi l'ordine oppure rimborsa il pagamento nel portale Yoco.

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

Il rimborso fallisce con No answer from Yoco: nel negozio non è stato registrato nulla. Se Yoco ha comunque elaborato il rimborso, ripeti lo stesso rimborso: non verrà rimborsato due volte.

Per gli sviluppatori: prima della creazione del checkout Yoco, l'estensione attiva l'evento di OpenCart yoco_p_checkout_payload con i dati della richiesta e l'ordine, così un'altra estensione può aggiungere dati alla richiesta.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox Yoco Pay 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. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che in modalità manutenzione lascia passare il webhook e il ritorno del cliente). Se Delete data è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità di test, chiavi, segreti dei webhook, registrazione), il registro e i webhook che l'estensione ha registrato presso Yoco. Se è disattivo, vengono conservati per una reinstallazione successiva. I checkout e i rimborsi Yoco vengono sempre conservati, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti mantengono le proprie note di pagamento.

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

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