VibeFox GMO for PrestaShop — Aide
Prérequis
PrestaShop : 8.0 à 9.x.
PHP : 8.0 ou ultérieur. Le module refuse de s’installer sur les anciennes versions de PHP.
Devise : yen japonais (JPY). GMO-PG n’encaisse que des yens, donc le moyen de paiement n’est affiché que lorsque la devise du panier est le JPY. Ajoutez le JPY dans International > Localization > Currencies si votre boutique ne l’a pas encore.
Compte GMO Payment Gateway : un contrat marchand GMO-PG avec Link Type Plus. Vous avez besoin du Shop ID, de la Shop password et du Config ID Link Type Plus (設定ID) des environnements de test et/ou de production, ainsi que de la notification de résultat (結果通知) activée dans la console boutique de GMO-PG (voir Configuration). Le Site ID et le Site password ne sont pas utilisés.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.
Installation
1. Dans le back office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.
2. Une fois le téléversement terminé, cliquez sur Configure, ou retrouvez plus tard VibeFox GMO Payment Gateway dans la liste des modules et cliquez sur Configure.
3. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).
4. Saisissez le Shop ID, la Shop password et le Config ID des environnements de test et/ou de production, puis choisissez l’Environment.
5. Dans la console boutique de GMO-PG, activez 結果通知 (notification de résultat) et indiquez l’URL de notification affichée dans les réglages (voir Configuration).
6. Activez Enable/Disable et cliquez sur Save. Effectuez un paiement test dans l’environnement de test, puis passez Environment en production.
À l’installation, le module crée le statut de commande GMO-PG payment on hold. PrestaShop propose un nouveau module de paiement pour toutes les devises, tous les pays et tous les groupes de clients. Vous pouvez les limiter dans Payment > Preferences ; le JPY doit rester autorisé.
Configuration
Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox GMO Payment Gateway > Configure. Chaque bouton Save enregistre la page entière. Au-dessus des champs, la page vous avertit si la devise par défaut de la boutique n’est pas le JPY et si le Shop ID, la Shop password ou le Config ID de l’environnement actif est manquant (le moyen de paiement est alors masqué au paiement). Elle indique aussi l’environnement actif : TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. ou PRODUCTION — payments go to p01.mul-pay.jp. Les espaces autour des identifiants sont supprimés à l’enregistrement.
GMO Payment Gateway — Credit Card
Enable/Disable : Enable GMO Payment Gateway — Credit Card active ou désactive le moyen de paiement. Par défaut : désactivé.
Title : le nom du moyen de paiement affiché au paiement. C’est aussi le nom enregistré dans la commande. Par défaut : Credit card. Obligatoire.
Description : le texte affiché sous le moyen de paiement au moment du paiement. Par défaut : You will be redirected to the secure GMO Payment Gateway page to pay by credit card.
Compte GMO-PG
Le Shop ID et la Shop password se trouvent dans la console GMO-PG, sous Shop management > Shop information, le Config ID sous Link Type Plus > Settings (設定ID). Les environnements de test et de production ont des identifiants différents.
Environment : l’environnement GMO-PG qui reçoit les nouveaux paiements.
Production Shop ID : le Shop ID de l’environnement de production.
Production Shop password : la Shop password de l’environnement de production.
Production Config ID : le config ID Link Type Plus (設定ID) enregistré dans la console GMO-PG.
Test Shop ID : le Shop ID de l’environnement de test.
Test Shop password : la Shop password de l’environnement de test.
Test Config ID : le config ID Link Type Plus (設定ID) de l’environnement de test.
Les mots de passe enregistrés ne sont jamais réaffichés. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que pour la modifier.
Clear saved passwords : cochez un mot de passe et cliquez sur Save pour le supprimer. Un champ vide conserve la valeur enregistrée.
Payment
Capture : moment où la carte est débitée.
Order status after payment : le statut d’une commande payée.
Notifications de paiement (結果通知)
La notification de résultat indique à votre boutique qu’un paiement a été effectué. Elle est obligatoire. Dans la console GMO-PG, activez 結果通知 (notification de résultat) et indiquez l’URL affichée sous Notification URL dans cette section. Avec des URL conviviales, elle ressemble à https://your-shop/module/wcp_gmo_payment/notify, éventuellement avec un code de langue comme /ja/. Copiez l’URL exactement telle qu’elle apparaît dans les réglages. Elle doit être accessible depuis Internet ; le mode maintenance ne la bloque pas.
Les notifications de GMO-PG ne sont pas signées : le module ne fait donc jamais confiance à leur contenu. La notification doit provenir de l’un de vos Shop ID configurés et renvoyer à un paiement créé par cette boutique, dans l’environnement où le paiement a été effectué. Le module demande alors la transaction à GMO-PG (SearchTrade) avec votre Shop password, et ne modifie le panier ou la commande qu’en fonction de cette réponse. Une notification qui ne correspond à aucune transaction réelle ne change rien. Les transactions non créées par la boutique, par exemple celles faites dans la console GMO-PG, sont acquittées et ignorées. Lorsque le module ne peut pas vérifier une notification, il répond de manière à ce que GMO-PG la renvoie (GMO-PG réessaie jusqu’à 5 fois).
Sans la notification, une commande n’est créée que lorsque le client revient dans la boutique après avoir payé.
Advanced
Debug log : écrit les requêtes API et les notifications dans logs/gmo_pg_debug.log.php, dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les erreurs sont toujours journalisées, même lorsque l’interrupteur est désactivé. Les mots de passe et les données clients sont masqués. Par défaut : désactivé.
Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.
Delete data on uninstall : lorsqu’elle est activée, la désinstallation du module supprime les réglages de la passerelle et le journal. Les données de commande (GMO OrderID, identifiants de transaction) sont toujours conservées. Par défaut : désactivé.
Paiement
À l’étape de paiement, le client choisit le moyen de paiement (par défaut Credit card) et voit sa description. Dans l’environnement de test, le badge TEST — GMO-PG test environment, no real charges. s’affiche au-dessus. Après confirmation, le module crée un paiement GMO-PG Link Type Plus pour le total du panier, arrondi au yen entier, et envoie le client sur la page de paiement de GMO-PG. Là, le client paie par carte de crédit. Le 3-D Secure 2.0 est géré par GMO-PG, et l’adresse e-mail du client est transmise à GMO-PG pour le 3-D Secure. La page de paiement s’ouvre en japonais, en chinois ou en anglais, selon la langue du client. Le paiement apparaît chez GMO-PG avec PS- et le numéro du panier. Aucune autre donnée client n’est transmise. À ce stade, aucune commande n’existe encore.
Après le paiement, le client revient dans votre boutique. Le résultat signé est vérifié avec la Shop password de l’environnement du paiement, et la commande n’est marquée payée qu’après la confirmation de GMO-PG : soit par une requête SearchTrade côté serveur lors du retour du client, soit par la notification de résultat. Les deux utilisent la même logique, de sorte que la commande n’est jamais créée deux fois. Le client voit ensuite la page standard de confirmation de commande. Si GMO-PG n’a pas encore confirmé le paiement, une page Payment confirmation affiche Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. avec un bouton Check again ; la notification crée la commande dès qu’elle arrive.
Si la carte est refusée ou si le paiement échoue sur la page de GMO-PG, le client revient au paiement avec le message The card payment was declined or could not be completed. Please try again or use another card.. Si le client quitte la page de GMO-PG sans payer, le message est The payment was not completed. You can try again or choose another payment method.. Le panier est conservé. Chaque nouvelle tentative annule le lien de paiement précédent non payé. Si ce lien a entre-temps été payé, la commande est créée à partir de ce paiement et aucun nouveau lien n’est généré.
Les paniers d’un montant de 1 à 9 999 999 JPY peuvent être payés. Au-delà, le moyen de paiement est masqué. Si le paiement ne peut pas être lancé, le client reste au paiement avec un bref message, par exemple Card payment could not be started. Please try again or choose another payment method., et la raison est inscrite dans le journal.
La notification et le retour fonctionnent même lorsque la boutique est en mode maintenance, et ne sont pas bloqués par la restriction par pays de votre boutique.
Le module n’accepte les paiements par carte de crédit qu’en JPY, toujours sur la page de GMO-PG. Il ne propose ni autres moyens de paiement GMO-PG, ni multidevise, ni cartes enregistrées ou inscription de membre GMO-PG, ni abonnements ou prélèvements récurrents, ni formulaire de carte sur votre site.
Commandes et remboursements
Statuts de commande
Pas encore de commande : le client a été envoyé vers GMO-PG et n’a pas encore payé, ou GMO-PG n’a pas encore confirmé le paiement. Seul le panier existe.
Payment accepted ou Delivered : le paiement a été confirmé. Le statut suit Order status after payment. Le paiement est enregistré avec le TranID GMO-PG comme identifiant de transaction, et une note indique le montant, le statut GMO-PG, la transaction et le mode de confirmation (notification ou retour).
GMO-PG payment on hold (autorisé) : avec Authorize only (仮売上), le montant a été autorisé. Capturez-le avec Capture payment (GMO-PG) ou dans la console GMO-PG avant l’expiration de l’autorisation. Après la capture, la commande passe à Payment accepted ou Delivered. Si l’autorisation est annulée chez GMO-PG, la commande passe à Canceled.
GMO-PG payment on hold après paiement : GMO-PG a signalé un montant différent du total du panier, ou le panier n’était pas en JPY. La note l’explique, et le paiement est enregistré pour le montant réellement prélevé par GMO-PG. Vérifiez la commande, puis exécutez-la ou remboursez le paiement.
Refunded : le paiement a été entièrement remboursé via le module. Le remboursement total d’une autorisation jamais capturée passe la commande à Canceled.
Si un second paiement arrive pour un panier dont la commande est déjà payée ou clôturée, la commande n’est pas modifiée. Une note vous demande de rembourser le doublon dans la console GMO-PG.
Bloc GMO Payment Gateway
La page de commande affiche un bloc GMO Payment Gateway avec le GMO OrderID, le Transaction ID, le statut (avec le statut GMO-PG), Paid / refunded, un badge TEST pour les paiements de test, l’historique des remboursements et les GMO-PG notes de la commande. La capture et les remboursements nécessitent le droit de modifier les commandes ; l’accès aux pages Modules n’est pas nécessaire.
Capture
Capture payment (GMO-PG) apparaît dans le bloc d’une commande en attente qui n’a été qu’autorisée. Confirmez Capture the authorized GMO-PG payment?. Le module vérifie la transaction chez GMO-PG et débite le montant autorisé. Si la transaction n’est plus autorisée, par exemple parce qu’elle a déjà été capturée dans la console GMO-PG, une note affiche le statut actuel et la commande le suit.
Remboursements
Dans le bloc, saisissez le montant (le montant non encore remboursé est prérempli), éventuellement un motif, puis cliquez sur Refund via GMO-PG. Confirmez Refund this amount through GMO-PG?. Les remboursements totaux et partiels sont pris en charge, en yens entiers. La limite est le montant réellement prélevé par GMO-PG et encore retenu, et non le total de la commande. Rembourser la totalité du montant restant annule la transaction GMO-PG, et c’est GMO-PG qui décide s’il s’agit d’une annulation ou d’un retour. Un remboursement partiel réduit le montant de la transaction. Le remboursement est envoyé à l’environnement où le paiement a été effectué ; le Shop ID et la Shop password de cet environnement doivent donc être renseignés. Si GMO-PG n’accepte pas le remboursement, le bloc affiche l’erreur et aucun remboursement n’est enregistré. Un remboursement réussi est ajouté à l’historique des remboursements et aux notes. Un remboursement total passe la commande en Refunded ; un remboursement partiel ne modifie pas le statut.
Le module ne crée pas d’avoirs. Les boutons de remboursement standard de PrestaShop sur la page de commande ne renvoient pas d’argent via GMO-PG.
Les remboursements et annulations effectués dans la console GMO-PG arrivent par la notification de résultat et sont ajoutés aux notes. Le statut de la commande et les avoirs ne sont pas modifiés automatiquement, sauf pour une autorisation annulée chez GMO-PG. Mettez-les à jour manuellement si nécessaire.
Clé de licence
Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox GMO Payment Gateway est le premier bloc de Modules > Module Manager > VibeFox GMO Payment Gateway > Configure, au-dessus des réglages. Saisissez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu’à laquelle la licence est active et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: presta-payment-gmo et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l’autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back office (l’anglais et le russe sont inclus).
Si la clé n’est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d’une date. Après un changement d’adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, le module continue de fonctionner avec le dernier statut connu.
Une clé fonctionne sur un seul domaine : le domaine de la boutique principale, y compris dans une configuration multiboutique. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l’emplacement dans votre compte vibefox.net.
Sans clé active, le paiement par carte GMO-PG n’est pas proposé aux clients au moment du paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. La boutique PrestaShop ne sait pas que vous êtes connecté au back office, donc le moyen de paiement vous est aussi masqué : vous pouvez configurer le module avant d’acheter une clé, mais ne pas le tester au paiement. Un rappel apparaît dans Modules > Module Manager, sous l’onglet Alerts. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés, et les captures et remboursements fonctionnent.
Lorsqu’une licence expire, le module continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement pendant que vous travaillez dans le back office : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n’est nécessaire. La désinstallation ou la réinitialisation du module supprime toujours la clé de licence et le statut de la licence.
Dépannage
La carte de crédit n’apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que la devise du panier est le JPY et que l’environnement actif dispose de son Shop ID, de sa Shop password et de son Config ID. Les paniers supérieurs à 9 999 999 JPY ne peuvent pas être payés par carte. La page des réglages affiche un avertissement si la devise ou les identifiants sont incorrects. Dans Payment > Preferences, vérifiez que le module est autorisé pour le JPY, le pays du client et le groupe du client.
Le paiement a abouti, mais aucune commande n’a été créée : la notification de résultat ne fonctionne pas. Dans la console boutique GMO-PG de l’environnement utilisé, vérifiez que 結果通知 est activée et que l’URL est exactement celle affichée sous Notification URL. Vérifiez que le Shop ID et la Shop password de cet environnement sont renseignés, car le module vérifie chaque notification avec eux. Activez Debug log et consultez le champ Log de la page du module. La commande est aussi créée lorsque le client revient dans la boutique après avoir payé.
Le journal indique Notification rejected: unknown ShopID : la notification provient d’une boutique dont le Shop ID ne figure pas dans les réglages. Saisissez le Shop ID de cet environnement.
Le journal indique Notification ignored: OrderID is not a payment of this store : la transaction n’a pas été créée par cette boutique, par exemple parce qu’elle a été faite dans la console GMO-PG. Aucune action n’est nécessaire.
Le journal indique que le panier a été payé dans un autre environnement : les paiements de test et de production sont séparés. Une notification de test ne confirme jamais un paiement de production, et inversement.
Le journal indique Cannot create the order: the module is disabled : le module a été désactivé pendant la confirmation d’un paiement. Activez-le ; GMO-PG renverra la notification.
Le client voit une erreur en choisissant le paiement par carte : activez Debug log et consultez le champ Log. Le journal indique le code d’erreur GMO-PG (ErrCode, ErrInfo). Un Shop ID, une Shop password ou un Config ID incorrect en est la cause habituelle. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. signifie que le panier n’est pas en JPY.
La commande est en GMO-PG payment on hold : lisez les notes du bloc GMO Payment Gateway. La commande n’a été qu’autorisée et attend sa capture, ou le montant payé différait du panier.
Le remboursement ou la capture échoue : lisez le message dans le bloc. La commande a peut-être été payée dans l’autre environnement, dont le Shop ID et le mot de passe ne sont pas renseignés ; la transaction peut déjà être annulée chez GMO-PG ; ou le montant peut dépasser ce qui reste sur la transaction. The order is being updated by GMO-PG right now. Try again in a moment. signifie qu’une notification était traitée en même temps.
Le bloc affiche You do not have permission to refund orders. : votre profil employé n’a pas le droit de modifier les commandes. Demandez à un administrateur de vous l’accorder.
Désinstallation
Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox GMO Payment Gateway et choisissez Uninstall. La clé de licence et le statut de la licence de ce module sont toujours supprimés. Si Delete data on uninstall est activée, les réglages de la passerelle et le journal sont supprimés. Si elle est désactivée, tous les réglages sont conservés pour une réinstallation ultérieure. Les transactions et remboursements GMO-PG ainsi que le statut de commande GMO-PG payment on hold sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être capturées et remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
GMO Payment Gateway est une marque déposée de son titulaire. Ce module n’est ni affilié à GMO Payment Gateway ni approuvé par GMO Payment Gateway.