VibeFox Moyasar 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: la valuta del checkout deve essere SAR, AED, USD, EUR, KWD, BHD o OMR. Per qualsiasi altra valuta il metodo di pagamento viene nascosto al checkout.

Account Moyasar: ti servono le chiavi API segrete del tuo account Moyasar (di test e live). Vengono usate solo le chiavi segrete. La chiave pubblicabile non è necessaria, perché il pagamento avviene nella pagina di Moyasar. Si consiglia un webhook nella Dashboard di Moyasar (vedi Configurazione).

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. Scompattalo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_moyasar_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. Nel pannello di amministrazione vai su Extensions > Installer, clicca su Upload e scegli il file wcp_moyasar_payment_gateway-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 Moyasar Payment 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. Incolla le tue chiavi segrete Moyasar e clicca su Save. Il primo salvataggio genera il segreto condiviso del webhook e lo mostra una sola volta sopra le impostazioni. Configura il webhook nella Dashboard di Moyasar con questo segreto (vedi Configurazione).

5. Attiva Enable/Disable e clicca su Save. Effettua un ordine di prova in modalità test, poi disattiva Test mode.

OpenCart 4

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

4. Inserisci la chiave di licenza, le chiavi Moyasar e il webhook come ai passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali nelle due versioni. Cambia solo l'URL del webhook (vedi Webhook URL).

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 Moyasar 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 modalità attuale non ha una chiave segreta (il metodo di pagamento viene allora nascosto al checkout), quando non è salvato alcun segreto condiviso del webhook (il webhook rifiuta quindi ogni chiamata) o quando la valuta predefinita del negozio non è supportata. Mentre l'estensione è attiva in modalità test, mostra La modalità test è attiva: i pagamenti sono simulati e non viene addebitato denaro. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title deve avere da 1 a 128 caratteri, Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total deve essere un numero maggiore o uguale a 0, e la zona geografica e gli stati dell'ordine devono esistere; altrimenti non viene salvato nulla. L'estensione rifiuta una chiave pubblicabile, una chiave dell'altra modalità o una chiave con spazi: il resto viene salvato con Impostazioni salvate, tranne la chiave mostrata in rosso., la chiave precedente viene mantenuta e viene mostrato il motivo. Se l'estensione viene attivata senza la chiave segreta della modalità attuale, le impostazioni vengono salvate con un avviso.

Moyasar

Enable/Disable: Enable Moyasar 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 salvato nell'ordine. Predefinito: Pay with Moyasar. 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 the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. In modalità test, il passaggio aggiunge (Modalità test: nessun pagamento reale viene effettuato.)

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

Geo Zone: offri Moyasar 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 Moyasar. Lascia il campo vuoto per offrire Moyasar con qualsiasi totale.

Chiavi API

Copia le chiavi segrete da Moyasar Dashboard > Settings > API Keys (la pagina contiene un link). Le chiavi di test e quelle live sono separate. La modalità test usa solo la chiave di test; la modalità live usa solo la chiave live.

Test mode: usa la chiave segreta di test: i pagamenti vengono simulati e non viene addebitato denaro. Predefinito: attivo. Disattivala per accettare pagamenti reali con la chiave segreta live. Le fatture dell'altra modalità continuano a usare la chiave della propria modalità per i controlli di stato e i rimborsi.

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

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

Le chiavi e i segreti salvati non vengono mai più mostrati. Il campo resta vuoto e riporta Salvato — lascialo vuoto per mantenerlo. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere un valore salvato, spunta Clear the saved value on save sotto il campo e clicca su Save.

Notifiche di pagamento (webhook)

Il webhook è consigliato, ma non obbligatorio. Gli ordini vengono confermati anche quando il cliente torna nel negozio e tramite la notifica della fattura che Moyasar invia automaticamente al tuo negozio quando la fattura viene pagata. Il webhook copre i clienti che chiudono il browser prima di tornare e segnala i rimborsi effettuati nella Dashboard di Moyasar. Aggiungilo in Moyasar Dashboard > Settings > Webhooks.

