VibeFox Redsys for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Account commerciante Redsys: la tua banca (l'acquirer che ti ha fornito il POS virtuale Redsys) ti fornisce il codice commerciante (FUC), il numero del terminale e l'accesso al pannello di amministrazione Redsys, dove viene mostrata la chiave segreta SHA-256 di ciascun ambiente. La chiave dell'ambiente di test è diversa da quella reale. La notifica online (HTTP) deve essere attiva per il tuo terminale. Se non sei sicuro, chiedi alla banca.

Valuta: una delle valute supportate dall'estensione (vedi Configurazione), e il tuo terminale Redsys deve essere abilitato dalla banca per quella valuta. La maggior parte dei terminali accetta solo EUR.

Negozio raggiungibile: Redsys deve poter raggiungere il tuo negozio da internet, senza login o blocchi del firewall, per consegnare le notifiche di pagamento.

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_redsys_gateway-oc3-(versione).ocmod.zip e il pacchetto per OpenCart 4 wcp_redsys_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_redsys_gateway-oc3-(versione).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 Redsys 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 Chiave di licenza).

4. Inserisci il tuo codice commerciante, il terminale e la chiave segreta di ciascun ambiente (vedi Configurazione).

5. Attiva Enable/Disable e clicca su Save. Prova un pagamento con Test Mode attivo, poi disattiva Test Mode per accettare pagamenti reali.

OpenCart 4

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

4. Inserisci la chiave di licenza e i dati Redsys 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 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 Redsys 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 ti avvisa quando il codice commerciante manca o non è composto solo da cifre, quando una chiave segreta non è una chiave SHA-256 Redsys valida, quando la chiave della modalità corrente è vuota (il metodo di pagamento viene quindi nascosto al checkout) e quando la valuta predefinita del negozio non è supportata. Mentre la modalità test è attiva, mostra Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged.

Al salvataggio, Title deve avere da 1 a 128 caratteri (Enter a title for the payment method (1 to 128 characters).), Sort Order deve essere un numero intero (sono ammessi i negativi), Total deve essere un numero maggiore o uguale a 0, e la zona geografica e ogni stato dell'ordine devono esistere. In caso contrario non viene salvato nulla.

Redsys

Enable/Disable: Enable Redsys Gateway 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: Credit/Debit Card (Redsys). Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely with your credit or debit card via Redsys.

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

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

Total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga offerto Redsys: un numero maggiore o uguale a 0. Lascialo vuoto per offrire Redsys per qualsiasi totale.

Account Redsys

La banca ti fornisce il codice commerciante (FUC), il terminale e l'accesso al pannello di amministrazione Redsys, dove viene mostrata la chiave segreta SHA-256 di ciascun ambiente. La sezione include un link al pannello di amministrazione Redsys.

Merchant Code (FUC): il tuo codice commerciante Redsys, fino a 9 cifre. Tutto ciò che non è una cifra viene rimosso al salvataggio.

Terminal Number: il numero di terminale assegnato dalla banca, fino a 3 cifre. Predefinito: 1. Un campo vuoto viene salvato come 1.

Secret Key (SHA-256) — live: la chiave SHA-256 in Base64 dell'ambiente reale (di produzione), di solito di 32 caratteri. Viene usata quando la modalità test è disattivata.

Modalità test (SIS-T)

L'ambiente di test di Redsys ha una propria chiave segreta. La sezione mostra i dati pubblici di test di Redsys: codice commerciante 999008881, terminale 1, chiave sq7HjrUOBfKmC576ILgskD5srU870gJ7, carta 4548 8100 0000 0003, scadenza 12/49, CVV 123. In modalità test non viene addebitato denaro reale.

Test Mode: pagamenti e rimborsi vanno all'ambiente di test di Redsys (SIS-T) e sono firmati con la chiave di test. Predefinito: attivo. Disattivalo per accettare pagamenti reali. Finché è attivo, i clienti vedono TEST MODE: Redsys test environment, no real money is charged. nel passaggio Confirm Order.

Secret Key (SHA-256) — test: la chiave SHA-256 in Base64 dell'ambiente di test. Usa la tua chiave di test o la chiave pubblica di test indicata sopra.

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 se vuoi modificarlo. Per rimuovere una chiave salvata, spunta Clear saved secret on save sotto il campo e clicca su Save.

Pagina di pagamento e ordini

Commerce Name: il nome del negozio mostrato nella pagina di pagamento Redsys, al massimo 25 caratteri. Predefinito: il nome del tuo negozio, troncato a 25 caratteri.

