VibeFox PayMongo for OpenCart — Guida

Requisiti

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

PHP: 8.0 o successivo.

Valuta: peso filippino (PHP). PayMongo viene mostrato al checkout solo quando il cliente paga in PHP e il totale è di almeno ₱100.00. Aggiungi la valuta in System > Localisation > Currencies se il tuo negozio non ce l'ha ancora. Se la valuta predefinita del negozio non è PHP, la pagina delle impostazioni ti avvisa e i clienti devono passare a PHP per vedere PayMongo.

Account PayMongo: ti servono le chiavi API segrete del tuo account PayMongo e un webhook per ogni modalità (vedi Configurazione). Vengono usate solo le chiavi segrete (sk_test_..., sk_live_...) e i segreti di firma dei webhook (whsk_...). Le chiavi pubbliche non servono, perché la pagina di pagamento è ospitata da PayMongo. I metodi di pagamento che offri devono essere attivati per il tuo account PayMongo.

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_paymongo_payment_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_paymongo_payment_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. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_paymongo_payment_gateway-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 PayMongo Payment Gateway e clicca su Install (il pulsante verde +).

3. Clicca 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 clicca su Activate (vedi Chiave di licenza).

4. Incolla le tue chiavi segrete PayMongo, crea i webhook in PayMongo e incolla i loro segreti di firma (vedi Configurazione).

5. Seleziona i metodi di pagamento, attiva Enable/Disable e clicca su Save. Prova un pagamento con Test mode attivo, poi disattivalo.

OpenCart 4

1. Nell'area di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_paymongo_payment_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 PayMongo Payment Gateway, clicca su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza, le chiavi PayMongo, i webhook e i metodi di pagamento come nei passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono gli stessi 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à test attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina ti avvisa quando la valuta predefinita del negozio non è PHP, quando la modalità attuale non ha una chiave segreta (in tal caso PayMongo non viene mostrato al checkout) o un segreto del webhook (in tal caso i pagamenti vengono confermati solo quando il cliente torna nel negozio), e mostra Test mode is on: no real payments are made. mentre la modalità test è attiva.

Al salvataggio, Title non può essere vuoto (fino a 128 caratteri), Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total un numero pari o superiore a 0, e la zona geografica e gli stati d'ordine selezionati devono esistere; altrimenti non viene salvato nulla e la pagina indica il campo. Una chiave con un prefisso errato non viene salvata, ma gli altri campi sì (vedi Chiavi API).

PayMongo

Enable/Disable: Enable PayMongo 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 salvato nell'ordine. Predefinito: PayMongo (Card, GCash, GrabPay, Maya). Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: You will be redirected to PayMongo to pay securely with your card, GCash, GrabPay or Maya.

Payment methods: i metodi offerti nella pagina di checkout di PayMongo. Seleziona solo i metodi attivati per il tuo account PayMongo, altrimenti PayMongo rifiuta il checkout. Se non ne selezioni nessuno, vengono usati i predefiniti. Predefinito: Cards, GCash, GrabPay e Maya.

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

Geo Zone: offri PayMongo 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 PayMongo, oltre al minimo PayMongo di ₱100.00. Lascia vuoto per non avere un minimo aggiuntivo.

Chiavi API

Copia le chiavi segrete da PayMongo Dashboard > Developers > API keys (lì ci sono i collegamenti alla sezione). Le chiavi pubbliche non servono. Ogni chiave deve iniziare con il prefisso previsto. Un valore con un prefisso errato, per esempio una chiave attiva in un campo di prova, non viene salvato: la pagina mostra che il campo deve iniziare con il prefisso e The previous value was kept.

Test mode: Enable test mode (no real payments). I nuovi pagamenti usano le chiavi di prova. I pagamenti effettuati in precedenza mantengono la modalità in cui sono stati fatti, quindi i controlli di stato e i rimborsi usano la chiave corrispondente. Predefinito: attivo. Disattivalo per accettare pagamenti reali. Finché è attivo, il cliente vede Test mode: no real payment will be made. nel passaggio Confirm Order.

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

Test webhook secret: il segreto di firma del webhook della modalità test. Inizia con whsk_.

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

Live webhook secret: il segreto di firma del webhook della modalità attiva. Inizia con whsk_.

Le chiavi e i segreti salvati non vengono più mostrati. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo per cambiarlo. Per rimuovere un valore salvato, spunta Clear the saved value on save sotto il campo e clicca su Save.

Webhook

