VibeFox iPay88 for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x.

PHP: 8.0 o successivo. Il modulo non si installa su versioni precedenti di PHP.

Account commerciante iPay88: il Merchant Code e la Merchant Key vengono rilasciati da iPay88 quando il tuo account commerciante viene attivato. Sono anche visibili nel portale commerciante iPay88. Se non sei ancora commerciante, fai richiesta sul sito di iPay88. Tieni segreta la Merchant Key: firma i pagamenti. iPay88 non ha una sandbox separata, quindi non esistono chiavi di test.

URL di richiesta: l'indirizzo del tuo sito deve essere registrato presso iPay88 come URL di richiesta. Altrimenti la pagina iPay88 mostra "Permission not allow".

Valuta: Malaysia — MYR, e USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP o THB se l'opzione multivaluta è attiva sul tuo account iPay88; Philippines — PHP o USD; Indonesia — IDR; Thailand — THB. Se la valuta del carrello non può essere addebitata nella tua regione, il metodo di pagamento viene nascosto al checkout.

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un dominio.

Installazione

1. Nel back office vai su Modules > Module Manager e clicca su Upload a module. Scegli il file ZIP del modulo.

2. Al termine del caricamento, clicca su Configure, oppure trova più tardi VibeFox iPay88 Payment nell'elenco dei moduli e clicca su Configure.

3. Inserisci la tua chiave di licenza VibeFox in License key, nel blocco licenza in cima alla pagina Configure, e clicca su Activate (vedi Chiave di licenza).

4. Scegli la tua iPay88 region, inserisci il Merchant Code e la Merchant Key, attiva Enable/Disable e clicca su Save.

5. Per verificare la configurazione, effettua un pagamento con Test mode attivo, poi disattiva la modalità test.

All'installazione il modulo crea due stati dell'ordine: Awaiting iPay88 payment e iPay88 payment on hold. PrestaShop attiva il nuovo modulo di pagamento per tutte le valute, i paesi e i gruppi di clienti. Puoi limitarli in Payment > Preferences. Un paese che abiliti dopo l'installazione del modulo deve essere spuntato anche lì per il modulo, altrimenti i clienti di quel paese non vedranno iPay88. Gli URL di risposta e di backend vengono inviati con ogni pagamento.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox iPay88 Payment > Configure. Ogni pulsante Save salva l'intera pagina. Sopra i campi la pagina mostra Inserisci il Merchant Code e la Merchant Key di iPay88 — fino ad allora il metodo di pagamento non viene mostrato al checkout. quando manca una chiave, un avviso quando la valuta predefinita del negozio non può essere addebitata nella regione selezionata (il metodo di pagamento viene allora nascosto al checkout) e un avviso mentre la modalità test è attiva.

iPay88

Enable/Disable: Enable iPay88 Payment Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: iPay88.

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely via iPay88 (credit card, online banking, e-wallet).

Account iPay88

iPay88 region: il paese del tuo account commerciante iPay88. Determina la pagina di pagamento iPay88 e le valute addebitabili. L'ordine viene sempre addebitato nella sua valuta. Predefinito: Malaysia.

Merchant Code: il tuo Merchant Code iPay88, per esempio M01234.

Merchant Key: la tua Merchant Key iPay88. Firma le richieste di pagamento e verifica le risposte di iPay88. Tienila segreta. La chiave salvata non viene mai più mostrata: il campo resta vuoto e riporta Salvata — lascia vuoto per mantenerla. Inserisci un nuovo valore solo se vuoi cambiarla. La chiave viene salvata esattamente come la inserisci, comprese virgolette e barre rovesciate.

Clear saved secret: spunta Merchant Key e clicca su Save per rimuovere la chiave salvata. Un campo vuoto mantiene il valore salvato.

Signature type: come vengono firmate le richieste di pagamento. Le risposte vengono verificate in entrambi i formati, così i pagamenti avviati prima di un cambio restano verificabili.

Pagamento

Payment method: preseleziona un metodo di pagamento iPay88 dall'elenco PaymentId di Malaysia, oppure lascia Let the customer choose on the iPay88 page (predefinito). L'elenco comprende Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay e ShopeePay.