Order Status After Payment: lo stato che riceve un ordine pagato.

Differenze di importo o di valuta, pagamenti di test mentre la gateway è in modalità live e pagamenti di tentativi annullati ricevono sempre lo On hold (review) status.

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo la notifica firmata di Redsys. Un pagamento rifiutato o annullato lascia l'ordine senza stato; il cliente torna al checkout con il carrello conservato. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Processing status: usato quando Order Status After Payment è Processing. Predefinito: In lavorazione.

Completed status: usato quando Order Status After Payment è Completed. Predefinito: Completato.

On hold (review) status: per i pagamenti che richiedono la tua revisione (vedi sopra), oppure per ogni ordine pagato quando Order Status After Payment è On hold (review). Predefinito: In attesa, perché OpenCart non ha uno stato On hold; una nota sull'ordine spiega il motivo. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Refunded status: impostato quando il pagamento Redsys viene rimborsato per intero dalla pagina dell'ordine. Predefinito: Rimborsato.

Notifiche di pagamento

Notification URL: Redsys comunica ogni pagamento a questo indirizzo del tuo negozio. È mostrato in questa sezione. Su OpenCart 3 ha questo aspetto https://your-store/index.php?route=extension/payment/wcp_redsys_gateway/notify, su OpenCart 4 quello https://your-store/index.php?route=extension/wcp_redsys_gateway/payment/wcp_redsys_gateway.notify. È costruito a partire dall'indirizzo del negozio della tua installazione di OpenCart. L'estensione lo invia a Redsys con ogni pagamento, quindi non c'è nulla da copiare nel pannello Redsys. La notifica online (HTTP) deve essere attiva per il tuo terminale. Chiedi alla banca se nessun ordine viene confermato dopo un pagamento riuscito. Le notifiche senza una firma valida vengono rifiutate. Senza la notifica, l'ordine non riceve mai uno stato.

Avanzate

Debug log: scrive i dettagli di pagamenti, notifiche e rimborsi in rdsg_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web e, a 5 MB, viene spostato in una copia vecchia. Gli errori vengono sempre registrati, anche quando questa opzione è disattivata. Chiavi, firme e dati della carta non vengono mai registrati. Predefinito: disattivato.

Log: mostra la dimensione e le voci più recenti del registro. Clicca su Clear log per svuotarlo.

Delete Data: se attivo, la disinstallazione dell'estensione rimuove le impostazioni del gateway e il registro. I registri di pagamento Redsys degli ordini (necessari per i rimborsi) restano sempre. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni come file JSON. Le chiavi segrete non vengono esportate.

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

Valute supportate

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD. Il metodo di pagamento viene nascosto quando la valuta del cliente non è in questo elenco.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit/Debit Card (Redsys)). Nel passaggio Confirm Order il cliente vede la tua descrizione. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente clicca su Confirm Order, l'estensione prepara un modulo di pagamento firmato, il cliente vede Redirecting to Redsys for payment. Please wait... e passa alla pagina di pagamento Redsys della tua banca. Se il browser non prosegue da solo, il cliente clicca su Pay via Redsys. 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.

Sulla pagina Redsys il cliente paga con carta tramite 3-D Secure, oppure con Bizum o un altro metodo che la tua banca ha attivato per il terminale. La pagina usa la lingua del cliente (spagnolo, inglese, catalano, francese, tedesco, italiano, portoghese e altre), oppure l'inglese per le altre lingue. L'importo è il totale dell'ordine nelle unità minime della valuta dell'ordine, per esempio EUR 43,45 come 4345; JPY e CLP non hanno decimali. Il pagamento viene descritto come Order con il numero dell'ordine e il nome del tuo negozio.

Dopo il pagamento, il cliente torna al tuo negozio. Il ritorno in sé non segna nulla come pagato. L'ordine viene segnato come pagato solo quando Redsys lo conferma con la notifica firmata. 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 conferma ordine di OpenCart con Your payment with Redsys has been received. Se l'ordine ha ricevuto lo On hold (review) status, la pagina mostra Your payment with Redsys has been received and is being reviewed by the store. Se la notifica non è ancora arrivata, appare una pagina Payment confirmation con Redsys is confirming your payment. If you completed the payment, your order will be confirmed in a few moments — please do not pay again. e i pulsanti Check again e Back to checkout.