Webhook URL: mostrato in sola lettura con un pulsante Copy. Su OpenCart 3 ha questo aspetto https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook, su OpenCart 4 https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook. È costruito a partire dall'indirizzo pubblico della tua installazione di OpenCart. Copia l'URL esattamente come lo mostrano le impostazioni. Metodo HTTP: POST. L'URL deve essere raggiungibile da internet.

Webhook shared secret: inserisci lo stesso valore di Shared secret del webhook in Moyasar, oppure spunta Generate a new secret e salva. Se non c'è nulla di salvato, Save genera un segreto casuale. Un segreto generato viene mostrato una sola volta sopra le impostazioni dopo il salvataggio e mai più, quindi copialo subito in Moyasar. I webhook senza il segreto condiviso corretto vengono rifiutati. Un unico segreto condiviso vale per entrambe le modalità.

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

Nessun dato proveniente da un webhook o da una notifica viene considerato attendibile direttamente: per ciascuno, l'estensione legge la fattura dall'API di Moyasar con la chiave segreta della modalità in cui la fattura è stata creata e verifica che sia stata creata da questo negozio. I pagamenti di altre integrazioni sullo stesso account Moyasar vengono ignorati.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (un ordine incompleto). L'ordine riceve uno stato solo dopo che Moyasar ha confermato la fattura. Ogni campo qui sotto elenca gli stati ordine del tuo OpenCart.

Status after payment: lo stato impostato dopo un pagamento confermato. Predefinito: In lavorazione. Scegli Complete se gli ordini pagati devono essere completati subito, oppure il tuo stato di verifica se ogni ordine pagato deve attendere un controllo manuale.

Awaiting Moyasar payment status: Moyasar trattiene il pagamento per una verifica; l'ordine passa a Status after payment quando Moyasar lo conferma. Predefinito: In attesa.

Moyasar payment on hold status: Moyasar ha segnalato un importo o una valuta diversi dal totale dell'ordine, oppure la fattura è stata pagata dopo che l'ordine era stato annullato o aveva ricevuto un altro stato. L'ordine non viene segnato come pagato. Predefinito: In attesa, perché OpenCart non ha uno stato In sospeso. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Payment error status: il pagamento in verifica non è riuscito. Predefinito: Fallito.

Refunded status: impostato dopo che il pagamento è stato rimborsato per intero dalla pagina dell'ordine. Predefinito: Rimborsato.

Avanzate

Debug log: registra le chiamate API e le notifiche in moyasar_p_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 moyasar_p_debug.old.log.php. Errori e avvisi vengono sempre registrati. Chiavi API, dati delle carte e dati dei clienti non vengono mai registrati. Predefinito: disattivato.

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

Clean uninstall: se attivo, disinstallando l'estensione vengono rimosse le impostazioni del gateway e il log. I dati di pagamento salvati con gli ordini (gli ID di fattura e di pagamento di Moyasar) vengono conservati, in modo che i rimborsi restino tracciabili. Predefinito: disattivato.

Importa / Esporta

Export: Download JSON salva le impostazioni in un file JSON. Chiavi e segreti non vengono esportati.

Import: incolla un JSON esportato in precedenza e clicca su Import per ripristinare le impostazioni. Chiavi e segreti salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita Pay with Moyasar). 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 crea una fattura Moyasar per il totale dell'ordine nella valuta dell'ordine e invia il cliente alla relativa pagina di pagamento. Lì il cliente paga con uno qualsiasi dei metodi attivi sul tuo account Moyasar. 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. La fattura mostra Order #, il numero dell'ordine e il nome del tuo negozio.

