VibeFox GMO for WooCommerce — Aide

Prérequis

WordPress: 6.0 ou ultérieur.

WooCommerce: 8.0 ou ultérieur, installé et actif. Sans lui, l’extension refuse de s’activer.

PHP: 8.0 ou ultérieur.

Devise de la boutique : yen japonais (JPY). Avec une autre devise de boutique, le moyen de paiement est masqué sur la page de paiement. Sur la page Pay for order, c’est la devise de la commande qui compte.

Compte GMO Payment Gateway : un contrat marchand GMO-PG avec Link Type Plus. Il vous faut le Shop ID, le Shop password et le Config ID de Link Type Plus (設定ID) de l’environnement de test et/ou de production, ainsi que la notification de résultat (結果通知) activée dans la console de boutique 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 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 téléverser le dossier wcp_gmo_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage, ou cliquez sur Settings sous le nom de l’extension sur la page des extensions.

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

5. Saisissez le Shop ID, le Shop password et le Config ID de l’environnement de test et/ou de production et choisissez Environment.

6. Dans la console de boutique GMO-PG, activez 結果通知 (notification de résultat) et définissez l’URL de notification affichée dans les réglages (voir Configuration).

7. Activez Enable/Disable. Effectuez un paiement de test dans l’environnement de test, puis passez Environment en production.

Configuration

Tous les réglages se trouvent sur une page : WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Le titre affiche une pastille TEST ou PRODUCTION pour l’environnement actuel. Au-dessus des champs, la page vous avertit si la devise de la boutique n’est pas JPY ou si le Shop ID, le Shop password ou le Config ID de l’environnement actuel manque. Dans les deux cas, le moyen de paiement est masqué lors du paiement. Dans la liste des moyens de paiement, la passerelle est indiquée comme nécessitant une configuration tant que les identifiants de l’environnement actuel ne sont pas renseignés. Les espaces en début et en fin d’identifiants sont supprimés à l’enregistrement.

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é sur la page de paiement. Par défaut : Credit card.

Description: le texte affiché sous le moyen de paiement sur la page de 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 le Shop password se trouvent dans la console de boutique GMO-PG sous Shop management > Shop information, et 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 paiements.

Identifiants de production (p01.mul-pay.jp)

Production Shop ID: le Shop ID de l’environnement de production.

Production Shop password: le Shop password de l’environnement de production.

Production Config ID: l’identifiant de configuration Link Type Plus (設定ID) enregistré dans la console GMO-PG.

Identifiants de test (pt01.mul-pay.jp)

Test Shop ID: le Shop ID de l’environnement de test.

Test Shop password: le Shop password de l’environnement de test.

Test Config ID: l’identifiant de configuration Link Type Plus (設定ID) de l’environnement de test.

Paiement

Capture: le moment où la carte est débitée.

Order status after payment: l’état d’une commande payée. Il est défini immédiatement, avec un seul changement d’état et un seul e-mail au client.

Notifications de paiement (結果通知)

La notification de résultat indique à votre boutique qu’un paiement a été effectué. Elle est obligatoire. Dans la console de boutique GMO-PG, activez 結果通知 (notification de résultat) et définissez l’URL de notification affichée dans cette section des réglages. Elle ressemble à https://your-site/wc-api/gmo_pg_webhook/. Copiez l’URL exactement telle qu’elle apparaît dans les réglages.

Les notifications GMO-PG ne sont pas signées ; l’extension ne se fie donc jamais à leur contenu. La notification doit provenir de l’un de vos Shop ID configurés et concerner un paiement créé par cette boutique, dans l’environnement où la commande a été payée. L’extension demande alors la transaction à GMO-PG (SearchTrade) avec votre Shop password et ne modifie la commande qu’à partir de cette réponse. Une notification sans transaction réelle correspondante ne change rien. Les transactions non créées par la boutique, par exemple celles réalisées dans la console GMO-PG, sont acquittées et ignorées. Si l’extension ne peut pas vérifier une notification, elle répond de façon à ce que GMO-PG la renvoie (GMO-PG réessaie jusqu’à 5 fois).

Sans notification, une commande n’est confirmée que lorsque le client revient dans la boutique après avoir payé.

Avancé