Se il cliente annulla o Redsys rifiuta il pagamento, Redsys riporta il cliente al checkout con The Redsys payment was not completed. You can try again or choose another payment method. Il carrello viene conservato e il cliente può pagare di nuovo. Ogni nuovo tentativo riceve un nuovo numero d'ordine Redsys, e un pagamento effettuato da uno di essi, per esempio da una seconda scheda del browser, viene comunque riconosciuto. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; se un altro ordine dello stesso carrello è già pagato, il cliente va direttamente alla pagina di successo, e un pagamento tardivo dell'altro ordine non viene applicato.

Su OpenCart 4 il messaggio sul pagamento non completato compare sopra la pagina del checkout. OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna, quindi dopo un annullamento o un pagamento rifiutato il cliente paga lo stesso ordine con un nuovo numero d'ordine Redsys. Se nel frattempo quell'ordine è stato chiuso, il cliente torna al checkout con Your previous order was closed without a payment. Please confirm the order again to pay with a new order. oppure, se aveva un pagamento Redsys, con Your order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. Il successivo Confirm Order paga un nuovo ordine. Se l'ordine del checkout è già pagato ma il carrello è cambiato da allora, anche con una nuova quantità, il cliente torna al checkout e il nuovo carrello viene pagato con un nuovo ordine.

Se il pagamento non può essere inviato a Redsys, il cliente resta al passaggio Confirm Order con un breve messaggio: Redsys payments are not configured correctly. Please choose another payment method or contact us., un messaggio che indica che i pagamenti in quella valuta non sono accettati, oppure The order total must be greater than zero.

La notifica e il ritorno del cliente funzionano anche mentre il negozio è in modalità manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, mentre su OpenCart 4 l'estensione aggiunge per esse un'azione di avvio.

L'estensione gestisce solo pagamenti una tantum, autorizzati e acquisiti subito nella pagina di Redsys. Non prevede un modulo carta sul tuo sito (InSite o iframe), carte salvate, pagamenti con un clic o tokenizzazione, abbonamenti o pagamenti ricorrenti, preautorizzazione con acquisizione successiva né link di pagamento per gli ordini creati nell'amministrazione.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Redsys e non ha pagato, il pagamento è stato rifiutato o annullato, oppure la notifica di Redsys non è ancora arrivata. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Processing, Completed o On hold (review): il pagamento è stato confermato. Lo stato segue Order Status After Payment. Una nota mostra il numero d'ordine Redsys (Ds_Order), il codice di autorizzazione e il codice di risposta, contrassegnati [TEST] per i pagamenti di test.

On hold (review) dopo il pagamento: Redsys ha segnalato un importo o una valuta diversi dal totale dell'ordine, è arrivato un pagamento di test mentre la gateway era in modalità live (non è stato addebitato denaro reale), oppure il cliente ha pagato dopo aver annullato quel pagamento sulla pagina di Redsys. La nota lo spiega. Controlla il pagamento nel pannello di amministrazione Redsys, poi elabora l'ordine o rimborsa il pagamento.

Refunded status: il pagamento è stato rimborsato per intero tramite l'estensione.

Un pagamento rifiutato non modifica mai un ordine che ha già uno stato. Per i codici di risposta più frequenti, il registro e le note danno un motivo breve, come Insufficient funds, Card expired o Cancelled by the customer. Se per un ordine o un carrello già pagato arriva un secondo pagamento diverso, l'ordine non cambia. Una nota ti chiede di rimborsare il pagamento duplicato nel pannello di amministrazione Redsys. Se Redsys segnala che un pagamento è ancora in corso, viene aggiunta una nota e l'ordine attende l'esito definitivo.

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

Scheda VibeFox Redsys Gateway

In Sales > Orders apri un ordine pagato con Redsys. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox Redsys Gateway mostra il Redsys order number (Ds_Order), l'Authorisation code / response, l'Environment (live o test) con l'etichetta Test mode, lo Status del pagamento, Paid / refunded, un suggerimento di revisione per gli ordini in attesa, il modulo di rimborso, lo storico dei rimborsi, le Redsys notes dell'ordine e i Redsys order numbers issued for this cart. La scheda è mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via Redsys. Conferma la domanda Refund this amount through Redsys? This cannot be undone. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare gli ordini (Sales > Orders, impostato in System > Users > User Groups). I rimborsi vengono eseguiti nell'importo e nella valuta addebitati da Redsys; quindi, dopo una differenza di importo o valuta, puoi rimborsare fino a quanto il cliente ha realmente pagato, non fino al totale dell'ordine. Il rimborso viene inviato tramite le API REST di Redsys all'ambiente in cui è stato effettuato il pagamento (test o live), firmato con la chiave di quell'ambiente, e viene verificata la firma della risposta. Se Redsys non accetta il rimborso, la scheda mostra l'errore e nessun rimborso viene registrato. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note, con il numero d'ordine Redsys e il motivo. Un rimborso totale imposta l'ordine sul Refunded status senza notificare il cliente e senza restituire i prodotti al magazzino, come un cambio manuale di stato. Un rimborso parziale non cambia lo stato.

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

