VibeFox KOMOJU for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec la version 3.0.5.0) ou 4.0.2 et ultérieur (testé avec la version 4.1.0.3).

PHP : 8.0 ou ultérieure.

Compte KOMOJU : vous avez besoin de la clé secrète (sk_live_... et, pour le mode test, sk_test_...) et du jeton secret d'un webhook créé dans le tableau de bord KOMOJU (voir Configuration). La clé publique n'est pas nécessaire. KOMOJU doit pouvoir atteindre l'URL du webhook de votre boutique.

Devise de la commande : JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD ou VND. Pour les commandes dans d'autres devises, le mode de paiement est masqué.

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

Installation

Le téléchargement est un fichier zip unique contenant les paquets des deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_komoju_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_komoju_payment.ocmod.zip. N'installez que le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_komoju_payment-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD, il n'est donc pas nécessaire d'actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions, choisissez le type Payments, repérez VibeFox KOMOJU Payment et cliquez sur Install (le bouton vert +). Votre utilisateur administrateur doit avoir le droit de modifier la liste des extensions de paiement.

3. Cliquez sur Edit (le bouton crayon) pour ouvrir la page des réglages. Collez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Dans le tableau de bord KOMOJU, ajoutez un webhook avec l'URL et les événements indiqués dans la section Webhook URL, et copiez son jeton secret (voir Configuration).

5. Saisissez la clé secrète et le jeton secret du webhook en mode réel, ainsi que les clés de test pour le mode sandbox. Activez Enable/Disable et cliquez sur Save.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_komoju_payment.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension dans le nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox KOMOJU Payment, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence, le webhook et les clés comme aux étapes 3 à 5 pour OpenCart 3. La page de configuration et ses champs sont identiques dans les deux versions. Seule l'URL du webhook est différente (voir URL du webhook).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode sandbox désactivé.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre toute la page. Au-dessus des réglages, la page affiche KOMOJU Sandbox Mode is enabled. tant que le mode test est activé. Elle vous avertit si le mode actuel n'a pas de clé secrète (le mode de paiement est alors masqué à la commande) ou de jeton secret de webhook (les notifications KOMOJU sont alors rejetées, de sorte que les paiements en konbini et par virement ne sont jamais confirmés), et lorsque KOMOJU ne prend pas en charge la devise par défaut de la boutique (le mode de paiement est alors masqué pour les commandes dans cette devise). Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

À l'enregistrement, Title doit comporter 128 caractères au maximum, Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre supérieur ou égal à 0, et la zone géographique et les statuts de commande doivent exister. Sinon, rien n'est enregistré et la page indique le champ concerné. Des clés manquantes n'empêchent pas l'enregistrement.

Mode de paiement KOMOJU

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

Title : le nom du mode de paiement que voit le client à la commande. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : KOMOJU Payment. Si vous le laissez vide, le nom par défaut est utilisé. 128 caractères au maximum.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

Sort Order : la position de KOMOJU parmi les modes de paiement à la commande. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : ne proposer KOMOJU que pour les adresses de paiement situées dans la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

Total : le montant total du panier, dans la devise par défaut de la boutique, que la commande doit atteindre avant que KOMOJU soit proposé. Laissez le champ vide pour proposer KOMOJU quel que soit le montant.

Clés API en mode réel