L'ordine viene segnato come pagato solo dopo la conferma di Moyasar: l'estensione legge la fattura dall'API di Moyasar e verifica che sia pagata, che appartenga a questo ordine e che abbia esattamente l'importo e la valuta dell'ordine. Poi l'ordine riceve il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento delle scorte, e il cliente vede la pagina di successo dell'ordine di OpenCart con Hai ricevuto il tuo pagamento con Moyasar. Se Moyasar trattiene il pagamento per una verifica, la pagina mostra Il tuo pagamento è in fase di verifica da parte di Moyasar. L'ordine verrà aggiornato automaticamente quando Moyasar lo confermerà — non pagare di nuovo. Se l'ordine è in sospeso per la tua verifica, la pagina mostra Abbiamo ricevuto il tuo pagamento e stiamo verificando il tuo ordine. Ti contatteremo se servirà qualcosa — non pagare di nuovo. Se un pagamento in verifica fallisce in seguito, la pagina mostra Il tuo pagamento con Moyasar non è stato completato. Contattaci per questo ordine.

Se il cliente torna senza aver pagato (per esempio con il pulsante indietro della pagina di pagamento), torna al checkout con uno di questi messaggi: Il pagamento su Moyasar non è stato completato. Puoi riprovare o scegliere un altro metodo di pagamento., Il tuo pagamento con Moyasar è stato rifiutato o è scaduto. Riprova o scegli un altro metodo di pagamento. oppure, quando il pagamento non può ancora essere verificato, Non siamo ancora riusciti a confermare il tuo pagamento con Moyasar. Se hai completato il pagamento, l'ordine verrà aggiornato automaticamente in pochi minuti — controlla la tua e-mail prima di pagare di nuovo. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout. Il carrello viene conservato.

Il cliente può riprovare. OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order, mentre OpenCart 4 mantiene un solo ordine per il checkout e paga di nuovo lo stesso ordine. L'estensione controlla prima le fatture aperte dello stesso carrello: se la pagina di pagamento aperta di questo ordine ha ancora la stessa modalità, lo stesso importo e la stessa valuta, viene riutilizzata; altrimenti la vecchia fattura viene annullata in Moyasar e ne viene creata una nuova, così che la vecchia non possa più essere pagata. Se risulta che una fattura precedente del carrello è già stata pagata, viene confermato quel pagamento invece di crearne uno nuovo.

OpenCart 4 mantiene l'ordine nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso senza pagamento (per esempio perché lo hai annullato o il suo pagamento non è riuscito), il cliente torna al checkout con il messaggio Your previous order was cancelled or its payment failed. Please confirm the order again., e il successivo Confirm Order paga un nuovo ordine. Un ordine del carrello che è stato pagato e poi annullato o rimborsato non trattiene più il carrello.

Se Moyasar non riesce ad avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio sopra il pulsante, per esempio Il servizio di pagamento Moyasar non risponde. Riprova tra qualche minuto., e può scegliere un altro metodo di pagamento. I dettagli vengono scritti nel log.

Il webhook e la notifica della fattura funzionano anche quando il negozio è in modalità manutenzione, perché OpenCart 3 lascia passare le richieste delle estensioni di pagamento, mentre su OpenCart 4 l'estensione aggiunge per queste richieste un'azione di avvio (startup action), che consente anche al cliente di tornare da Moyasar.

L'estensione accetta solo pagamenti singoli sulla pagina di Moyasar. Non ha un modulo carta sul tuo checkout, né carte salvate o tokenizzazione, né abbonamenti, né autorizzazione e cattura separate.

Ordini e rimborsi

Stati dell'ordine

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

Status after payment (predefinito In lavorazione): il pagamento è stato confermato. Una nota indica come è stato confermato (webhook, notifica della fattura, ritorno del cliente o checkout), l'ID della fattura, l'ID del pagamento e il metodo di pagamento, per esempio il marchio della carta e le ultime quattro cifre.

Awaiting Moyasar payment status (predefinito In attesa): Moyasar trattiene il pagamento per una verifica. L'ordine passa a Status after payment quando Moyasar conferma il pagamento, oppure a Payment error status quando il pagamento fallisce.