I rimborsi effettuati nel pannello di amministrazione Redsys non vengono registrati come rimborsi dell'estensione. Quando Redsys invia una notifica per essi, all'ordine viene aggiunta una nota. Lo stato dell'ordine non cambia automaticamente.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox ottenuta su vibefox.net. Il blocco della licenza License — VibeFox Redsys Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Redsys 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-redsys 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 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, Redsys 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 come (unlicensed — visible to admins only), così puoi configurare e testare 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, compare un promemoria sulla Dashboard dell'amministrazione. 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 un 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 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

Redsys non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che codice commerciante e terminale siano compilati e che la modalità corrente abbia una chiave valida: Secret Key (SHA-256) — test in modalità test, Secret Key (SHA-256) — live in modalità live. Controlla che la valuta del cliente sia nell'elenco delle valute supportate. La pagina delle impostazioni mostra un avviso per ciascuno di questi problemi. 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: la notifica di Redsys non è arrivata al tuo negozio. Chiedi alla banca di verificare che la notifica online (HTTP) sia attiva per il tuo terminale. Controlla che l'indirizzo mostrato in Notification URL sia raggiungibile da internet senza login o blocchi del firewall. Attiva Debug log e consulta il campo Log nella pagina dell'estensione.

La notifica risponde Forbidden: la firma non corrisponde alla chiave segreta dell'ambiente in cui è stato avviato il pagamento, oppure il codice commerciante nella notifica non è il tuo. Verifica che le chiavi segrete e il codice commerciante nelle impostazioni siano quelli del tuo terminale.

La notifica risponde Order not found: la notifica era firmata correttamente, ma nessun ordine di questo negozio usa quel numero d'ordine Redsys.

La notifica risponde Busy: il carrello era in elaborazione da un'altra notifica nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Redsys ritenta la notifica. Il registro mostra il motivo.

La notifica risponde Bad request: la richiesta non conteneva parametri Redsys o li conteneva non validi. Non è arrivata da Redsys nel formato previsto.

L'ordine è nello stato on hold dopo il pagamento: leggi le note nella scheda VibeFox Redsys Gateway (vedi Stati dell'ordine), poi elabora l'ordine o rimborsa il pagamento.

I pagamenti di test non confermano gli ordini in modalità live: un pagamento di test non paga mai un ordine finché Test Mode è disattivato. L'ordine viene invece messo in attesa con una nota. Usa la modalità test con la chiave di test per i pagamenti di prova.

Il rimborso non riesce: leggi l'errore. Redsys refund: the merchant code or the TEST secret key is not configured. (o LIVE) indica che manca la chiave dell'ambiente del pagamento. I codici di errore Redsys sono spiegati nel messaggio, per esempio SIS0057 (l'importo supera quanto resta del pagamento), SIS0056 (pagamento originale non trovato: altro ambiente o terminale), SIS0042 (errore di firma: controlla la chiave di questo ambiente), SIS0026 (codice commerciante o terminale sconosciuto) e SIS0027 (valuta non configurata per il terminale). Se Redsys non è raggiungibile, il rimborso non viene effettuato. Riprova più tardi.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo, per esempio che l'ordine non ha un pagamento Redsys confermato, che è rimborsato per intero, o che il tuo gruppo utenti non ha il permesso di modificare gli ordini.

Per gli sviluppatori: l'estensione attiva gli eventi OpenCart wcp_redsys_gateway/merchant_parameters (i parametri del pagamento e l'ordine) e wcp_redsys_gateway/currency_codes (l'elenco delle valute supportate). Aggiungi una valuta solo se la tua banca l'ha abilitata per il terminale.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Redsys 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 i quattro stati dell'ordine, 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 fa passare la notifica e il ritorno del cliente in modalità manutenzione). Se Delete Data è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, codice commerciante, terminale, chiavi, modalità test, nome commerciale, stato dell'ordine dopo il pagamento, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. I registri di pagamento e i rimborsi Redsys vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche 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, clicca su Uninstall (il pulsante arancione −) accanto a VibeFox Redsys Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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