VibeFox Peach Payments for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato con la versione 3.0.5.0) o 4.0.2 e successive (testato con la versione 4.1.0.3).

PHP: 8.0 o successiva, con l'estensione OpenSSL (usata per decifrare i webhook).

Valuta: la valuta del checkout del cliente deve essere ZAR, KES o MUR, quindi il tuo negozio deve avere almeno una di queste valute in System > Localisation > Currencies. Per i clienti che pagano in altre valute il metodo di pagamento viene nascosto. La pagina delle impostazioni ti avvisa quando la valuta predefinita del negozio non è una di queste.

Account Peach Payments: ti servono le credenziali Card API del tuo account Peach Payments: Entity ID e Access Token. Le credenziali di test provengono dalla dashboard sandbox di Peach Payments, quelle live dalla dashboard di Peach Payments; sono diverse. Per i webhook ti serve anche una chiave di decifratura dei webhook, che Peach Payments ti invia quando attiva i webhook Card per il tuo negozio (vedi Configurazione). Il tuo negozio deve essere raggiungibile da Internet per ricevere i webhook.

Chiave di licenza VibeFox: acquistata 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. Estrailo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_peach_pay-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_peach_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. Nell'amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_peach_pay-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 Peach Payments 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. 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 l'Entity ID e l'Access Token di test dalla dashboard sandbox di Peach Payments, e chiedi a Peach Payments di attivare i webhook Card per l'URL del webhook mostrato nella pagina delle impostazioni (vedi Configurazione).

5. Attiva Enable/Disable e fai clic su Save. Lascia Test mode attivo ed effettua un pagamento con una carta di test sandbox di Peach Payments in ZAR, KES o MUR. Poi disattiva Test mode, inserisci le credenziali live e la chiave webhook live, e fai clic su Save.

OpenCart 4

1. Nell'amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_peach_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 Peach Payments Pay Gateway, fai clic su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza, le credenziali Peach Payments e il webhook 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).

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 Peach Payments Pay Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra degli avvisi: Test mode is on: payments go to the Peach Payments sandbox and no real money is charged.; un errore quando l'Entity ID o l'Access Token della modalità attuale mancano (fino ad allora il metodo di pagamento non viene mostrato al checkout); un avviso quando manca la chiave di decifratura dei webhook della modalità attuale (in tal caso i pagamenti vengono confermati solo quando il cliente torna nel negozio); e un avviso quando la valuta predefinita del negozio non è supportata (il metodo di pagamento viene allora mostrato solo ai clienti che pagano in una valuta supportata). Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto né superare 128 caratteri (la pagina mostra Enter a title for the payment method (up to 128 characters).), 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. In caso contrario non viene salvato nulla. Gli spazi vengono rimossi dalle credenziali. Una chiave webhook che non sia un valore esadecimale di 64 caratteri, oppure un elenco vuoto di marchi di carta, viene salvata con un avviso.

Peach Payments

Enable/Disable: Enable Peach Payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento mostrato al cliente al checkout. È anche il nome del metodo di pagamento memorizzato nell'ordine. Predefinito: Credit / Debit Card (Peach Payments). Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma, accanto a un'icona di carta. Predefinito: Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

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

Geo Zone: offri Peach Payments 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 Peach Payments venga offerto. Lascia il campo vuoto per offrirlo con qualsiasi importo.

Credenziali API

L'Access Token e l'Entity ID della Card API sono mostrati nella dashboard di Peach Payments (le credenziali di test nella dashboard sandbox). La sezione rimanda a entrambe le dashboard e alla documentazione per sviluppatori di Peach Payments.

Test mode: invia i nuovi pagamenti alla sandbox di Peach Payments con le credenziali di test, e non viene addebitato denaro reale. Disattivalo per accettare pagamenti reali con le credenziali live. Un pagamento avviato in una modalità viene sempre verificato in quella modalità, anche dopo il cambio. Predefinito: attivo. Finché è attivo, il cliente vede Test mode: no real payment will be made. nel passaggio Confirm Order.

Test Entity ID: l'Entity ID (canale 3-D Secure) del tuo account sandbox.

Test Access Token: il bearer access token del tuo account sandbox.

Test Webhook Decryption Key: la chiave esadecimale di 64 caratteri usata per decifrare i webhook Card della sandbox.

Live Entity ID: l'Entity ID (canale 3-D Secure) del tuo account live.

Live Access Token: il bearer access token del tuo account live.

Live Webhook Decryption Key: la chiave esadecimale di 64 caratteri usata per decifrare i webhook Card del tuo account live.

I token di accesso e le chiavi webhook 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 cambiarlo. Per rimuovere un valore salvato, seleziona Clear the saved value on save sotto il campo e fai clic su Save.