Debug log: Log API requests and notifications les consigne dans WooCommerce > Status > Logs, source wcp_gmo_payment. Les erreurs sont toujours consignées. Les mots de passe et les données clients sont masqués. Par défaut : désactivé.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. La désactivation ne supprime jamais rien. Les données de commande (identifiants de transaction) sont toujours conservées. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut Credit card) et passe commande. L’extension crée un paiement GMO-PG Link Type Plus pour le total de la commande, arrondi en yens entiers, et redirige le client vers la page de paiement GMO-PG. Il y paie par carte de crédit. GMO-PG gère 3-D Secure 2.0 et reçoit l’adresse e-mail de facturation du client pour 3-D Secure. La page de paiement s’ouvre en japonais, chinois ou anglais selon la langue de votre site. Le paiement apparaît chez GMO-PG avec WC- et le numéro de commande. Aucune autre donnée client n’est transmise.

Après le paiement, le client revient dans votre boutique. Le résultat signé est vérifié avec votre Shop password et la commande n’est marquée payée qu’après confirmation de GMO-PG : par une requête SearchTrade côté serveur au retour du client ou par la notification de résultat. Les deux utilisent la même logique, afin que la commande ne soit jamais traitée deux fois. Si le paiement n’est pas encore confirmé, la page de commande reçue affiche Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.

Si la carte est refusée ou si le paiement échoue sur la page GMO-PG, la commande passe à Échouée et le client est redirigé vers la page Pay for order 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 GMO-PG sans payer, la même page affiche The payment was not completed. You can try again or choose another payment method. Chaque nouvelle tentative annule le lien de paiement précédent non payé. Si ce lien a déjà été payé entre-temps, ce paiement est appliqué et aucun nouveau lien n’est créé.

Les commandes d’un total de 1 à 9 999 999 JPY peuvent être payées. Au-delà, le moyen de paiement est masqué. Si le paiement ne peut pas démarrer, le client voit un court message, par exemple Card payment could not be started. Please try again or choose another payment method., et le motif est ajouté aux notes de commande.

Le moyen de paiement fonctionne sur le paiement classique, les blocs Panier et Paiement et la page Pay for order. Dans le bloc Paiement, il affiche l’icône de carte et la description. Dans l’environnement de test, le paiement classique et le bloc Paiement affichent tous deux la pastille Test mode — no real charge. Il est compatible avec le stockage haute performance des commandes WooCommerce (HPOS).

L’extension accepte uniquement les paiements par carte de crédit en JPY, toujours sur la page GMO-PG. Elle ne propose ni autres moyens de paiement GMO-PG, ni multidevise, ni cartes enregistrées ou inscription de membres GMO-PG, ni abonnements ou facturation récurrente, ni formulaire de carte sur votre site.

Commandes et remboursements

États des commandes

Pending payment: le client a été redirigé vers GMO-PG et n’a pas encore payé, ou GMO-PG n’a pas encore confirmé le paiement.

Processing or Completed: le paiement a été confirmé. L’état suit le réglage Order status after payment. La note de commande indique le montant, l’état GMO-PG, la transaction et la façon dont elle a été confirmée (notification ou retour). L’identifiant de transaction est le TranID GMO-PG.

On hold (authorized): avec Authorize only (仮売上), le montant a été autorisé. Capturez-le avec l’action de commande Capture payment (GMO-PG) ou dans la console GMO-PG avant l’expiration de l’autorisation. Après capture, la commande passe à En cours ou Terminée. Si l’autorisation est annulée chez GMO-PG, la commande est annulée.

On hold after payment: GMO-PG a signalé un montant différent du total de la commande, ou le paiement est arrivé après l’annulation de la commande. La note de commande l’explique. Vérifiez la commande et honorez-la ou remboursez le paiement.

Failed: la carte a été refusée ou le paiement n’a pas été terminé sur la page GMO-PG.

Si un second paiement arrive pour une commande 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.

Capture