Il webhook comunica al tuo negozio che un pagamento è stato effettuato, anche quando il cliente chiude il browser dopo aver pagato. Crea un webhook nel PayMongo Dashboard (o tramite le API di PayMongo) per ogni modalità, test e attiva, con l'URL mostrato in Webhook URL in questa sezione. Su OpenCart 3 ha questo aspetto: https://your-store/index.php?route=extension/payment/wcp_paymongo_payment_gateway/webhook, su OpenCart 4: https://your-store/index.php?route=extension/wcp_paymongo_payment_gateway/payment/wcp_paymongo_payment_gateway.webhook, ed è costruito a partire dall'indirizzo del negozio della tua installazione OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni.

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

Copia il segreto di firma (whsk_...) di ogni webhook in Test webhook secret o Live webhook secret. I webhook senza una firma valida vengono rifiutati. La firma viene verificata con il segreto della propria modalità, e la modalità dell'evento deve corrispondere, quindi un webhook di prova non conferma mai un pagamento reale. Ogni evento viene verificato di nuovo tramite le API di PayMongo con la chiave segreta della modalità del pagamento prima che un ordine venga modificato. Gli eventi di pagamenti non avviati in questo negozio vengono ignorati. Senza webhook, un ordine viene confermato solo quando il cliente torna nel negozio dopo aver pagato.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine mancante). Riceve uno stato solo dopo che PayMongo ha confermato il pagamento. OpenCart non ha lo stato On hold: per impostazione predefinita lo stato di attesa e quello di sospensione sono entrambi In attesa, e la scheda PayMongo e le note dell'ordine permettono di distinguerli. Puoi creare i tuoi stati in System > Localisation > Order Statuses e selezionarli qui. Ogni campo qui sotto elenca i tuoi stati d'ordine OpenCart.

Order status after payment: lo stato assegnato dopo un pagamento riuscito. Predefinito: In lavorazione. Complete è adatto a beni virtuali o scaricabili che non richiedono spedizione.

Awaiting PayMongo payment: il cliente ha terminato nella pagina di PayMongo, ma il pagamento è ancora in elaborazione (per esempio il bonifico online). Il webhook o il controllo successivo completa l'ordine. Predefinito: In attesa.

PayMongo payment on hold: una differenza di importo o di valuta, un pagamento di prova su un negozio attivo, oppure un pagamento arrivato dopo l'annullamento dell'ordine. Una nota spiega il motivo. Predefinito: In attesa.

Failed status: un pagamento in attesa è fallito in seguito (payment.failed). Un tentativo fallito su un ordine senza stato lo lascia senza stato, e il cliente può pagare di nuovo. Predefinito: Fallito.

Cancelled status: lo stato che assegni a un ordine annullato. Un pagamento che arriva più tardi mette l'ordine in sospensione invece di completarlo. Predefinito: Annullato.

Refunded status: impostato quando il pagamento è stato rimborsato interamente dalla scheda dell'ordine. Predefinito: Rimborsato.

Avanzate

Debug log: registra le chiamate alle API di PayMongo e gli eventi dei webhook in paymongo_p_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. Errori e avvisi vengono sempre registrati, anche con l'interruttore disattivato. Chiavi e dati dei clienti non vengono mai registrati. Predefinito: disattivato.

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

Delete data on uninstall: se attivo, disinstallando l'estensione vengono eliminate le impostazioni del gateway e il registro. Gli ID PayMongo salvati per ordini e rimborsi vengono sempre conservati, perché servono per i rimborsi e la contabilità. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un 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.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita PayMongo (Card, GCash, GrabPay, Maya)). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota After you confirm the order you will be redirected to PayMongo to complete the payment. 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 di checkout.

Quando il cliente clicca su Confirm Order, l'estensione crea una sessione di checkout PayMongo (Checkout Session) per il totale dell'ordine in PHP, con una riga Order # e il numero d'ordine, e invia il cliente alla pagina di checkout di PayMongo. Nome, e-mail, telefono e indirizzo di fatturazione del cliente vengono passati a PayMongo. Lì il cliente sceglie uno dei metodi selezionati e paga. Una nota nell'ordine registra la sessione di checkout PayMongo.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo quando PayMongo lo conferma: l'estensione chiede alle API di PayMongo informazioni sul pagamento quando il cliente torna e quando arriva il webhook. 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 con Your PayMongo payment has been received. Se PayMongo sta ancora elaborando il pagamento quando il cliente torna, l'ordine riceve lo stato di attesa e la pagina mostra PayMongo is still processing your payment. Your order will be updated as soon as PayMongo confirms it — please do not pay again. Per un ordine in sospensione mostra Your payment was received and is being reviewed. We will update your order shortly. Se PayMongo non è raggiungibile quando il cliente torna, una pagina Payment confirmation dice Your payment is being confirmed by PayMongo. You will receive an e-mail as soon as it is confirmed — please do not pay again. con un pulsante Check again; il webhook imposta lo stato dell'ordine appena arriva. Quando un ordine passa dallo stato di attesa a quello di pagato o allo stato di errore di pagamento, il cliente riceve la consueta e-mail di cambio stato di OpenCart.