Webhook

I webhook confermano i pagamenti anche quando il cliente chiude il browser prima di tornare nel negozio. Il campo Webhook URL mostra l'URL del webhook del tuo negozio. Su OpenCart 3 ha il formato https://your-store/index.php?route=extension/payment/wcp_peach_pay/webhook, su OpenCart 4 https://your-store/index.php?route=extension/wcp_peach_pay/payment/wcp_peach_pay.webhook. È costruito a partire dall'indirizzo della vetrina della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Chiedi a Peach Payments (support@peachpayments.com) di attivare i webhook Card per il tuo account con questo URL, poi inserisci la chiave di decifratura che ricevi nel campo Webhook Decryption Key della stessa modalità.

Peach Payments cifra ogni webhook (AES-256-GCM). Un webhook che non può essere decifrato con la chiave di test o live viene rifiutato, quindi solo Peach Payments può modificare i tuoi ordini. Un webhook decifrato con la chiave di una modalità viene applicato solo ai pagamenti avviati in quella modalità. L'estensione usa queste notifiche di pagamento:

Le altre notifiche, per esempio la notifica di test inviata all'attivazione del webhook, ricevono la risposta ignored. Senza la chiave webhook, un ordine riceve uno stato solo quando il cliente torna nel negozio dopo aver pagato.

Modulo di pagamento

Card brands: i marchi mostrati nel modulo di Peach Payments: Visa, Mastercard, American Express, Diners Club. Seleziona solo i marchi abilitati per il tuo Entity ID. Predefinito: Visa e Mastercard. Se non è selezionato alcun marchio, al salvataggio compare un avviso e il modulo mostra Visa e Mastercard.

Ordini

L'ordine viene creato nel passaggio Confirm Order senza stato (un ordine mancante) e riceve uno stato solo dopo che Peach Payments ha confermato il pagamento. Un pagamento rifiutato o abbandonato lascia l'ordine senza stato, e il carrello viene conservato. Ogni campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: impostato quando Peach Payments conferma il pagamento e importo e valuta corrispondono. Predefinito: In lavorazione.

Awaiting Payment Status: Peach Payments ha segnalato un pagamento asincrono che attende una conferma; il webhook lo conferma più tardi. Predefinito: In attesa, perché OpenCart non ha uno stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

On Hold (Review) Status: revisione manuale: l'importo o la valuta pagati non corrispondono all'ordine, oppure un pagamento è arrivato dopo l'annullamento dell'ordine. Una nota spiega il motivo. Predefinito: In attesa.

Payment Failed Status: impostato quando il pagamento asincrono che l'ordine attendeva viene rifiutato. Un successivo pagamento riuscito completa comunque l'ordine. Predefinito: Fallito.

Canceled Status: l'estensione non lo imposta. Un pagamento per un ordine in questo stato lo mette in revisione invece di riaprirlo. Predefinito: Annullato.

Refunded Status: l'estensione non lo imposta. Un pagamento ricevuto per un ordine in questo stato viene solo annotato, e l'ordine non cambia. Predefinito: Rimborsato.

Avanzate

Logging: registra le richieste API e i risultati dei pagamenti in peach_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere letto dal web e, al raggiungimento di 5 MB, viene spostato in peach_p_debug.old.log.php. Errori e avvisi vengono sempre registrati. I log non contengono dati di carte, chiavi o dati dei clienti. Predefinito: disattivato.

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. I dati Peach Payments degli ordini (tentativi di pagamento e ID dei pagamenti) vengono conservati, perché appartengono agli ordini. Predefinito: disattivato.

Importa / Esporta

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

Import: incolla il JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni. I token di accesso e le chiavi webhook salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit / Debit Card (Peach Payments)). Nel passaggio Confirm Order il cliente vede un'icona di carta e la tua descrizione; OpenCart crea l'ordine in questo passaggio, ancora senza stato. Quando il cliente fa clic su Confirm Order, l'estensione prepara un checkout Peach Payments per il totale dell'ordine nella valuta dell'ordine e apre la pagina di pagamento Peach Payments payment del tuo negozio con Please enter your card details to complete the payment:, il modulo carta di Peach Payments e i marchi di carta selezionati, nella lingua del cliente quando Peach Payments la supporta. In modalità test la pagina mostra Test mode: use a Peach Payments test card, no real payment will be made. I dati della carta si inseriscono nel modulo di Peach Payments, e lo script del modulo viene caricato con un hash Subresource Integrity. Il link Choose another payment method riporta al checkout. Il ricaricamento della pagina riutilizza lo stesso checkout per un massimo di 25 minuti, a meno che il totale dell'ordine non sia cambiato. Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco dei metodi di pagamento, nella finestra Payment method options, e clicca su Confirm Order in fondo alla pagina di checkout.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando Peach Payments lo conferma: il negozio legge il risultato del checkout di questo ordine dall'API di Peach Payments, nella modalità in cui il checkout è stato creato, e verifica che il pagamento appartenga a questo ordine. Il webhook fa lo stesso in modo indipendente, quindi quello che arriva per primo imposta lo stato dell'ordine e l'altro non cambia nulla. 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. Su OpenCart 4, quando il cliente torna dalla pagina 3-D Secure della banca, una breve pagina intermedia riapre l'indirizzo di ritorno del tuo negozio, così il carrello e l'accesso del cliente restano conservati.