Retrouvez les clés dans le tableau de bord KOMOJU (les liens vers les sections s'y trouvent) : la clé secrète sous Settings > API keys, le jeton secret du webhook sous Settings > Webhooks (ajoutez d'abord l'URL du webhook indiquée dans la section Webhook URL).

Live Secret Key : votre clé secrète KOMOJU en mode réel. Elle commence par sk_live_.

Live Webhook Secret Token : le jeton secret du webhook en mode réel. Il sert à vérifier la signature de chaque notification.

Mode test

KOMOJU utilise la même adresse d'API pour les paiements de test et les paiements réels : c'est la clé qui détermine le mode. Les paiements conservent le mode dans lequel ils ont été effectués, de sorte que les remboursements et les vérifications de statut d'une commande utilisent toujours la clé de ce mode.

Sandbox Mode : Enable test mode (use the test keys below, no real payments). Par défaut : désactivé. Lorsqu'il est activé, l'étape Confirm Order affiche Test mode au-dessus de la description.

Sandbox Secret Key : votre clé secrète KOMOJU de test. Elle commence par sk_test_.

Sandbox Webhook Secret Token : le jeton secret du webhook en mode test.

Les clés et jetons enregistrés ne sont plus jamais affichés. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que pour la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ et cliquez sur Save.

URL du webhook

Le webhook informe votre boutique des paiements, y compris les paiements différés en konbini et par virement bancaire. Dans le tableau de bord KOMOJU, sous Settings > Webhooks, ajoutez l'URL indiquée dans cette section, pour le mode réel et pour le mode test. Sous OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook, et sous OpenCart 4 à https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle qu'elle apparaît dans les réglages. Copiez ensuite le jeton secret de chaque webhook dans Live Webhook Secret Token ou Sandbox Webhook Secret Token.

Sélectionnez ces événements (ils figurent également dans cette section) :

Les événements d'expiration, d'annulation et d'échec ne modifient la commande que pour son paiement en cours : un paiement d'une tentative antérieure ne peut donc pas annuler une commande en cours de paiement par un autre moyen. Les webhooks sans signature valide sont rejetés. Les webhooks signés avec l'un ou l'autre jeton secret sont acceptés, mais uniquement pour les paiements du même mode. Sans le webhook, les paiements par carte sont toujours confirmés lorsque le client revient dans la boutique, mais les paiements en konbini et par virement bancaire ne sont jamais confirmés.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (commande manquante). Elle ne reçoit un statut qu'après la confirmation du paiement par KOMOJU. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Order Status After Payment : le paiement a été capturé, et le montant et la devise ont été vérifiés. Par défaut : En cours.

Awaiting KOMOJU Payment Status : le paiement est autorisé : un justificatif konbini ou un virement a été émis, ou le paiement attend la capture dans le tableau de bord KOMOJU. Par défaut : En attente de paiement.

KOMOJU Payment On Hold Status : le montant ou la devise payés diffèrent de la commande, ou le paiement est arrivé après l'annulation de la commande. Une note explique pourquoi. Par défaut : En attente de paiement, car OpenCart n'a pas de statut En attente.

Cancelled Payment Status : le paiement d'une commande en attente a expiré ou a été annulé, par exemple parce que le justificatif konbini n'a pas été payé à temps. Par défaut : Annulée.

Failed Payment Status : le paiement d'une commande en attente a échoué. Par défaut : Échec.

Refunded Status : défini lorsque le paiement est entièrement remboursé, depuis la page de la commande ou dans le tableau de bord KOMOJU. Par défaut : Remboursée.

Vous pouvez créer vos propres statuts, par exemple Paiement KOMOJU en attente ou En attente, dans System > Localisation > Order Statuses, puis les sélectionner ici.

Avancé

Invoice Prefix : le préfixe des numéros de commande envoyés à KOMOJU. Le numéro chez KOMOJU est composé du préfixe, du numéro de commande OpenCart et d'un court suffixe aléatoire, par exemple OC-123-A1B2C3. Si vous utilisez plusieurs boutiques avec le même compte KOMOJU, rendez le préfixe unique pour chaque boutique. Par défaut : OC-.

Enable Logging : écrit les événements et les appels API de KOMOJU dans komoju_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Les clés et les données clients ne sont pas journalisées. Les erreurs et les avertissements sont toujours enregistré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 : si activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les commandes ainsi que les transactions et remboursements KOMOJU sont toujours conservés, de sorte que les anciennes commandes peuvent encore être confirmées et remboursées après une réinstallation. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les clés secrètes et les jetons de webhook ne sont pas exportés.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les clés secrètes enregistrées sont conservées.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut KOMOJU Payment). À l'étape Confirm Order, le client voit votre description et la mention You will be redirected to the KOMOJU payment page to complete the payment. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée une session de paiement KOMOJU pour le montant total dans la devise de la commande, et envoie le client sur la page de paiement KOMOJU. L'adresse e-mail, le nom, les adresses de facturation et de livraison ainsi que les articles commandés sont transmis à KOMOJU. La page s'affiche en japonais, en anglais ou en coréen, selon la langue du client (en anglais pour les autres langues). Le client y choisit un mode de paiement. Les modes proposés dépendent de votre compte KOMOJU et de la devise de la commande.