L’action de commande Capture payment (GMO-PG) apparaît sur les commandes En attente qui ont seulement été autorisées. Elle 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, l’action ajoute une note avec l’état actuel et s’y conforme.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Credit card (le bouton affiche votre Title). Les remboursements totaux et partiels sont pris en charge, en yens entiers. Rembourser tout le montant restant annule la transaction GMO-PG, et GMO-PG décide s’il s’agit d’une annulation ou d’un remboursement. Un remboursement partiel réduit le montant de la transaction et l’émetteur de la carte autorise le nouveau montant. Le remboursement est envoyé à l’environnement où la commande a été payée ; son Shop ID et son Shop password doivent donc être renseignés. Si GMO-PG refuse le remboursement, WooCommerce affiche l’erreur et aucun remboursement n’est enregistré. Un remboursement réussi est ajouté aux notes de commande.

Les remboursements et annulations effectués dans la console GMO-PG arrivent par la notification de résultat et sont ajoutés aux notes de commande. Ils ne sont pas automatiquement enregistrés comme remboursements WooCommerce. Si nécessaire, créez un remboursement manuel dans WooCommerce sans le bouton GMO-PG.

Clé de licence

L’extension fonctionne avec une clé de licence VibeFox de vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche l’état, par exemple la date de validité de la licence et votre domaine. Utilisez Check now pour revérifier l’état, 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 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, le moyen de paiement n’est pas présenté aux clients sur la page de paiement. Si un paiement est malgré tout lancé, le client voit This payment method is not available. Please choose another one. Les gestionnaires de boutique connectés voient toujours le moyen de paiement, marqué (unlicensed — visible to admins only), pour vous permettre de configurer et tester l’extension avant d’acheter une clé. Un rappel apparaît sur la page des extensions et les pages WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés, et les remboursements et captures fonctionnent.

À l’expiration d’une licence, l’extension continue à fonctionner, mais les mises à jour et l’assistance nécessitent un renouvellement. L’état est revérifié automatiquement en arrière-plan.

Dépannage

La carte de crédit n’apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que la devise est JPY et que le Shop ID, le Shop password et le Config ID de l’environnement actuel sont renseignés. Les commandes de plus de 9 999 999 JPY ne peuvent pas être payées par carte. La page des réglages affiche un avertissement si la devise ou les identifiants sont incorrects.

Le paiement a abouti, mais la commande reste Pending payment : la notification de résultat ne fonctionne pas. Dans la console de boutique GMO-PG de l’environnement utilisé, vérifiez que 結果通知 est activé et que l’URL correspond exactement à celle des réglages. Vérifiez que le Shop ID et le Shop password de cet environnement sont renseignés, car l’extension les utilise pour vérifier chaque notification. Activez Debug log et consultez WooCommerce > Status > Logs, source wcp_gmo_payment. La commande est aussi confirmée lorsque le client revient dans la boutique après paiement.

Le journal affiche 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 affiche Notification ignored ... is not a payment of this store : la transaction n’a pas été créée par cette boutique ; elle a par exemple été réalisée dans la console GMO-PG. Aucune action n’est nécessaire.

Le journal indique que la commande a été payée dans un autre environnement : les paiements de test et de production restent séparés. Une notification de test ne confirme jamais une commande de production, et inversement.

Le client voit une erreur en passant commande : ouvrez les notes de commande ou activez Debug log. La note affiche le code d’erreur GMO-PG (ErrCode, ErrInfo). Un Shop ID, un Shop password ou un Config ID incorrect est la cause habituelle. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. signifie que la commande n’est pas en JPY.

La commande est On hold après paiement : lisez la note de commande. La commande a seulement été autorisée et attend la capture, le montant payé différait du total ou le paiement est arrivé après l’annulation.

Le remboursement échoue : lisez le message. 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 est peut-être déjà annulée chez GMO-PG, ou le montant dépasse le solde de la transaction.

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

Désinstallation

La désactivation de l’extension conserve toutes les données. Pour la retirer, désactivez-la et supprimez-la sur la page Plugins. La clé et l’état de licence de cette extension sont toujours supprimés. Les réglages de la passerelle et les journaux ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils restent disponibles pour une réinstallation ultérieure. Les données GMO-PG stockées dans les commandes font partie de l’historique des paiements et sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

GMO Payment Gateway est une marque commerciale de son propriétaire respectif. Cette extension n’est ni affiliée à GMO Payment Gateway ni approuvée par GMO Payment Gateway.