Se il pagamento non viene completato, il cliente torna al checkout con un messaggio e può riprovare: Payment failed: seguito dal motivo indicato da Peach Payments e da Please try again or use another card., oppure The payment was not completed. Please try again. Il carrello viene conservato. Se il risultato non può ancora essere confermato (per esempio perché Peach Payments non ha risposto, o perché il webhook sta elaborando lo stesso carrello in quel momento), il messaggio è We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. Quando per la modalità del pagamento non è impostata alcuna chiave webhook, al cliente viene invece chiesto di contattarti. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, OpenCart 4 aggiorna l'ordine del checkout. Un carrello viene pagato una sola volta: se un altro ordine dello stesso carrello è già pagato, il cliente passa direttamente alla pagina di successo. Una modifica del carrello, compresa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

Su OpenCart 4 l'ordine resta nel checkout finché non viene mostrata la pagina di successo. Dopo un tentativo rifiutato il cliente paga di nuovo lo stesso ordine con un nuovo checkout Peach Payments. Se nel frattempo quell'ordine è stato chiuso (per esempio il pagamento atteso è fallito o lo hai annullato), il cliente torna al checkout con il messaggio Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. Il successivo Confirm Order paga un nuovo ordine. Se l'ordine era stato pagato e poi annullato o rimborsato da te, il messaggio è This order was cancelled or refunded by the store. Please contact the store about its payment, or confirm the order again: the cart will be paid with a new order.

Se il modulo di pagamento non può essere preparato, il cliente resta nel passaggio Confirm Order con un breve messaggio: The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (credenziali mancanti o errate), un messaggio che indica che alcuni dati di fatturazione non sono stati accettati dal fornitore di pagamento, oppure The payment form could not be loaded. Please try again in a moment. Il motivo tecnico viene scritto nel log.

Il webhook funziona anche quando 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.

L'estensione non ha un modulo carta nel passaggio di checkout stesso, né carte salvate, abbonamenti, pre-autorizzazione seguita da cattura, né metodi diversi dalle carte come EFT, BNPL, QR o altri.

Ordini

Stati dell'ordine

Nessuno stato (ordine mancante): il cliente non ha pagato, il pagamento è stato rifiutato o non completato, oppure Peach Payments non lo ha ancora confermato. Il cliente può pagare di nuovo. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders. In OpenCart 4.1 un ordine del genere può anche avere lo stato Voided, che OpenCart imposta quando il passaggio di conferma viene mostrato di nuovo; l'estensione lo considera un ordine senza stato.

Order Status After Payment (default Processing): il pagamento è stato confermato e importo e valuta corrispondono all'ordine. Una nota mostra il codice di risultato di Peach Payments, la descrizione e l'ID del pagamento. Se Peach Payments ha segnalato il pagamento per una verifica manuale, la nota ti chiede di controllarlo nella dashboard di Peach Payments prima della spedizione.

Awaiting Payment Status (default Pending): Peach Payments ha segnalato un pagamento che attende una conferma. Il webhook sposta poi l'ordine in Order Status After Payment o in Payment Failed Status.

On Hold (Review) Status (default Pending): l'importo o la valuta pagati non corrispondono all'ordine (nota amount/currency mismatch — manual review required), oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Controlla il pagamento nella dashboard di Peach Payments, poi elabora l'ordine o rimborsa il pagamento.

Payment Failed Status (default Failed): Peach Payments ha rifiutato il pagamento che l'ordine in attesa stava aspettando. Un tentativo rifiutato non modifica mai un ordine pagato o in revisione.

Se un secondo pagamento per un ordine già pagato va a buon fine, oppure un pagamento per un altro ordine di un carrello già pagato, l'ordine pagato non viene modificato. Una nota indica che si tratta di un pagamento duplicato e chiede di rimborsarlo nella dashboard di Peach Payments. Un pagamento ricevuto per un ordine rimborsato viene solo annotato sull'ordine.

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