Sous OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc du mode de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement. Par défaut, OpenCart 4 ne demande pas d'adresse de facturation ; l'extension utilise alors l'adresse de livraison comme adresse de paiement.

Après le paiement, le client revient dans votre boutique. L'extension lit la session de paiement via l'API KOMOJU avec la clé du mode du paiement. La commande n'est marquée comme payée qu'une fois KOMOJU l'a confirmé : par le webhook signé ou par la lecture de la session lorsque le client revient. La commande reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour du stock, et le client voit la page de confirmation de commande d'OpenCart avec Your payment with KOMOJU has been received. Si KOMOJU ne peut pas être joint à ce moment-là, ou si le paiement est confirmé mais pas encore appliqué, une page Payment confirmation affiche We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. et un bouton Check again.

Pour les paiements en konbini et par virement bancaire, le client reçoit un justificatif de paiement. La commande reçoit Awaiting KOMOJU Payment Status, et la page de confirmation indique au client que le paiement est autorisé et doit être effectué selon les instructions de KOMOJU (par exemple dans un magasin de proximité ou par virement bancaire). La commande passe à Order Status After Payment lorsque le client paie et que KOMOJU envoie le webhook. Si le justificatif expire, la commande passe à Cancelled Payment Status.

Si le paiement n'a pas été effectué, le client revient à la commande avec le message The payment was not completed. You can try again or choose another payment method. Si la commande avait déjà été annulée, le message est The KOMOJU payment was not completed and the order has been cancelled. Le panier est conservé. Sous OpenCart 4, ces messages s'affichent au-dessus de la page de paiement. Chaque nouvelle tentative (OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order ; OpenCart 4 met à jour la commande du paiement et règle la même commande) vérifie les sessions KOMOJU ouvertes de cette commande et d'autres commandes du même panier : la session ouverte de cette commande, avec un total inchangé, est réutilisée ; les autres sessions ouvertes sont annulées chez KOMOJU ; et une session payée entre-temps confirme sa commande au lieu de lancer un nouveau paiement. Une modification du panier, y compris une nouvelle quantité, compte comme un nouveau panier qui nécessite son propre paiement.