Se il cliente annulla nella pagina di PayMongo o non completa il pagamento, torna al checkout con You cancelled the PayMongo payment. You can try again or choose another payment method. oppure Your PayMongo payment was not completed. You can try again or choose another payment method. Il carrello viene conservato. Su OpenCart 4 questi messaggi compaiono sopra la pagina di checkout. Un nuovo tentativo (OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order; OpenCart 4 aggiorna l'ordine del checkout) controlla prima il precedente: se nel frattempo è stato pagato, il pagamento viene confermato senza un nuovo pagamento; altrimenti il precedente link di pagamento PayMongo scade, così il carrello non può essere pagato due volte. Mentre il pagamento precedente è ancora in elaborazione, il cliente vede Your previous PayMongo payment for this order is still being processed. Please wait a few minutes before trying again. Se un altro ordine dello stesso carrello è già pagato o in attesa di pagamento, il cliente viene portato alla pagina di successo. Una modifica del carrello, inclusa una nuova quantità, conta come un nuovo carrello che richiede un proprio pagamento.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se quell'ordine nel frattempo è stato chiuso (per esempio l'hai annullato), o è stato pagato per un carrello diverso, il cliente viene rimandato al checkout con il messaggio Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. Il successivo Confirm Order paga un nuovo ordine. Un ordine pagato non viene mai mostrato come pagato per un carrello diverso.

Se PayMongo non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio The payment could not be started. Please try again or choose another payment method. oppure PayMongo could not be reached. Please try again in a moment. Il motivo tecnico viene scritto nel registro.

Il webhook funziona anche mentre il negozio è in modalità manutenzione, perché OpenCart lascia passare le richieste delle estensioni di pagamento (su OpenCart 4 l'estensione aggiunge per questo un proprio evento di avvio, che consente anche il ritorno del cliente da PayMongo).

L'estensione accetta pagamenti unici nella pagina di PayMongo. Non ha campi carta nella tua pagina di checkout, né carte salvate, né abbonamenti o pagamenti ricorrenti, né rate, né autorizzazione e cattura separate.

Ordini e rimborsi

Stati d'ordine

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

Stato dell'ordine dopo il pagamento (predefinito In lavorazione): il pagamento è stato confermato. Una nota mostra il pagamento PayMongo, l'importo, il metodo, la modalità e come è stato confermato (webhook, ritorno o nuovo tentativo di pagamento).

Pagamento PayMongo in attesa (predefinito In attesa): il cliente è tornato mentre PayMongo stava ancora elaborando il pagamento. L'ordine passa allo stato pagato quando PayMongo lo conferma.

Pagamento PayMongo in sospeso (predefinito In attesa): l'importo o la valuta pagati non corrispondono al totale dell'ordine; oppure un pagamento è stato effettuato in modalità test mentre il negozio è in modalità attiva, quindi non è arrivato denaro; oppure il pagamento è arrivato dopo l'annullamento dell'ordine. La nota lo spiega. Controlla l'ordine ed evadilo oppure rimborsa il pagamento.

Stato non riuscito (predefinito Fallito): un webhook payment.failed firmato ha segnalato che l'ultimo tentativo di pagamento di un ordine in attesa è fallito. La nota mostra il codice e il messaggio di errore di PayMongo. Se lo stesso pagamento riesce più tardi, l'ordine passa allo stato pagato.

Stato rimborsato (predefinito Rimborsato): il pagamento è stato rimborsato interamente tramite l'estensione.

Se arriva un secondo pagamento per un ordine già pagato, o per un altro ordine di un carrello già pagato, l'ordine pagato non viene modificato. Una nota ti chiede di rimborsare il pagamento duplicato nel PayMongo Dashboard. Un ordine pagato e poi annullato o rimborsato non viene mai riaperto.

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

Scheda VibeFox PayMongo Payment Gateway

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

Rimborsi

Nella scheda VibeFox PayMongo Payment Gateway inserisci l'Amount (viene compilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), e clicca su Refund via PayMongo. Conferma la domanda Refund this amount through PayMongo? This cannot be undone. Sono supportati rimborsi totali e parziali, con al massimo due decimali. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi sono limitati all'importo effettivamente addebitato da PayMongo, quindi dopo una differenza di importo puoi rimborsare fino a quanto ha pagato il cliente, non il totale dell'ordine. Il rimborso viene inviato con la chiave segreta della modalità in cui è stato effettuato il pagamento (test o attiva), quindi quella chiave deve essere impostata. Se PayMongo non accetta il rimborso, la scheda mostra l'errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto allo storico dei rimborsi e alle note con l'ID e lo stato del rimborso PayMongo. Un rimborso totale imposta l'ordine sullo Refunded status senza avvisare il cliente e senza rimettere i prodotti in magazzino, come un cambio di stato manuale. Un rimborso parziale non modifica lo stato.

Le restituzioni di prodotti in Sales > Returns non rimborsano denaro tramite PayMongo. I rimborsi effettuati nel PayMongo Dashboard non vengono comunicati a OpenCart. Effettua il rimborso dalla scheda dell'ordine oppure aggiorna l'ordine manualmente.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox di vibefox.net. Il blocco della licenza License — VibeFox PayMongo Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit, sopra le impostazioni. Inserisci 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 ci sono la riga Product: opencart-payment-paymongo 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 o License expired on seguito da una data. Dopo un cambio dell'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 dominio: l'indirizzo del negozio dalla 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, PayMongo 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 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 ricontrollato 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. Disinstallare l'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

PayMongo non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo, che la modalità attuale abbia una chiave segreta (Test secret key in modalità test, Live secret key in modalità attiva), che il cliente paghi in PHP e che il totale sia di almeno ₱100.00. 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: il webhook non funziona e il cliente non è tornato nel negozio. Nel PayMongo Dashboard controlla che esista un webhook nella modalità che usi, che il suo URL sia esattamente quello mostrato in Webhook URL e che siano selezionati i tre eventi. Controlla che il suo segreto di firma sia nel campo corrispondente (Test webhook secret o Live webhook secret).

Il webhook risponde Invalid signature: il segreto di firma di quella modalità manca oppure appartiene a un altro webhook. Incolla il segreto di firma del webhook nel campo della sua modalità.

Il webhook risponde Mode mismatch: un evento di prova è stato firmato come attivo o viceversa. Controlla che ogni webhook appartenga alla modalità giusta.

Il webhook risponde Temporary error: il pagamento non è stato verificato tramite le API di PayMongo, per esempio perché manca la chiave segreta della modalità del pagamento. PayMongo riprova automaticamente il webhook.

Il webhook risponde Busy, retry: l'ordine era in conferma da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. PayMongo riprova automaticamente il webhook. Il motivo è nel Log.

Il webhook risponde Ignored: l'evento appartiene a un pagamento non avviato in questo negozio, oppure a un'altra modalità. Non viene modificato nulla.

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

Il valore non è stato salvato: una chiave è stata incollata nel campo sbagliato. Le chiavi segrete iniziano con sk_test_ o sk_live_, i segreti dei webhook con whsk_.

Il cliente vede un errore dopo Confirm Order: controlla il campo Log nella pagina dell'estensione. Una chiave segreta errata dà il messaggio che il metodo di pagamento è temporaneamente non disponibile. Un metodo di pagamento non attivato per il tuo account PayMongo fa rifiutare il checkout da PayMongo; rimuovilo da Payment methods. This payment method is not available. Please reload the checkout page. significa che la sessione di checkout non corrisponde più all'ordine, oppure che nel frattempo il metodo di pagamento è stato disattivato.

Pagamenti di prova su un negozio attivo: un pagamento di prova arrivato mentre il negozio è in modalità attiva mette l'ordine nello stato di sospensione con una nota che indica che non è arrivato denaro. I pagamenti reali vengono sempre riconosciuti, anche dopo essere tornati alla modalità test, e vengono rimborsati con la chiave attiva.

L'ordine è nello stato di sospensione dopo il pagamento: leggi le note nella scheda VibeFox PayMongo Payment Gateway (vedi Stati d'ordine), poi evadi l'ordine o rimborsa il pagamento.

Nella scheda non c'è il modulo di rimborso: il pagamento non è ancora confermato, è stato rimborsato interamente, oppure il tuo gruppo utenti non ha il permesso di modificare l'estensione.

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

Per gli sviluppatori: prima della creazione della sessione di checkout, l'estensione attiva l'evento OpenCart paymongo_p_checkout_session_data con i dati della sessione e l'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox PayMongo Payment Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le impostazioni proprie dell'estensione: Enable/Disable, Sort Order, Geo Zone, Total e gli stati d'ordine della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 i suoi eventi e la sua azione di avvio, che consentono al webhook e al ritorno del cliente di passare in modalità manutenzione). Se Delete data on uninstall è attivo, vengono eliminate le altre impostazioni del gateway (titolo, descrizione, metodi di pagamento, modalità test, chiavi, segreti dei webhook, registrazione) e il registro. Se è disattivo, vengono conservate per una reinstallazione successiva. Gli ID PayMongo degli ordini e dei rimborsi vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti mantengono le loro note di pagamento.

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

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