VibeFox iPay88 for WooCommerce — Aide

Prérequis

WordPress : 6.0 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé. Sans WooCommerce, l'extension refuse de s'activer.

PHP : 8.0 ou ultérieur.

Compte marchand iPay88 : le Merchant Code et la Merchant Key sont délivrés par iPay88 lorsque votre compte marchand est activé. Ils figurent aussi dans le portail marchand d'iPay88. Si vous n'êtes pas encore marchand, faites votre demande sur le site d'iPay88. Gardez la Merchant Key secrète : elle signe les paiements.

Request URL : l'adresse de votre site doit être enregistrée auprès d'iPay88 comme Request URL. Sinon, la page iPay88 affiche « Permission not allow ».

Devise de la boutique : Malaysia — MYR, et USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP ou THB si l'option multidevise est activée sur votre compte iPay88 ; Philippines — PHP ou USD ; Indonesia — IDR ; Thailand — THB.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_ipay88_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > iPay88 > Manage, ou cliquez sur Settings sous le nom de l'extension sur la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Choisissez votre iPay88 region et saisissez le Merchant Code et la Merchant Key (voir Configuration).

6. Activez Enable/Disable. Pour vérifier la configuration, effectuez un paiement avec le Test mode activé, puis désactivez le mode test.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > iPay88. Au-dessus des champs, la page vous avertit si le Merchant Code ou la Merchant Key manque (le mode de paiement n'apparaît alors pas au paiement), si la devise de la boutique ne peut pas être débitée dans la région choisie, et tant que le mode test est activé. Dans la liste des modes de paiement, iPay88 est signalé comme nécessitant une configuration tant que les deux clés ne sont pas saisies, et affiche un badge de mode test tant que celui-ci est activé.

Général

Enable/Disable : Enable iPay88 Payment Gateway active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement que voient les clients au paiement. Par défaut : iPay88.

Description : le texte affiché sous le mode de paiement au moment du paiement. Par défaut : Pay securely via iPay88 (credit card, online banking, e-wallet).

Compte iPay88

iPay88 region : le pays de votre compte marchand iPay88. Elle détermine la page de paiement iPay88 et les devises pouvant être débitées. La commande est toujours débitée dans sa propre devise. Par défaut : Malaysia.

Malaysia (payment.ipay88.com.my) : MYR, et les autres devises listées dans les Prérequis si l'option multidevise est activée sur votre compte.

Philippines (payment.ipay88.com.ph) : PHP, USD.

Indonesia (payment.ipay88.co.id) : IDR, envoyé sans décimales.

Thailand (payment.ipay88.co.th) : THB.

Merchant Code : votre Merchant Code iPay88, par exemple M01234.

Merchant Key : votre Merchant Key iPay88. Elle signe les demandes de paiement et vérifie les réponses d'iPay88. Gardez-la secrète.

Signature type : la manière dont les demandes de paiement sont signées. Les réponses sont vérifiées dans les deux formats.

SHA256 (recommended) : la spécification actuelle d'iPay88 (par défaut).

SHA1 (legacy) : ne le choisissez que si iPay88 vous a demandé d'utiliser l'ancienne signature.

Paiement

Payment method : présélectionnez un mode de paiement iPay88 dans la liste PaymentId malaisienne, ou laissez Let the customer choose on the iPay88 page (par défaut). La liste comprend 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 et ShopeePay.

Reference prefix : facultatif. Il est ajouté devant le numéro de commande dans la référence iPay88 (RefNo), par exemple SHOP1-. Utilisez un préfixe différent dans chaque boutique qui partage le même compte iPay88, afin qu'une réponse d'une boutique ne puisse jamais être appliquée à une commande d'une autre. Lettres, chiffres, « - » et « _ », jusqu'à 10 caractères. Un préfixe qui se termine par un chiffre est corrigé à l'enregistrement, car le numéro de commande est lu depuis la fin de la référence.

Test mode : Charge a fixed test amount instead of the order total. iPay88 n'a pas de bac à sable séparé : les paiements de test sont de vraies transactions sur la page de paiement iPay88 en production, pour un petit montant (1,00 ; IDR 10 000). La commande est marquée comme payée une fois le montant de test reçu, et la note de commande l'indique. Tant que le mode test est activé, le paiement affiche TEST MODE: only a test amount of ... will be charged. Ne laissez jamais le mode test activé sur une boutique en production. Par défaut : désactivé.

URL de réponse et URL backend

L'extension transmet les deux URL à chaque paiement, il n'y a donc rien à configurer. Si iPay88 les demande, copiez-les depuis cette section des réglages. Elles ressemblent à https://your-site/wc-api/ipay88_p_response/ (Response URL, le retour du client) et https://your-site/wc-api/ipay88_p_backend/ (Backend URL, la notification serveur à serveur). La section affiche aussi l'adresse de votre site, qui doit être enregistrée auprès d'iPay88 comme Request URL.

Les deux réponses d'iPay88 sont contrôlées de la même façon : la signature calculée avec votre Merchant Key, la référence d'un paiement que cette boutique a lancé pour cette commande, le montant et la devise. Les requêtes sans signature valide sont rejetées et ne modifient jamais une commande. La notification backend reçoit RECEIVEOK seulement après son traitement ; sinon, iPay88 la renvoie. iPay88 signale les statuts de paiement suivants :

1 (succès) : le paiement a été effectué. La commande est marquée comme payée après contrôle du montant et de la devise.

6 (en attente) : le paiement est encore en attente, par exemple un virement par GAB ou sur compte virtuel. La commande est mise en attente jusqu'à ce qu'iPay88 confirme ou rejette le paiement.

Tout autre statut : le paiement a échoué ou a été annulé. La commande passe au statut Échec avec la raison donnée par iPay88.

Avancé

Debug log : Log payment requests and iPay88 responses dans WooCommerce > Status > Logs, source wcp_ipay88_payment, sans données personnelles ni signatures. Les erreurs sont toujours journalisées. Par défaut : désactivé.

Delete data on uninstall : Delete the settings, logs and iPay88 order data when the plugin is deleted. Les commandes elles-mêmes ne sont jamais supprimées. Par défaut : désactivé.

Paiement

Le client choisit le mode de paiement (par défaut iPay88) et passe la commande. La commande reste en Pending payment, et le client voit Redirecting to iPay88 payment gateway... pendant qu'un formulaire est envoyé à la page de paiement iPay88 de votre région. Sans JavaScript, le client clique sur Pay Now. Les articles de la commande, le nom, l'e-mail et le téléphone du client sont transmis à iPay88. Sur la page iPay88, le client paie par carte, par banque en ligne FPX, par portefeuille électronique ou par un autre mode proposé par votre compte.

Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. La commande n'est marquée comme payée qu'après confirmation d'iPay88 par une réponse signée, soit au retour du client, soit par la notification backend. Si la confirmation n'est pas encore arrivée, la page affiche We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. Pour un paiement en attente, elle affiche Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

Si le paiement a échoué ou a été annulé, le client arrive sur la page Pay for order avec The payment was not completed: et la raison donnée par iPay88, et peut payer à nouveau ou choisir un autre mode de paiement. Si la réponse ne peut pas être vérifiée, le client voit 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. avec un lien de retour vers la boutique.

Le stock est réduit lorsque le paiement est confirmé, et non lors de la redirection du client. Le mode de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

L'extension ne gère que les paiements uniques. Elle ne prend en charge ni les remboursements depuis WooCommerce, ni les cartes enregistrées, ni les abonnements, ni la pré-autorisation et la capture, ni les champs de carte sur votre site. Elle n'interroge pas de nouveau iPay88 sur le statut du paiement : les commandes ne sont mises à jour que par la réponse d'iPay88 et la notification backend. L'API 2.0 d'iPay88 Indonesia (JSON / lien de paiement) n'est pas utilisée.

Commandes

Order statuses

Pending payment : le client a été redirigé vers iPay88 et n'a pas encore payé, ou iPay88 n'a pas encore confirmé le paiement.

Processing or Completed : le paiement a été confirmé. WooCommerce applique le statut habituel d'une commande payée. La note de commande affiche le TransID, le PaymentID, le montant et la devise d'iPay88. L'identifiant de transaction est le TransID d'iPay88. En mode test, une seconde note indique que le montant de test a été débité à la place du total de la commande.

On hold, pending at iPay88 : iPay88 a signalé le paiement comme en attente. La commande sera mise à jour lorsqu'iPay88 confirmera ou rejettera le paiement.

On hold, for review : iPay88 a signalé un paiement réussi avec un montant ou une devise différent de ceux de la commande, ou le paiement est arrivé après l'annulation de la commande. La commande n'a pas été marquée comme payée. La note de commande l'explique. Vérifiez le paiement dans le portail iPay88, puis exécutez la commande ou remboursez le paiement.

Failed : le paiement a échoué ou a été annulé. La note affiche la raison donnée par iPay88. Le client peut payer à nouveau.

Si un autre paiement réussi arrive pour une commande déjà payée ou remboursée, la commande n'est pas modifiée. Une note vous demande de le vérifier dans le portail iPay88 et de le rembourser s'il s'agit d'un doublon. Une réponse d'échec ne modifie jamais une commande payée, remboursée ou annulée.

Remboursements

Les remboursements ne sont pas envoyés à iPay88 depuis WooCommerce. Remboursez le paiement dans le portail marchand iPay88, puis enregistrez le remboursement manuellement dans WooCommerce.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > iPay88. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est valide, ainsi que votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, iPay88 n'est pas proposé aux clients au paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Les gestionnaires connectés de la boutique voient toujours le mode de paiement, avec la mention (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

iPay88 n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le Merchant Code et la Merchant Key sont saisis, et que la devise de la boutique peut être débitée dans la iPay88 region choisie. La page des réglages affiche un avertissement lorsqu'un élément manque.

Le paiement a abouti, mais la commande reste en Pending payment : ni le retour du client ni la notification backend n'ont atteint votre boutique avec une signature valide. Activez le Debug log et consultez WooCommerce > Status > Logs, source wcp_ipay88_payment. Vérifiez que la Merchant Key est exactement celle que vous a donnée iPay88 et que votre site peut recevoir les requêtes d'iPay88 à la Backend URL affichée dans les réglages.

La page iPay88 affiche « Permission not allow » : l'adresse de votre site n'est pas enregistrée auprès d'iPay88 comme Request URL. Demandez à iPay88 d'enregistrer l'adresse indiquée dans la section Response and backend URLs.

La notification backend répond BAD SIGNATURE : la signature ne correspond pas à la Merchant Key. Vérifiez la Merchant Key.

La notification backend répond NOT CONFIGURED : le Merchant Code ou la Merchant Key n'est pas renseigné, la réponse ne peut donc pas être vérifiée. iPay88 renvoie la notification.

La notification backend répond UNKNOWN ORDER : aucun paiement iPay88 n'a été lancé pour cette référence sur cette boutique, par exemple parce qu'une autre boutique utilisant le même compte n'a pas de Reference prefix ou utilise le même préfixe.

La commande est On hold avec une note sur le montant ou la devise : iPay88 a signalé un paiement ne correspondant pas à la commande, ou la commande avait été annulée. La commande n'a pas été marquée comme payée. Vérifiez le paiement dans le portail iPay88, puis finalisez-le ou remboursez-le.

Le client voit « iPay88 cannot accept payments in » suivi d'une devise : la devise de la commande ne peut pas être débitée dans la région choisie. Sur iPay88 Malaysia, les devises autres que MYR nécessitent aussi l'option multidevise sur votre compte iPay88.

Les clients réels ne sont débités que de 1,00 : le Test mode est activé. Désactivez-le.

Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net, puis cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé sur le nouveau domaine. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Les développeurs peuvent modifier l'URL de la page de paiement, les devises, les décimales, le montant de test et l'icône avec les filtres ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount et ipay88_p_icon.

Désinstallation

Désactiver l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours supprimés. Les réglages de la passerelle, les journaux et les données iPay88 enregistrées sur les commandes ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les commandes elles-mêmes ne sont jamais supprimées et conservent leurs notes de paiement et leurs identifiants de transaction.

iPay88 est une marque déposée de son propriétaire respectif. Cette extension n'est ni affiliée à iPay88 ni approuvée par iPay88.