OpenCart 4 conserve la commande dans le paiement jusqu'à l'affichage de la page de succès. Si cette commande a été fermée entre-temps (par exemple son bon konbini a expiré, le paiement a échoué ou vous l'avez annulée), le client est renvoyé au paiement avec Your previous order was cancelled or its payment failed. Please confirm the order again. Si la commande est déjà enregistrée et que le panier contient désormais d'autres produits, le message est Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. Dans les deux cas, le prochain Confirm Order règle une nouvelle commande du panier.

Si KOMOJU ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, par exemple KOMOJU could not accept this payment: suivi de la raison, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. ou Payment error: Could not connect to KOMOJU. Please try again in a moment. La raison technique est écrite dans le journal.

Le webhook fonctionne également pendant que la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sous OpenCart 4 l'extension ajoute une action de démarrage qui laisse passer le webhook et le retour du client.

L'extension ne comporte aucun formulaire de carte sur votre site, aucune carte enregistrée ni aucun abonnement. Elle ne restreint pas les modes de paiement : ceux-ci sont choisis sur la page KOMOJU. Elle ne propose pas d'action de capture manuelle : les paiements autorisés pour une capture manuelle doivent être capturés dans le tableau de bord KOMOJU, et la commande reste en Awaiting KOMOJU Payment Status jusque-là.

Commandes et remboursements

Statuts de commande

No status (missing order) : le client a été envoyé vers KOMOJU et n'a pas encore payé, ou KOMOJU n'a pas encore confirmé le paiement. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Order Status After Payment (default Processing) : KOMOJU a confirmé le paiement. Une note indique l'identifiant du paiement KOMOJU, le mode de paiement et la manière dont il a été confirmé (webhook ou retour).

Awaiting KOMOJU Payment Status (default Pending) : un justificatif konbini ou un virement a été émis et attend le paiement, ou un paiement attend la capture dans le tableau de bord KOMOJU.

KOMOJU Payment On Hold Status (default Pending) : KOMOJU a signalé un montant ou une devise différents de ceux de la commande, ou le paiement a été capturé après l'annulation de la commande. La note l'explique. Vérifiez la commande, puis exécutez-la ou remboursez le paiement.

Cancelled Payment Status (default Canceled) : le justificatif de paiement a expiré ou le paiement a été annulé.

Failed Payment Status (default Failed) : le paiement d'une commande en attente a échoué.

Refunded Status (default Refunded) : le paiement a été entièrement remboursé, depuis la page de la commande ou dans le tableau de bord KOMOJU.

Si un second paiement est capturé pour une commande déjà payée, ou pour une autre commande d'un panier déjà payé, la commande n'est pas modifiée. Une note vous demande de le rembourser dans le tableau de bord KOMOJU s'il s'agit d'un doublon. Les commandes remboursées ne sont jamais rouvertes.

Les notes sont des entrées de l'History de la commande que le client ne voit pas.

Onglet VibeFox KOMOJU Payment

Dans Sales > Orders, ouvrez une commande payée avec KOMOJU. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox KOMOJU Payment affiche l'identifiant du paiement KOMOJU (lié au paiement dans le tableau de bord KOMOJU) avec une étiquette Test mode pour les paiements de test, le mode de paiement, la session, le numéro de commande chez KOMOJU, le statut, les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements (depuis OpenCart ou depuis le tableau de bord KOMOJU) et les KOMOJU notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Dans l'onglet VibeFox KOMOJU Payment, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement une Reason (optional), puis cliquez sur Refund via KOMOJU. Confirmez la question Refund this amount through KOMOJU? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Les remboursements sont limités au montant que KOMOJU a réellement encaissé : après un écart de montant, vous pouvez donc rembourser jusqu'à ce que le client a payé, et non le total de la commande. Le remboursement est envoyé avec la clé du mode dans lequel le paiement a été effectué ; la clé secrète de ce mode doit donc être renseignée. L'extension vérifie d'abord le paiement chez KOMOJU et refuse les remboursements supérieurs au montant encore remboursable. Si KOMOJU ne peut pas rembourser un paiement automatiquement (certains modes, par exemple konbini, nécessitent les coordonnées bancaires du client), le message d'erreur de KOMOJU s'affiche et rien n'est enregistré : traitez ces remboursements dans le tableau de bord KOMOJU. Un remboursement n'est considéré comme effectué que lorsque KOMOJU le confirme. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes. Un remboursement total fait passer la commande à Refunded Status sans remettre les produits en stock, comme un changement manuel de statut. Un remboursement partiel ne modifie pas le statut. Les remboursements sont disponibles dès que KOMOJU a capturé le paiement.

Pour les paiements que KOMOJU a convertis dans une autre devise (par exemple konbini en JPY pour une commande en EUR), seul un remboursement total est possible depuis OpenCart. Effectuez les remboursements partiels dans le tableau de bord KOMOJU.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via KOMOJU.

Les remboursements effectués dans le tableau de bord KOMOJU parviennent par webhook et sont ajoutés à l'historique des remboursements avec une note. Lorsque le paiement entier est remboursé, la commande passe à Refunded Status. Les remboursements partiels effectués dans le tableau de bord pour des paiements convertis dans une autre devise ne sont notés que sur la commande : enregistrez manuellement dans OpenCart le montant correspondant.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox KOMOJU Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit, au-dessus des réglages. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date de fin de validité de la licence 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: opencart-payment-komoju et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify sur l'extension peuvent modifier la clé. Les textes du bloc suivent la langue de l'administration (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, l'extension continue de fonctionner avec le dernier statut connu.

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

Sans clé active, KOMOJU n'est pas affiché aux clients à la commande. Si un paiement est lancé malgré tout, le client voit This payment method is not available. Please choose another one. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit encore le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sous OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion administrateur, donc sans clé active le mode de paiement est masqué pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés, et les remboursements fonctionnent.

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 lorsque vous ouvrez le Dashboard ou la page Edit de l'administration : 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 de l'extension supprime toujours la clé de licence et le statut de licence.

Dépannage

KOMOJU n'apparaît pas à la commande : vérifiez que la licence est active, que Enable/Disable est activé et que le mode actuel dispose d'une clé secrète : Sandbox Secret Key en mode test, Live Secret Key en mode réel. Le client doit payer dans une devise prise en charge par KOMOJU. La page des réglages affiche un avertissement lorsqu'un élément manque. Vérifiez aussi que l'adresse de paiement se situe dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages.

Le paiement a abouti, mais la commande reste sans statut : le webhook ne fonctionne pas. Dans le tableau de bord KOMOJU, vérifiez que le webhook existe pour le mode utilisé, que son URL est exactement celle indiquée dans la section Webhook URL et que les événements sont sélectionnés. Vérifiez que son jeton secret se trouve dans le champ correspondant (Live Webhook Secret Token ou Sandbox Webhook Secret Token), et consultez le champ Log de la page de l'extension. Les paiements par carte sont aussi confirmés lorsque le client revient dans votre boutique, mais les paiements en konbini et par virement bancaire ne sont confirmés que par le webhook.

Le webhook répond Failed to verify KOMOJU webhook signature.: le jeton secret est absent ou appartient à un autre webhook. KOMOJU relance la notification.

Le webhook répond Mode mismatch, ignored.: le webhook a été signé avec le jeton secret de l'autre mode que celui dans lequel le paiement a été effectué. Utilisez des webhooks et des jetons distincts pour le mode réel et le mode test, et vérifiez qu'ils ne sont pas inversés.

Le webhook répond Order not found.: le paiement n'appartient à aucune commande de cette boutique, par exemple parce qu'il a été effectué par une autre boutique utilisant le même compte KOMOJU. L'événement est ignoré.

Le webhook répond Order is busy, retry later. ou Temporary error, retry later.: la commande était en cours de mise à jour par une autre requête, ou le paiement n'a pas pu être traité à ce moment-là. KOMOJU relance la notification. La raison figure dans le journal.

L'URL du webhook affiche une erreur dans le navigateur : c'est normal. L'URL n'accepte que les requêtes signées provenant de KOMOJU.

La commande est dans un statut en attente ou suspendu : lisez les KOMOJU notes dans l'onglet de la commande. Un justificatif attend le paiement, un paiement attend la capture dans le tableau de bord KOMOJU, le montant ou la devise ne correspondait pas, ou le paiement est arrivé après l'annulation de la commande.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : KOMOJU n'a pas encore capturé le paiement, il est entièrement remboursé, votre groupe d'utilisateurs n'a pas le droit de modifier l'extension, ou la clé secrète du mode du paiement n'est pas renseignée.

Le remboursement échoue : lisez le message. La clé secrète du mode dans lequel le paiement a été effectué peut être absente, le paiement peut ne pas être remboursable automatiquement (remboursez-le dans le tableau de bord KOMOJU), KOMOJU peut ne pas reconnaître le paiement avec la clé configurée, ou seul un remboursement total est possible pour un paiement converti.

Pour les développeurs : l'extension déclenche les événements OpenCart komoju_p_supported_currencies (pour modifier la liste des devises) et komoju_p_session_params (pour modifier la session de paiement, par exemple les modes de paiement).

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox KOMOJU Payment. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres réglages de l'extension : Enable/Disable, Sort Order, Geo Zone, Total et les statuts de commande de la section Orders, qui reviennent à leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sous OpenCart 4, également ses événements et son action de démarrage, qui laisse passer le webhook et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, clés, jetons de webhook, mode sandbox, préfixe de facture, journalisation) et le journal sont supprimés. S'il est désactivé, ils sont conservés pour une future réinstallation. Les transactions et remboursements KOMOJU sont toujours conservés, de sorte que les anciennes commandes peuvent encore être confirmées et remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sous OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation, cliquez sur Uninstall (le bouton orange −) à côté de VibeFox KOMOJU Payment dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de poubelle) pour supprimer le paquet téléversé.

KOMOJU est une marque commerciale de son titulaire. Cette extension n'est ni affiliée à KOMOJU ni approuvée par KOMOJU.