Reference prefix: facoltativo. Viene aggiunto prima del numero del carrello nel riferimento iPay88 (RefNo), per esempio SHOP1-. Usa un prefisso diverso in ogni negozio che utilizza lo stesso account iPay88, così la risposta di un negozio non viene mai applicata al carrello di un altro. Lettere, cifre, "-" e "_", fino a 10 caratteri. Gli altri caratteri vengono rimossi al salvataggio, e un prefisso che termina con una cifra riceve un "-" alla fine, perché il numero del carrello viene letto dalla fine del RefNo. La pagina mostra poi il valore salvato. Se passi da WooCommerce a PrestaShop con lo stesso account iPay88, imposta un prefisso in modo che i nuovi riferimenti non ripetano mai vecchi numeri d'ordine.

Test mode: Charge a fixed test amount instead of the order total. iPay88 non ha una sandbox separata: i pagamenti di test sono transazioni reali sulla pagina iPay88 in produzione con un piccolo importo (1,00; IDR 10.000). L'ordine viene segnato come pagato quando arriva l'importo di test, e la nota dell'ordine lo indica. Mentre la modalità test è attiva, il checkout mostra TEST MODE: only a test amount of ... will be charged. Un pagamento avviato in modalità test viene sempre verificato rispetto all'importo di test, anche se disattivi la modalità test prima che iPay88 risponda. Non lasciare mai la modalità test attiva in un negozio reale. Predefinito: disattivato.

URL di risposta e di backend

Il modulo invia entrambi gli URL con ogni pagamento, quindi non c'è nulla da configurare. Se iPay88 li richiede, copiali da questa sezione. Con URL parlanti hanno questo aspetto: https://your-shop/module/wcp_ipay88_payment/response (Response URL, il ritorno del cliente) e https://your-shop/module/wcp_ipay88_payment/backend (Backend URL, la notifica server-to-server), eventualmente con un codice lingua come /en/. La sezione mostra anche l'indirizzo del tuo sito, che deve essere registrato presso iPay88 come URL di richiesta.

Entrambe le risposte di iPay88 vengono controllate allo stesso modo: i campi obbligatori, la firma fatta con la tua Merchant Key e il riferimento di un pagamento che questo negozio ha avviato per questo carrello. Le risposte senza firma valida vengono rifiutate e non modificano mai un carrello o un ordine. La notifica di backend riceve RECEIVEOK solo dopo essere stata elaborata; altrimenti iPay88 la invia di nuovo. Funziona anche quando il negozio è in manutenzione e non è bloccata dalla restrizione per paese del tuo negozio. iPay88 segnala questi stati di pagamento:

Avanzate

Debug log: registra le richieste di pagamento e le risposte di iPay88 in logs/ipay88_p_debug.log.php nella cartella del modulo. Il file non può essere aperto dal web. Non vengono registrati dati personali, Merchant Key né firme. Errori e avvisi vengono sempre registrati, anche con l'interruttore disattivato. Predefinito: disattivato.

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

Delete data on uninstall: alla disinstallazione del modulo elimina impostazioni, registri e dati di pagamento iPay88. Gli ordini e gli stati degli ordini non vengono mai eliminati. Predefinito: disattivato.

Checkout