Moyasar payment on hold status (predefinito In attesa): Moyasar ha segnalato un importo o una valuta diversi dal totale dell'ordine, oppure la fattura è stata pagata dopo che avevi annullato l'ordine o cambiato il suo stato. L'ordine non viene segnato come pagato, ma l'importo effettivamente addebitato viene registrato per i rimborsi. La nota lo spiega. Controlla il pagamento nella Dashboard di Moyasar e poi evadi l'ordine o rimborsa il pagamento.

Payment error status (predefinito Fallito): il pagamento in verifica non è riuscito.

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

Un ordine pagato o rimborsato non viene mai modificato da eventi successivi. Se hai già impostato tu stesso uno stato di pagato, il pagamento viene registrato e lo stato non cambia. Se viene pagata anche una seconda fattura di un carrello già pagato (per esempio da due schede del browser), l'ordine pagato non cambia. Una nota ti chiede di rimborsare il pagamento duplicato nella Dashboard di Moyasar.

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

Scheda VibeFox Moyasar Payment Gateway

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

Rimborsi

Nella scheda VibeFox Moyasar Payment Gateway inserisci l'Amount (viene precompilato l'importo non ancora rimborsato), facoltativamente un Reason (optional), poi clicca su Refund via Moyasar. Conferma la domanda Rimborsare questo importo tramite Moyasar? Non è possibile annullare l'operazione. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). I rimborsi vengono effettuati nell'importo e nella valuta addebitati da Moyasar, quindi, dopo una differenza di importo, puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. Un rimborso totale di un pagamento con carta effettuato meno di 2 ore fa viene inviato come annullamento (void: cancellazione prima del regolamento, senza commissioni); i pagamenti con STC Pay e tutti gli altri casi vengono rimborsati. Il rimborso usa la chiave segreta della modalità in cui è stato effettuato il pagamento (test o live), quindi quella chiave deve essere impostata. L'estensione verifica prima su Moyasar valuta, stato e importo rimborsabile del pagamento. Se Moyasar non accetta il rimborso, la scheda mostra l'errore e nessun rimborso viene registrato. Un rimborso o un annullamento riuscito viene aggiunto allo storico dei rimborsi e alle note. Un rimborso totale imposta l'ordine al Refunded status senza avvisare il cliente e senza rimettere in magazzino i prodotti, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato. I rimborsi sono disponibili quando Moyasar ha confermato il pagamento.

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

I rimborsi e gli annullamenti effettuati nella Dashboard di Moyasar arrivano tramite il webhook. Se Moyasar mostra più importo rimborsato di quanto registrato dall'estensione, all'ordine viene aggiunta una nota. Lo stato dell'ordine non cambia automaticamente. Aggiornalo manualmente se necessario, senza usare Refund via Moyasar.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco della licenza License — VibeFox Moyasar Payment Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e clicca su Activate. Dopo di che il blocco mostra la chiave mascherata, lo stato (per esempio la data fino a cui la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto ci sono la riga Product: opencart-payment-moyasar 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. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, Moyasar 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 continua a vedere il metodo di pagamento nel negozio, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede il login dell'amministrazione, 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 un 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 a settimana. Non serve alcun cron job. Disinstallare l'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

Moyasar non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità attuale abbia una chiave segreta: Test secret key in modalità test, Live secret key in modalità live. La pagina delle impostazioni mostra un avviso quando manca la chiave. Il cliente deve pagare in SAR, AED, USD, EUR, KWD, BHD o OMR (la valuta selezionata nel negozio). 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: le conferme non sono arrivate al tuo negozio. Configura il webhook: nella Dashboard di Moyasar verifica che esista, che il suo URL sia esattamente il Webhook URL delle impostazioni, che il metodo sia POST, che siano selezionati i quattro eventi e che il suo segreto condiviso coincida con quello salvato in Webhook shared secret. L'ordine riceve comunque il suo stato quando il cliente torna nel negozio o tenta di pagare di nuovo lo stesso carrello.

