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

Valuta: l'ordine deve essere in PLN, EUR, GBP o CZK. Con altre valute il metodo di pagamento non viene mostrato al checkout. L'ordine viene addebitato nella sua valuta; l'estensione non converte le valute.

Account Przelewy24: ti serve un account commerciante Przelewy24 con i relativi dati API: il Merchant ID, la chiave API (chiamata report key nel pannello Przelewy24), la CRC key e, se il tuo negozio ha un proprio ID, il POS ID (Shop ID). Li trovi nel pannello commerciante di Przelewy24 su panel.przelewy24.pl, in My data > API data and configuration. Le chiavi sandbox provengono da un account sandbox separato, su sandbox.przelewy24.pl/panel. Nel pannello Przelewy24 non serve configurare altro: l'estensione invia il proprio URL di notifica con ogni pagamento. Il tuo negozio deve essere raggiungibile da internet, perché Przelewy24 gli invia le notifiche di pagamento.

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_przelewy24_payment-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_przelewy24_payment.ocmod.zip. Installa solo il pacchetto per la tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nell'amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_przelewy24_payment-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 Przelewy24 Payment 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 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 fai clic su Activate (vedi Chiave di licenza).

4. Inserisci le chiavi sandbox (Merchant ID, chiave API, CRC key; il POS ID solo se è diverso dal Merchant ID), attiva Enable/Disable, fai clic su Save ed effettua un pagamento di prova in modalità sandbox.

5. Inserisci le chiavi live, disattiva Test Mode e fai clic su Save per accettare pagamenti reali.

OpenCart 4

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

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

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

4. Inserisci la chiave di licenza e le chiavi Przelewy24 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à di test attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni, la pagina mostra avvisi quando manca qualcosa. Mentre la sandbox è attiva: Sandbox (test) mode is on: payments go to the Przelewy24 sandbox and no real money is charged. Do not ship orders paid in test mode. Quando le chiavi della modalità corrente sono incomplete: Enter the Sandbox Merchant ID, API key and CRC key - until then Przelewy24 is not shown at checkout. (o lo stesso per le chiavi live). Se Przelewy24 non accetta la valuta predefinita del tuo negozio, l'avviso indica la valuta e quelle supportate. Dopo il salvataggio, gli avvisi seguono subito la nuova modalità e le nuove chiavi. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, nulla viene salvato se un campo è errato: Title non deve essere vuoto (Enter a title for the payment method (at most 128 characters).), Sort Order deve essere un numero intero (sono ammessi valori negativi), Total deve essere un numero pari o superiore a 0, e Geo Zone e gli stati dell'ordine devono esistere. Le chiavi mancanti non impediscono il salvataggio. Gli spazi e i ritorni a capo copiati insieme alle chiavi dal pannello Przelewy24 vengono rimossi al salvataggio.

Przelewy24

Enable/Disable: Enable Przelewy24 Payment 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 salvato nell'ordine. Predefinito: Przelewy24. Obbligatorio, massimo 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay with BLIK, online bank transfer or card via Przelewy24.

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

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

Total: il totale del carrello, nella valuta predefinita del negozio, che un ordine deve raggiungere prima che venga offerto Przelewy24. Lascia il campo vuoto per offrire Przelewy24 per qualsiasi importo.

Credenziali API

La sezione spiega dove trovare le chiavi (My data > API data and configuration nel pannello commerciante di Przelewy24) e contiene i link al pannello Przelewy24 e al pannello sandbox.

Test Mode: usa la sandbox di Przelewy24 e le chiavi Sandbox. Non viene addebitato denaro reale. Disattivalo per accettare pagamenti reali con le chiavi live. Predefinito: on. Quando è attivo, i clienti vedono Sandbox mode - no real money is charged nel passaggio Confirm Order.

Chiavi live

Live Merchant ID: il tuo ID commerciante Przelewy24, solo numeri.