Nel passaggio di pagamento il cliente sceglie il metodo di pagamento (per impostazione predefinita iPay88) e conferma. La pagina successiva mostra Redirecting to iPay88 payment gateway... e Please do not close this window. mentre viene inviato un modulo alla pagina di pagamento iPay88 della tua regione. Senza JavaScript il cliente clicca su Pay Now. In questo momento non esiste ancora alcun ordine. Il modulo passa il totale del carrello nella valuta del carrello (l'importo di test in modalità test), i nomi dei prodotti, il nome, l'e-mail e il telefono del cliente. Sulla pagina iPay88 il cliente paga con carta, FPX (home banking online), portafoglio elettronico o un altro metodo offerto dal tuo account.

L'ordine viene segnato come pagato solo quando iPay88 lo conferma con una risposta firmata, sia al ritorno del cliente sia tramite la notifica di backend. Dopo un pagamento riuscito l'ordine viene creato e il cliente vede la pagina standard di conferma dell'ordine con Your iPay88 payment has been received. Per un pagamento in attesa la pagina mostra Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. Per un ordine in sospeso mostra We have received a payment notification from iPay88 and are reviewing it. We will contact you if anything is needed. Se l'ordine è in Payment error o è stato annullato, mostra The payment was not completed. Please contact us.

Se la conferma viene elaborata nello stesso momento dalla notifica di backend, il cliente vede We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. con i pulsanti Check again e Back to checkout.

Se il pagamento è fallito o è stato annullato, non viene creato alcun ordine e il carrello viene conservato. Il cliente torna al checkout con The payment was not completed: e il motivo di iPay88, seguito da You can try again or choose another payment method. Ogni tentativo dello stesso carrello usa lo stesso RefNo. Se la risposta non può essere verificata, il cliente vede The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. con un pulsante Return to the store.

Se il pagamento non può essere avviato, il cliente torna al checkout con This payment method is temporarily unavailable. Please choose another payment method. (chiavi mancanti o totale zero) oppure iPay88 cannot accept payments in ... Please choose another payment method. (valuta non addebitabile nella regione). Se il carrello ha già un ordine (pagato o in attesa di un pagamento in corso), non viene generato un secondo modulo di pagamento e il cliente viene inviato alla pagina di conferma dell'ordine.

Il modulo accetta solo pagamenti una tantum. Non prevede rimborsi da PrestaShop, carte salvate, abbonamenti, pre-autorizzazione e cattura, né campi della carta sul tuo sito. Non interroga di nuovo iPay88 sullo stato del pagamento: gli ordini vengono aggiornati solo dalla risposta di iPay88 e dalla notifica di backend.

Ordini

Order statuses

No order yet: il cliente è stato inviato a iPay88 e non è ancora arrivato alcun esito, oppure il pagamento è fallito. Esiste solo il carrello.

Payment accepted: iPay88 ha segnalato un pagamento riuscito con l'importo e la valuta attesi. Il pagamento viene registrato con il TransId di iPay88 come ID transazione. Una nota privata mostra TransID, PaymentID, importo e valuta. In modalità test una seconda nota indica che è stato addebitato l'importo di test invece del totale dell'ordine.

Awaiting iPay88 payment: iPay88 ha segnalato il pagamento come in attesa. L'ordine passa a Payment accepted quando iPay88 lo conferma, oppure a Payment error se fallisce.

Payment error: un pagamento in attesa è poi fallito. La nota mostra il motivo comunicato da iPay88. Questo carrello ha già un ordine, quindi il cliente non può pagarlo di nuovo e crea un nuovo ordine.

iPay88 payment on hold: iPay88 ha segnalato un pagamento riuscito con importo o valuta diversi da quelli dell'ordine, oppure il pagamento è arrivato dopo che l'ordine era stato annullato. L'ordine NON è stato segnato come pagato. La nota lo spiega. Verifica il pagamento nel portale iPay88, poi evadi l'ordine oppure rimborsa il pagamento.

Un ordine pagato o rimborsato non viene mai modificato da una risposta successiva. Se arriva per esso un altro pagamento riuscito, una nota ti chiede di verificarlo nel portale iPay88 e di rimborsarlo se è un duplicato. Una risposta di fallimento non modifica mai un ordine pagato, rimborsato o annullato. Le risposte ripetute non aggiungono nulla di nuovo.

Blocco pagamento iPay88

La pagina dell'ordine mostra un blocco iPay88 payment con RefNo, TransId, stato, importo richiesto, importo ricevuto, PaymentId, AuthCode, errore e regione, e un badge TEST MODE per i pagamenti di test.

Rimborsi

I rimborsi non vengono inviati a iPay88 da PrestaShop. Rimborsa il pagamento nel portale commerciante iPay88, poi registra manualmente il rimborso in PrestaShop.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza License — VibeFox iPay88 Payment è il primo blocco di Modules > Module Manager > VibeFox iPay88 Payment > Configure, sopra le impostazioni. Inserisci 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 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: presta-payment-ipay88 e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con il permesso Configure per il modulo possono cambiare la chiave. I testi del blocco seguono la lingua del back office (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, clicca su Check now. Se il server delle licenze non è raggiungibile, il modulo continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un solo dominio: quello del negozio principale, anche in una configurazione multistore. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, iPay88 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. Lo storefront di PrestaShop non sa che sei connesso al back office, quindi il metodo di pagamento è nascosto anche per te: puoi configurare il modulo prima di acquistare una chiave, ma non provarlo al checkout. Un promemoria compare in Modules > Module Manager, nella scheda Alerts. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati.

Quando una licenza scade, il modulo continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. Disinstallare o reimpostare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

iPay88 non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che Merchant Code e Merchant Key siano inseriti e che la valuta del carrello possa essere addebitata nella iPay88 region selezionata. La pagina delle impostazioni mostra un avviso quando manca qualcosa. In Payment > Preferences verifica che il modulo sia consentito per la valuta del carrello, il paese del cliente e il gruppo del cliente.

Il pagamento è andato a buon fine, ma non è stato creato alcun ordine: né il ritorno del cliente né la notifica di backend sono arrivati al tuo negozio con una firma valida. Controlla il campo Log: gli errori vengono sempre registrati. Verifica che la Merchant Key sia esattamente quella fornita da iPay88 e che il tuo server accetti le richieste di iPay88 all'indirizzo Backend URL mostrato nelle impostazioni.

La pagina iPay88 mostra "Permission not allow": l'indirizzo del tuo sito non è registrato presso iPay88 come URL di richiesta. Chiedi a iPay88 di registrare l'indirizzo mostrato nella sezione Response and backend URLs.

La notifica di backend risponde BAD SIGNATURE: la firma non corrisponde alla Merchant Key. Controlla la Merchant Key. Non è stato modificato nulla.

La notifica di backend risponde NOT CONFIGURED: Merchant Code o Merchant Key non sono impostati, quindi la risposta non può essere verificata. iPay88 invia di nuovo la notifica.

La notifica di backend risponde UNKNOWN ORDER: non è stato avviato alcun pagamento iPay88 per questo riferimento in questo negozio, per esempio perché un altro negozio con lo stesso account non usa alcun Reference prefix oppure usa lo stesso, o perché i dati di pagamento iPay88 sono stati eliminati alla disinstallazione.

La notifica di backend risponde RETRY: il carrello era in fase di conferma dal ritorno del cliente nello stesso momento, oppure l'ordine non ha potuto essere creato (per esempio perché il modulo è disattivato). iPay88 invia di nuovo la notifica.

La Backend URL mostra BAD REQUEST nel browser: è normale. L'URL accetta solo richieste firmate da iPay88.

L'ordine è iPay88 payment on hold: iPay88 ha segnalato un pagamento che non corrisponde all'ordine, oppure l'ordine era stato annullato. Controlla la nota dell'ordine e il pagamento nel portale iPay88, poi completa l'ordine o rimborsa il pagamento.

Il cliente vede "iPay88 cannot accept payments in" seguito da una valuta: la valuta del carrello non può essere addebitata nella regione selezionata. Su iPay88 Malaysia, le valute diverse da MYR richiedono anche l'opzione multivaluta sul tuo account iPay88.

I clienti reali vengono addebitati solo di 1,00: la Test mode è attiva. Disattivala.

Disinstallazione

Vai su Modules > Module Manager, apri il menu accanto a VibeFox iPay88 Payment e scegli Uninstall. La chiave di licenza e lo stato della licenza di questo modulo vengono sempre rimossi. La conferma indica che impostazioni e dati di pagamento iPay88 vengono conservati, a meno che Delete data on uninstall non sia attivo. Se è attivo, vengono rimosse impostazioni, registri e dati di pagamento iPay88. Se è disattivo, tutto viene conservato per una successiva reinstallazione. Gli stati d'ordine Awaiting iPay88 payment e iPay88 payment on hold vengono sempre conservati. Gli ordini non vengono mai eliminati e conservano le loro note di pagamento e gli ID di transazione.

iPay88 è un marchio registrato del rispettivo titolare. Questo modulo non è affiliato a iPay88 né approvato da iPay88.