Il webhook risponde Unauthorized: il segreto condiviso in Moyasar è diverso da quello salvato. Inserisci il segreto del webhook di Moyasar in Webhook shared secret e salva, oppure spunta Generate a new secret, salva e incolla in Moyasar il segreto mostrato.

Il webhook risponde Webhook secret not configured: non è salvato alcun segreto condiviso, per esempio dopo averlo rimosso con Clear the saved value on save. Clicca su Save per generarne uno e copialo in Moyasar.

Il webhook risponde Key not configured: la fattura è stata creata in una modalità (test o live) la cui chiave segreta è vuota. Inserisci quella chiave.

Il webhook risponde Verification failed o Try again later: la fattura non è stata letta dall'API di Moyasar, il carrello era in aggiornamento da un'altra richiesta nello stesso momento, oppure non è stato possibile impostare lo stato dell'ordine. Moyasar riproverà il webhook. Attiva il Debug log per vedere il motivo.

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

Errore al salvataggio riguardo alla chiave: è stata incollata una chiave pubblicabile (pk_...) o una chiave dell'altra modalità, oppure la chiave contiene spazi. Il valore precedente è stato mantenuto. Le chiavi di test iniziano con sk_test_, quelle live con sk_live_.

Il cliente vede un errore dopo Confirm Order: attiva il Debug log e consulta il campo Log nella pagina dell'estensione. Il messaggio Questo metodo di pagamento non è disponibile. significa che la sessione di checkout non corrisponde più all'ordine, oppure che nel frattempo il metodo di pagamento è stato disattivato: il cliente ricarica il checkout. Il messaggio Questo metodo di pagamento non è temporaneamente disponibile. Scegli un altro metodo di pagamento o contattaci. di solito indica una chiave segreta errata o mancante. Il messaggio Per questo ordine è già stato ricevuto un pagamento ed è in fase di verifica. Contattaci invece di pagare di nuovo. significa che il carrello ha già una fattura pagata il cui stato ordine non è stato possibile impostare; controlla il log.

L'ordine è nello stato di sospensione dopo il pagamento: leggi le Moyasar notes nella scheda VibeFox Moyasar Payment Gateway. L'importo o la valuta pagati erano diversi dall'ordine, oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Evadi l'ordine o rimborsa il pagamento.

Nella scheda non c'è il modulo di rimborso: la scheda indica il motivo: il pagamento non è ancora confermato, è rimborsato per intero, oppure il tuo gruppo utenti non ha il permesso di modificare l'estensione.

Il rimborso non riesce: leggi il messaggio. Se il pagamento è stato effettuato nell'altra modalità, inserisci la chiave segreta di quella modalità. Se l'importo è superiore a quello ancora rimborsabile su Moyasar, una parte del pagamento è già stata rimborsata, per esempio nella Dashboard di Moyasar. Se Moyasar non ha confermato l'importo rimborsato, controlla il pagamento nella Dashboard di Moyasar prima di riprovare.

Per gli sviluppatori: l'estensione attiva gli eventi di OpenCart moyasar_p_supported_currencies e moyasar_p_invoice_params per modificare le valute supportate e i dati della fattura.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e clicca su Uninstall (il pulsante rosso −) accanto a VibeFox Moyasar Payment 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 dell'ordine della sezione Orders, che tornano ai valori predefiniti in caso di nuova installazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua azione di avvio, che fa passare il webhook in modalità manutenzione). Se Clean uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità test, chiavi, segreto condiviso del webhook, log di debug) e il log. Se è disattivato, vengono conservate per una successiva reinstallazione. Le fatture, i pagamenti e i rimborsi di Moyasar vengono sempre conservati, quindi gli ordini vecchi 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, vai su Extensions > Installer dopo la disinstallazione e clicca su Uninstall (il pulsante arancione −) accanto a VibeFox Moyasar Payment Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

Moyasar è un marchio registrato del rispettivo proprietario. Questa estensione non è affiliata a Moyasar né da essa approvata.