VibeFox iPay88 for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 7.0 o successivo, installato e attivo. Senza WooCommerce il plugin non si attiva.

PHP: 8.0 o successivo.

Account commerciante iPay88: il Merchant Code e la Merchant Key vengono rilasciati da iPay88 quando il tuo account commerciante viene attivato. Sono visibili anche nel portale commercianti di iPay88. Se non sei ancora un commerciante, fai richiesta sul sito di iPay88. Tieni segreta la Merchant Key: firma i pagamenti.

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

Valuta del negozio: 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.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

1. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. In alternativa puoi caricare la cartella wcp_ipay88_payment in /wp-content/plugins/ tramite FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > iPay88 > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.

4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Scegli la tua iPay88 region e inserisci il Merchant Code e la Merchant Key (vedi Configurazione).

6. Attiva Enable/Disable. Per verificare la configurazione, effettua un pagamento con Test mode attivo, poi disattivalo.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > iPay88. Sopra i campi, la pagina ti avvisa se manca il Merchant Code o la Merchant Key (in quel caso il metodo di pagamento non viene mostrato al checkout), se la valuta del negozio non può essere addebitata nella regione selezionata e finché la modalità test è attiva. Nell'elenco dei metodi di pagamento, iPay88 risulta da configurare finché non vengono inserite entrambe le chiavi, e mostra un badge di modalità test finché questa è attiva.

Generali

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

Title: il nome del metodo di pagamento che i clienti vedono al checkout. 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 che possono essere addebitate. 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.

Signature type: il modo in cui vengono firmate le richieste di pagamento. Le risposte vengono verificate in entrambi i formati.

Pagamento

Payment method: preseleziona un metodo di pagamento iPay88 dall'elenco PaymentId malese, 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 dell'ordine nel riferimento iPay88 (RefNo), per esempio SHOP1-. Usa un prefisso diverso in ogni negozio che utilizza lo stesso account iPay88, così una risposta di un negozio non potrà mai essere applicata a un ordine di un altro. Lettere, cifre, "-" e "_", fino a 10 caratteri. Un prefisso che termina con una cifra viene corretto al salvataggio, perché il numero dell'ordine viene letto dalla fine del riferimento.

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 attiva 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. Con la modalità test attiva, il checkout mostra TEST MODE: only a test amount of ... will be charged. Non lasciare mai la modalità test attiva in un negozio reale. Predefinito: disattivato.

URL di risposta e di backend

Il plugin invia entrambi gli URL con ogni pagamento, quindi non c'è nulla da configurare. Se iPay88 li richiede, copiali da questa sezione delle impostazioni. Hanno questo aspetto: https://your-site/wc-api/ipay88_p_response/ (Response URL, il ritorno del cliente) e https://your-site/wc-api/ipay88_p_backend/ (Backend URL, la notifica server-to-server). La sezione mostra anche l'indirizzo del tuo sito, che deve essere registrato presso iPay88 come Request URL.

Entrambe le risposte di iPay88 vengono verificate allo stesso modo: la firma calcolata con la tua Merchant Key, il riferimento di un pagamento avviato da questo negozio per questo ordine, l'importo e la valuta. Le richieste senza firma valida vengono rifiutate e non modificano mai un ordine. La notifica di backend riceve RECEIVEOK solo dopo essere stata elaborata; altrimenti iPay88 la invia di nuovo. iPay88 segnala questi stati di pagamento:

Avanzate

Debug log: Log payment requests and iPay88 responses in WooCommerce > Status > Logs, origine wcp_ipay88_payment, senza dati personali né firme. Gli errori vengono sempre registrati. Predefinito: disattivato.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. Gli ordini in sé non vengono mai eliminati. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita iPay88) e conferma l'ordine. L'ordine resta in Pending payment e il cliente vede Redirecting to iPay88 payment gateway... mentre un modulo viene inviato alla pagina di pagamento iPay88 della tua regione. Senza JavaScript, il cliente fa clic su Pay Now. Gli articoli dell'ordine, il nome, l'e-mail e il telefono del cliente vengono trasmessi a iPay88. Sulla pagina iPay88 il cliente paga con carta, FPX (home banking online), portafoglio elettronico o un altro metodo offerto dal tuo account.

Dopo il pagamento, il cliente torna alla pagina di conferma ordine del tuo negozio. 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. Se la conferma non è ancora arrivata, la pagina mostra We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. Per un pagamento in attesa mostra Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