Live POS ID (optional): lo Shop ID (posId). Lascia il campo vuoto se è uguale al Merchant ID.

Live API key (report key): la chiave API dal pannello Przelewy24. Serve per l'autenticazione API.

Live CRC key: serve a firmare le richieste inviate a Przelewy24 e a verificare la firma delle notifiche di Przelewy24.

Chiavi sandbox

Sandbox Merchant ID: il Merchant ID del tuo account sandbox Przelewy24.

Sandbox POS ID (optional): lo Shop ID (posId) dell'account sandbox. Lascia il campo vuoto se è uguale al Merchant ID.

Sandbox API key (report key): la chiave API dell'account sandbox.

Sandbox CRC key: la CRC key dell'account sandbox, usata per firmare le richieste e verificare le notifiche sandbox.

Le chiavi API e le CRC key 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 cambiarlo. Per rimuovere una chiave salvata, seleziona Clear the saved value sotto il campo e fai clic su Save.

Le chiavi live e quelle sandbox sono diverse. Il Merchant ID e il POS ID devono contenere solo cifre; finché non sono inseriti il Merchant ID, la chiave API e la CRC key della modalità corrente, il metodo di pagamento non viene mostrato al checkout. Un pagamento avviato in una modalità viene sempre verificato e rimborsato con le chiavi di quella modalità, anche dopo il cambio di modalità; conserva quindi le chiavi della modalità precedente finché i suoi pagamenti sono aperti o possono essere rimborsati.

Notifiche di pagamento

Notification URL: l'indirizzo che riceve le notifiche di pagamento da Przelewy24. Su OpenCart 3 ha questo aspetto https://your-store/index.php?route=extension/payment/wcp_przelewy24_payment/notify, su OpenCart 4 così: https://your-store/index.php?route=extension/wcp_przelewy24_payment/payment/wcp_przelewy_24payment.notify. È generato dall'indirizzo del negozio della tua installazione OpenCart. L'estensione invia questo URL a Przelewy24 con ogni pagamento e ogni rimborso, quindi non c'è nulla da configurare nel pannello Przelewy24. L'URL deve essere raggiungibile da internet: nessun firewall né autenticazione HTTP davanti. Continua a funzionare mentre il negozio è in manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, e su OpenCart 4 l'estensione aggiunge un'azione di avvio per l'URL di notifica e per il ritorno del cliente. Senza notifiche, un pagamento viene comunque confermato quando il cliente torna al negozio (vedi Checkout); se il cliente non torna, l'ordine resta senza stato.

Ordini

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

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

On Hold (Review) Status: i pagamenti il cui importo o valuta non corrispondono all'ordine (non verificati), oppure che arrivano dopo l'annullamento dell'ordine, ricevono questo stato e una nota che ne spiega il motivo. Predefinito: Pending, perché OpenCart non ha uno stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Cancelled Order Status: l'estensione non lo imposta mai. Un pagamento verificato per un ordine in questo stato mette l'ordine in attesa invece di riaprirlo in silenzio. Predefinito: Canceled.

Refunded Status: viene impostato dopo il rimborso totale del pagamento dalla pagina dell'ordine. Predefinito: Refunded.

Avanzate