Scheda VibeFox Peach Payments Pay Gateway

In Sales > Orders apri un ordine pagato con Peach Payments. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda dell'estensione mostra il Payment ID con l'etichetta Test mode per i pagamenti di test, il Checkout ID, il Merchant transaction ID, l'Amount sent to Peach Payments, il Result con il codice di risultato e le Peach Payments notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

I rimborsi da OpenCart non sono disponibili. Rimborsa il pagamento nella dashboard di Peach Payments e registralo in OpenCart se necessario. Con il webhook configurato, i rimborsi, gli storni e le contestazioni effettuati in Peach Payments vengono aggiunti alle note dell'ordine con importo e ID; lo stato dell'ordine non cambia. I resi di prodotti in Sales > Returns non rimborsano denaro tramite Peach Payments.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox Peach Payments Pay Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Peach Payments Pay Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e fai clic su Activate. Dopo di ciò 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-peach e il link Gestisci licenze e domini nel tuo account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono modificare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono inclusi inglese e russo).

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

Senza una chiave attiva, Peach Payments 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 con (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 dell'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 vengono comunque confermati dal ritorno del cliente e dal webhook.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: una volta al giorno nei 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

Peach Payments non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che l'Entity ID e l'Access Token della modalità attuale siano inseriti (Test Entity ID e Test Access Token in modalità test, Live Entity ID e Live Access Token in modalità live) e che il cliente paghi in ZAR, KES o MUR. Verifica anche che l'indirizzo di pagamento sia nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni. Gli avvisi in cima alle impostazioni indicano il problema.

Il pagamento è andato a buon fine, ma l'ordine resta senza stato: il cliente non è tornato nel negozio e il webhook non è arrivato. Verifica che Peach Payments abbia attivato i webhook Card esattamente per l'URL mostrato nelle impostazioni, che sia inserita la Webhook Decryption Key della modalità in cui è stato effettuato il pagamento, e che nessun firewall o protezione con password blocchi l'URL. Attiva Logging e controlla il campo Log per individuare i webhook rifiutati.

Il webhook risponde Decryption failed: il webhook non è stato decifrato con la chiave di test né con quella live. La chiave è errata oppure appartiene a un altro account o modalità. Inserisci la chiave che Peach Payments ha inviato per questo URL di webhook.

Il webhook risponde Webhook key not configured: non è impostata alcuna chiave webhook valida. Inserisci la chiave di 64 caratteri. Peach Payments invierà di nuovo il webhook più tardi.

Il webhook risponde Busy, retry later: il carrello era in elaborazione dal ritorno del cliente nello stesso momento. Non è stato modificato nulla, e Peach Payments invia di nuovo il webhook. Il log mostra il motivo.

Il webhook risponde Missing or malformed data: la richiesta non aveva un corpo cifrato né le intestazioni X-Initialization-Vector / X-Authentication-Tag, per esempio perché un proxy le ha modificate. Non è stato modificato nulla.

Il webhook risponde ignored: la notifica è autentica ma non appartiene a un checkout di questo negozio (un altro negozio con lo stesso Entity ID), oppure proviene dall'altra modalità rispetto al pagamento. Non è stato modificato nulla.

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

Il cliente vede The payment form is not available right now: l'Access Token o l'Entity ID della modalità attuale sono errati. Verifica le credenziali e la modalità, e leggi il log per il codice di Peach Payments.

Il cliente vede The payment session was not found. Please confirm the order again.: la pagina di pagamento è stata aperta per un ordine che non è più l'ordine attuale del cliente, oppure il metodo di pagamento è stato disattivato nel frattempo. Il cliente deve confermare di nuovo l'ordine.

L'ordine è nello stato di revisione dopo il pagamento: leggi le note nella scheda dell'estensione. L'importo o la valuta pagati erano diversi dall'ordine, oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Controlla il pagamento nella dashboard di Peach Payments, poi elabora l'ordine o rimborsa il pagamento.

Al salvataggio compare il messaggio che la chiave webhook deve essere la chiave esadecimale di 64 caratteri: il valore non è la chiave di Peach Payments. I webhook non possono essere decifrati finché non viene corretta.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox Peach Payments 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 in caso di reinstallazione. Se Delete data on uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità di test, credenziali, chiavi webhook, marchi di carta, registrazione) e il registro. Se è disattivato, vengono conservate per una futura reinstallazione. I tentativi di checkout e gli ID dei pagamenti vengono sempre conservati. Su OpenCart 4 gli eventi dell'estensione e la sua azione di avvio, che lascia passare il webhook e il ritorno del cliente in modalità manutenzione, vengono sempre rimossi. 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 Peach Payments Pay Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

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