Se il pagamento è fallito o è stato annullato, il cliente arriva alla pagina Pay for order con The payment was not completed: e il motivo fornito da iPay88, e può pagare di nuovo o scegliere un altro metodo di pagamento. 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 link di ritorno al negozio.

Il magazzino viene scaricato quando il pagamento è confermato, non quando il cliente viene reindirizzato. Il metodo di pagamento funziona nel checkout classico, nel blocco Checkout e nella pagina Pay for order. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin accetta solo pagamenti una tantum. Non prevede rimborsi da WooCommerce, 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. L'API 2.0 di iPay88 Indonesia (JSON / link di pagamento) non viene usata.

Ordini

Order statuses

Pending payment: il cliente è stato inviato a iPay88 e non ha ancora pagato, oppure iPay88 non ha ancora confermato il pagamento.

Processing or Completed: il pagamento è stato confermato. WooCommerce imposta lo stato usuale per un ordine pagato. La nota dell'ordine mostra il TransID, il PaymentID, l'importo e la valuta di iPay88. L'ID transazione è il TransID di iPay88. In modalità test, una seconda nota indica che è stato addebitato l'importo di test invece del totale dell'ordine.

On hold, pending at iPay88: iPay88 ha segnalato il pagamento come in attesa. L'ordine verrà aggiornato quando iPay88 confermerà o farà fallire il pagamento.

On hold, for review: iPay88 ha segnalato un pagamento riuscito con un importo o una 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 dell'ordine lo spiega. Controlla il pagamento nel portale iPay88, poi evadi l'ordine o rimborsa il pagamento.

Failed: il pagamento è fallito o è stato annullato. La nota mostra il motivo fornito da iPay88. Il cliente può pagare di nuovo.

Se arriva un altro pagamento riuscito per un ordine già pagato o rimborsato, l'ordine non viene modificato. Una nota ti chiede di verificarlo nel portale iPay88 e di rimborsarlo se è un duplicato. Una risposta di errore non modifica mai un ordine pagato, rimborsato o annullato.

Rimborsi

I rimborsi non vengono inviati a iPay88 da WooCommerce. Rimborsa il pagamento nel portale commercianti iPay88 e registra manualmente il rimborso in WooCommerce.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Payments > iPay88. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino a cui la licenza è attiva, e il tuo dominio. Usa Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il link Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un solo dominio. Rimuovere la chiave da un sito non libera il suo slot di dominio. Libera lo slot 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. Gli amministratori del negozio che hanno effettuato l'accesso vedono ancora il metodo di pagamento, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugins e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente in background.

Risoluzione dei problemi

iPay88 non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che il Merchant Code e la Merchant Key siano inseriti e che la valuta del negozio possa essere addebitata nella iPay88 region selezionata. La pagina delle impostazioni mostra un avviso quando manca qualcosa.

Il pagamento è andato a buon fine, ma l'ordine resta in Pending payment: né il ritorno del cliente né la notifica di backend sono arrivati al tuo negozio con una firma valida. Attiva il Debug log e controlla WooCommerce > Status > Logs, origine wcp_ipay88_payment. Verifica che la Merchant Key sia esattamente quella fornita da iPay88 e che il tuo sito possa ricevere richieste da 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 Request URL. 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.

La notifica di backend risponde NOT CONFIGURED: il Merchant Code o la 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: per questo riferimento non è stato avviato alcun pagamento iPay88 su questo negozio, per esempio perché un altro negozio con lo stesso account non usa un Reference prefix o usa lo stesso.

L'ordine è On hold con una nota su importo o valuta: iPay88 ha segnalato un pagamento che non corrisponde all'ordine, oppure l'ordine era stato annullato. L'ordine non è stato segnato come pagato. Controlla il pagamento nel portale iPay88 e completalo o rimborsalo.

Il cliente vede "iPay88 cannot accept payments in" con una valuta: la valuta dell'ordine 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 1,00: la Test mode è attiva. Disattivala.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera uno slot nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Gli sviluppatori possono modificare l'URL della pagina di pagamento, le valute, i decimali, l'importo di test e l'icona con i filtri ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount e ipay88_p_icon.

Disinstallazione

Disattivare il plugin mantiene tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway, i log e i dati iPay88 salvati sugli ordini vengono rimossi solo se Delete data on uninstall era attivo. Altrimenti restano disponibili per una reinstallazione successiva. Gli ordini in sé non vengono mai eliminati e conservano le note di pagamento e gli ID transazione.

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