Debug Log: scrive eventi tecnici (numeri d'ordine, ID transazione P24, errori) in wc_p24_debug.log.php nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web e, al raggiungimento di 5 MB, viene spostato in wc_p24_debug.old.log.php. Errori e avvisi, come notifiche rifiutate o una verifica o un rimborso non riusciti, vengono sempre registrati; attiva l'interruttore per registrare anche ogni passaggio. Chiavi e dati personali non vengono mai registrati. Predefinito: off.

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

Delete data on uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni del gateway e il registro. Gli ordini e i loro dati di pagamento Przelewy24 non vengono mai eliminati. Predefinito: off.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Le chiavi API e le CRC key non vengono esportate.

Import: incolla un JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni. Le chiavi API e le CRC key salvate vengono mantenute.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Przelewy24). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the secure Przelewy24 page to complete the payment. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente fa clic su Confirm Order, l'estensione registra una transazione Przelewy24 per il totale dell'ordine nella valuta dell'ordine, con l'e-mail, il nome e il paese di fatturazione del cliente, e con la descrizione Order # seguita dal numero d'ordine e dal nome del tuo negozio. Ogni tentativo di pagamento riceve un proprio ID di sessione. Il cliente viene inviato alla pagina di pagamento di Przelewy24 e paga con BLIK, bonifico bancario online, carta o un altro metodo attivo per il tuo account Przelewy24. La pagina di pagamento viene mostrata nella lingua dell'ordine se Przelewy24 la supporta, altrimenti in inglese. 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.

L'ordine viene segnato come pagato solo dopo la conferma di Przelewy24. Przelewy24 invia al tuo negozio una notifica firmata. L'estensione verifica la firma con la CRC key, il Merchant ID e il POS ID; che la sessione sia stata registrata per questo ordine e nella stessa modalità; e che importo e valuta corrispondano al tentativo di pagamento e al totale dell'ordine. Solo a quel punto verifica la transazione presso Przelewy24 (Przelewy24 accredita solo i pagamenti verificati) e imposta Paid Order Status nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino. I webhook senza firma valida vengono rifiutati.

Dopo il pagamento, il cliente torna al tuo negozio. Se la notifica non è ancora arrivata, l'estensione chiede a Przelewy24 lo stato della transazione con una richiesta autenticata server-to-server (al massimo una volta ogni 10 secondi per tentativo) e applica gli stessi controlli. La sola pagina di ritorno non segna mai un ordine come pagato. Quando il pagamento è confermato, il cliente vede la pagina di successo dell'ordine OpenCart. Finché non è confermato, una pagina Payment confirmation mostra We have not received the payment confirmation from Przelewy24 yet. If you have paid, it will be confirmed in a few minutes. If the payment was interrupted, you can try again: con un pulsante Check again e un pulsante Pay again che apre il checkout. Il carrello viene mantenuto e un pagamento effettuato più tardi da una vecchia pagina di Przelewy24 viene comunque accettato. Se l'ordine è in attesa, la pagina di successo mostra Your payment is being verified. We will send you an e-mail as soon as it is confirmed. Quando un pagamento successivo sposta l'ordine dallo stato di attesa a Paid Order Status, il cliente riceve un'e-mail. Se hai annullato l'ordine prima del pagamento e Przelewy24 non ha un pagamento per esso, il cliente che torna vede Order #… was cancelled by the store before the payment was completed. No Przelewy24 payment was received for it. Please place a new order or contact us.

Se il pagamento non può essere avviato, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante: Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (il motivo va nel registro), Payment gateway is not configured properly. Please contact the administrator. (mancano le chiavi della modalità corrente), un messaggio che indica che Przelewy24 non può accettare pagamenti nella valuta dell'ordine, oppure The order total must be greater than zero. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; un ordine o un carrello già pagato non viene inviato di nuovo a Przelewy24, e il cliente va alla pagina di successo.

OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna ogni volta che viene mostrato il passaggio Confirm Order, quindi Pay again avvia una nuova transazione Przelewy24 per lo stesso ordine. Se quell'ordine nel frattempo è stato chiuso dal negozio (per esempio annullato o rimborsato), il cliente torna al checkout con Il tuo ordine precedente è stato chiuso dal negozio. Conferma di nuovo l'ordine per creare e pagare un nuovo ordine. (per un ordine annullato prima di qualsiasi pagamento, insieme al messaggio sull'ordine annullato sopra), e il successivo clic su Confirm Order paga un nuovo ordine. Se l'ordine del checkout è già pagato ma da allora il carrello è cambiato, compresa una nuova quantità, il cliente vede Il tuo ordine precedente #… è già stato effettuato. Il carrello è cambiato: conferma il nuovo ordine per pagarlo. e il nuovo carrello viene pagato con un nuovo ordine. Su OpenCart 4 questi messaggi, e We could not match this payment to an order. If you were charged, please contact us., vengono mostrati sopra la pagina del checkout.

L'estensione non prevede carte salvate o pagamenti con un clic, abbonamenti o pagamenti ricorrenti, scelta del metodo di pagamento P24 (per esempio un campo per il codice BLIK) nella pagina di checkout, widget di rateizzazione, e non invia il contenuto del carrello a Przelewy24.

Ordini e rimborsi

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente è stato inviato a Przelewy24 e non ha pagato, oppure il pagamento non è ancora confermato. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Paid Order Status (predefinito Processing): il pagamento è stato verificato. Una nota mostra l'ID ordine P24, l'importo e la modalità. Ogni pagamento viene applicato una sola volta.

On Hold (Review) Status (predefinito Pending): l'importo o la valuta comunicati da Przelewy24 differiscono dall'ordine; il pagamento non è stato confermato e la nota lo indica. Oppure il pagamento è arrivato ed è stato verificato per un ordine in stato annullato; l'ordine non viene riaperto in silenzio, e la nota ti chiede di spedirlo o di rimborsare il pagamento. Controlla il pagamento nel pannello Przelewy24. Se in seguito a una discrepanza arriva per un ordine in attesa un pagamento corretto di un altro tentativo, l'ordine passa a Paid Order Status.

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

Se arriva un secondo pagamento per un ordine o un carrello già pagato o rimborsato (un vecchio link di pagamento, due schede del browser, un altro ordine dello stesso carrello), non viene confermato e Przelewy24 non lo accredita. Una nota sull'ordine pagato ti chiede di verificarlo nel pannello Przelewy24 e di restituirlo all'acquirente se necessario.

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

Scheda VibeFox Przelewy24 Payment

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

Rimborsi

Nella scheda VibeFox Przelewy24 Payment inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e fai clic su Refund via Przelewy24. Conferma la domanda Refund this amount through Przelewy24? This cannot be undone. Sono supportati rimborsi totali e parziali, fino all'importo non ancora rimborsato. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Il rimborso viene inviato nella modalità in cui è stato effettuato il pagamento (sandbox o live), quindi devono essere impostate le chiavi di quella modalità. I rimborsi sono disponibili dopo che Przelewy24 ha verificato il pagamento.

Przelewy24 elabora i rimborsi in modo asincrono. La scheda mostra Refund of … requested at Przelewy24. The result will be added as an order note., lo storico dei rimborsi mostra lo stato requested e viene aggiunta una nota. Il risultato arriva più tardi all'URL di notifica: lo stato diventa completed con la nota Przelewy24: refund of … completed., oppure rejected con una nota che indica che il denaro non è stato restituito all'acquirente. Un rimborso totale imposta l'ordine su Refunded Status al momento della richiesta, senza avvisare il cliente e senza rimettere i prodotti a magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato. Se un rimborso viene rifiutato, controllalo nel pannello Przelewy24; lo stato dell'ordine non viene ripristinato automaticamente.

Se Przelewy24 non accetta la richiesta di rimborso, la scheda mostra Przelewy24 refund failed: con il motivo, e nessun rimborso viene registrato. I resi di prodotti in Sales > Returns non restituiscono denaro tramite Przelewy24, e i rimborsi effettuati direttamente nel pannello Przelewy24 non vengono aggiunti all'ordine.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox Przelewy24 Payment è il primo blocco di Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit, sopra le impostazioni. Incolla 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 compaiono la riga Product: opencart-payment-przelewy24 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 sull'estensione possono cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato un posto 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 della configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo posto dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, Przelewy24 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 connesso all'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato da (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 nella Dashboard dell'amministrazione. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati continuano a essere verificati e confermati, e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e assistenza 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

Przelewy24 non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che il Merchant ID, la chiave API e la CRC key della modalità corrente siano inseriti (le chiavi Sandbox finché Test Mode è attivo, le chiavi Live altrimenti; Merchant ID e POS ID solo cifre) e che la valuta dell'ordine sia PLN, EUR, GBP o CZK. Gli avvisi in cima alle impostazioni indicano il problema. Controlla anche 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: la notifica di Przelewy24 non è arrivata al tuo negozio e il cliente non è tornato al negozio. Verifica che la Notification URL sia raggiungibile da internet (nessun firewall né autenticazione HTTP davanti) e che Merchant ID, POS ID e CRC key della modalità del pagamento siano corretti. Le notifiche rifiutate vengono scritte nel registro anche con Debug Log disattivo; consulta il campo Log nella pagina dell'estensione.

Come il negozio risponde alle notifiche: una notifica elaborata, ripetuta o sconosciuta riceve una risposta HTTP 200. Altrimenti Przelewy24 la rinvia più tardi: 400 (dati mancanti o malformati), 401 Invalid signature (CRC key errata, altro Merchant ID o POS ID), 401 Invalid signature for this payment (notifica firmata con le chiavi di una modalità diversa da quella del pagamento), 405 (richiesta non POST), 500 Verification failed (la verifica presso Przelewy24 non è riuscita; una nota viene aggiunta all'ordine una sola volta), 500 Order could not be updated (non è stato possibile impostare lo stato dell'ordine; la notifica successiva lo imposta senza una nuova verifica) e 503 Busy, retry later (l'ordine era in conferma da un'altra richiesta nello stesso momento).

Il cliente vede Payment error: Przelewy24 could not start the payment: Przelewy24 ha rifiutato la transazione, di solito per chiavi errate della modalità corrente (le chiavi sandbox funzionano solo in modalità sandbox, le chiavi live solo in modalità live). L'errore di Przelewy24 è nel registro.

Il cliente vede We could not match this payment to an order: il link di ritorno di Przelewy24 non corrispondeva a nessun ordine del negozio. Se al cliente è stato addebitato l'importo, cerca il pagamento nel pannello Przelewy24.

L'ordine è nello stato di verifica dopo il pagamento: leggi le note nella scheda VibeFox Przelewy24 Payment. L'importo o la valuta non corrispondevano all'ordine, oppure il pagamento è arrivato per un ordine che era stato annullato. Controlla il pagamento nel pannello Przelewy24, poi elabora l'ordine o rimborsa il pagamento.

Un rimborso non riesce: This order has no verified Przelewy24 payment. Cannot process refund. significa che l'ordine non è stato pagato con un pagamento Przelewy24 verificato. The payment was made in the Przelewy24 sandbox, but the Sandbox keys are missing. (o lo stesso per live) significa che sono state rimosse le chiavi della modalità del pagamento; inseriscile di nuovo. Invalid refund amount significa che l'importo è vuoto, non è un numero o supera l'importo non ancora rimborsato.

Per gli sviluppatori: l'elenco delle valute può essere modificato con l'evento OpenCart wc_p24_supported_currencies (solo valute con due decimali).

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox Przelewy24 Payment. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable/Disable, Sort Order, Geo Zone, Total e gli stati degli ordini della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che lasciano passare le notifiche e il ritorno del cliente in modalità di manutenzione). Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità di test, chiavi, interruttore del log di debug) e il registro. Se è disattivo, vengono mantenute per una futura reinstallazione. I dati di pagamento Przelewy24 degli ordini (sessioni, ID ordini P24, rimborsi) vengono sempre mantenuti, quindi gli ordini pagati in precedenza possono ancora essere rimborsati dopo una reinstallazione. Gli ordini esistenti conservano le proprie note di pagamento.

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

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