VibeFox Omise for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

HTTPS : les champs de carte se trouvent sur votre page de paiement ; le paiement doit donc être servi en HTTPS. Les données de carte n'atteignent jamais votre serveur. Omise n'envoie des webhooks qu'à des adresses HTTPS, et la page 3-D Secure de la banque doit être une adresse HTTPS.

Devise : l'une de ces devises : THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD. Lorsque le client paie dans une autre devise, le mode de paiement est masqué lors du paiement.

Compte Omise : vous avez besoin de la clé publique et de la clé secrète de votre compte Omise, pour le mode test comme pour le mode réel, disponibles dans Settings > Keys du tableau de bord Omise, ainsi que d'un point de terminaison de webhook dans Settings > Webhooks (voir Configuration).

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

Installation

Le téléchargement est un seul fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_omise_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_omise_payment.ocmod.zip. Installez uniquement le paquet de 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_omise_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 et choisissez le type Payments. Repérez VibeFox Omise 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 en forme de 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 License key).

4. Saisissez vos clés Omise de test et de production, et ajoutez l'URL du webhook affichée sur la page des réglages dans le tableau de bord Omise (voir Configuration).

5. Activez Enable/Disable et cliquez sur Save. Testez un paiement en mode test avec une carte de test Omise, par exemple 4242 4242 4242 4242, puis désactivez Test mode.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_omise_payment.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension du 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 Omise Payment, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

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

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

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Omise Payment > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Au-dessus des réglages, la page affiche Test mode is on — orders are charged with the test keys, no real money is moved. tant que le mode test est activé, vous avertit lorsque la clé publique ou la clé secrète du mode actuel est absente (le mode de paiement est alors masqué lors du paiement), et vous avertit si Omise n'accepte pas la devise par défaut de votre boutique. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, un Title vide ou comptant plus de 128 caractères, un Sort Order qui n'est pas un nombre entier, un Total qui n'est pas un nombre supérieur ou égal à 0 ou un statut de commande inconnu bloquent l'enregistrement : rien n'est sauvegardé et l'erreur est affichée. Une clé au mauvais préfixe (par exemple une clé de test saisie dans un champ de production) n'est pas enregistrée : la valeur précédente est conservée, un avertissement indique le champ concerné, et les autres champs sont enregistrés.

Omise

Enable/Disable : Enable card payments via Omise active ou désactive le mode de paiement. Par défaut : off.

Title : le nom du mode de paiement que le client voit lors du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit / Debit Card. Obligatoire, jusqu'à 128 caractères.

Description : le texte affiché au-dessus du formulaire de carte à l'étape Confirm Order. Par défaut : Pay securely with your credit or debit card via Omise.

Sort Order : la position d'Omise parmi les modes de paiement lors du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : n'affiche le formulaire de carte 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. Sur OpenCart 4, lorsque la boutique ne demande aucune adresse de paiement, l'adresse de livraison est utilisée.

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

Clés API

Retrouvez vos clés dans le tableau de bord Omise, sous Settings > Keys (la page contient un lien vers cet endroit). Les clés de test commencent par pkey_test_ et skey_test_, les clés de production par pkey_ et skey_.

Test mode : utilise les clés de test, sans débit réel. Il bascule les deux clés à la fois. Les captures, les remboursements et les vérifications de statut d'une commande utilisent toujours les clés du mode dans lequel la commande a été payée. Par défaut : on.

Test public key : la clé publique du mode test, pkey_test_..., utilisée par Omise.js dans le navigateur.

Test secret key : la clé secrète du mode test, skey_test_...

Live public key : la clé publique du mode réel, pkey_..., utilisée par Omise.js dans le navigateur.

Live secret key : la clé secrète du mode réel, skey_...

Les clés secrètes enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que si vous souhaitez la modifier. Pour supprimer une clé enregistrée, cochez Clear the saved value on save sous le champ puis cliquez sur Save.

Paiement et webhook

Webhook URL : l'adresse du webhook de votre boutique. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_omise_payment/webhook, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_omise_payment/payment/wcp_omise_payment.webhook. Elle est construite à partir de l'adresse publique de votre installation OpenCart. Copiez-la exactement telle qu'elle apparaît dans les réglages, puis ajoutez-la dans le tableau de bord Omise, sous Settings > Webhooks (HTTPS uniquement). L'extension traite ces événements (ils sont également listés dans cette section) :

Omise ne signe pas les webhooks : le contenu d'un webhook n'est donc jamais considéré comme fiable. Le débit doit avoir été créé par cette boutique pour cette commande, et son statut est relu depuis l'API Omise avec la clé secrète du mode du paiement. Sans webhook, une commande dont le client ferme le navigateur pendant 3-D Secure n'est pas mise à jour automatiquement, et les captures effectuées dans le tableau de bord Omise ne sont pas prises en compte tant que vous ne cliquez pas sur Sync payment status.

Payment action : ce qu'il advient du montant de la carte.

Per-charge webhook : envoie l'URL du webhook avec chaque débit. Utile lorsque plusieurs boutiques partagent un même compte Omise. Ne fonctionne que si la boutique utilise HTTPS ; sinon, le webhook du tableau de bord est utilisé. Par défaut : off.

Commandes

La commande est créée à l'étape Confirm Order sans statut (une commande manquante) et ne reçoit un statut qu'après qu'Omise a répondu pour la carte. OpenCart ne dispose pas de statut On hold : par défaut, les statuts autorisé, en vérification et en attente sont tous sur Pending ; l'onglet de la commande et les notes permettent de les distinguer. Vous pouvez créer vos propres statuts dans System > Localisation > Order Statuses et les sélectionner ici.

Order Status After Payment : la carte a été débitée (Capture immediately, ou capture ultérieure). Par défaut : Processing.

Authorized Status : Authorize only : le montant est réservé, pas encore capturé. Par défaut : Pending.

On Hold (Review) Status : le montant ou la devise débité diffère de la commande. Par défaut : Pending.

Awaiting Payment Status : le client a terminé, mais Omise n'a pas encore confirmé le débit. Par défaut : Pending.

Failed Status : un débit en attente pour une commande ayant déjà un statut a échoué plus tard. Par défaut : Failed.

Canceled Status : le débit a expiré ou l'autorisation a été annulée ; aucun argent n'a été prélevé. Par défaut : Canceled.

Refunded Status : défini lorsque le paiement est entièrement remboursé depuis l'onglet de la commande. Par défaut : Refunded.

Avancé

Debug log : écrit les requêtes API et les événements de paiement dans omise_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web, et lorsqu'il atteint 5 Mo, il est déplacé vers omise_p_debug.old.log.php. Les clés, jetons et données de carte ne sont jamais journalisés. Par défaut : off. Rien n'est écrit tant qu'il est désactivé, erreurs comprises ; activez-le donc lorsque vous recherchez un problème.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete data on uninstall : lorsqu'il est activé, la désinstallation de l'extension supprime les réglages et le journal de débogage. Les débits et remboursements Omise des commandes constituent l'historique des paiements et sont toujours conservés. Par défaut : off.

Import / Export

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

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, Credit / Debit Card). À l'étape Confirm Order, le client voit votre description et le formulaire de carte : Name on card, Card number, Expiry month (MM), Expiry year (YYYY) et Security code (CVV). En mode test, le formulaire affiche TEST MODE — use Omise test cards (e.g. 4242 4242 4242 4242), no real charges are made. OpenCart crée la commande à cette étape, toujours sans statut. Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc des modes de paiement, dans la fenêtre Payment method options ; le formulaire de carte se trouve dans la section de confirmation, en bas de la page de paiement, au-dessus de Confirm Order. Lorsque le client clique sur Confirm Order, Omise.js transforme la carte en jeton à usage unique dans le navigateur, en utilisant l'adresse de paiement de la commande (sur OpenCart 4, lorsque la boutique ne demande aucune adresse de paiement, l'adresse de livraison). Les champs de carte ne sont jamais envoyés à votre boutique. Les champs manquants ou invalides sont signalés au-dessus du formulaire, par exemple Please enter a valid card number.

Votre boutique crée ensuite le débit avec la clé secrète, pour le montant total de la commande dans la devise de la commande. La description du débit correspond au nom de la boutique et au numéro de commande, et l'identifiant de la commande est enregistré dans les métadonnées du débit. Si la banque exige 3-D Secure, le client est redirigé vers la page de sa banque puis renvoyé vers votre boutique, et le résultat est relu depuis l'API Omise.

La commande n'est marquée comme payée qu'après confirmation par Omise : le débit doit être capturé, et son montant et sa devise doivent correspondre à la commande. La commande reçoit ensuite son statut de la manière standard d'OpenCart, avec les e-mails de commande habituels et la mise à jour des stocks, et le client voit la page de confirmation de commande d'OpenCart avec Your card payment has been received. Avec Authorize only, la page indique Your card payment has been authorized. The amount will be charged when your order is processed. Si Omise signale toujours le paiement comme en attente, la commande reçoit le Awaiting Payment Status et la page indique Your payment is being confirmed by Omise. You will receive an e-mail as soon as it is confirmed — please do not pay again. Lorsque Omise confirme ou refuse le paiement plus tard (le webhook ou le retour du client), le nouveau statut de la commande est envoyé avec notification du client, de sorte qu'OpenCart lui envoie un e-mail. Si le paiement ne peut pas être confirmé juste après 3-D Secure, une page Payment confirmation affiche We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again. et un bouton Check again.

Si la carte est refusée, la commande reste sans statut. Le client reste à l'étape Confirm Order avec Payment failed : et un motif, par exemple des fonds insuffisants, un code de sécurité invalide ou un refus de l'émetteur de la carte, et il peut réessayer avec le même panier. Si 3-D Secure échoue, le client revient à la caisse avec le motif ; si le débit a entre-temps expiré ou été annulé, le message est The payment was not completed. Please try again. Sur OpenCart 4, ces messages après 3-D Secure s'affichent au-dessus de la page de paiement.

Une nouvelle tentative ne débite jamais deux fois. OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order ; OpenCart 4 conserve une seule commande pour le paiement et la met à jour, de sorte qu'après une carte refusée ou un 3-D Secure échoué, le client paie la même commande avec un nouveau débit. Si le débit précédent du panier est déjà payé ou autorisé, cette commande reçoit son statut et aucun nouveau débit n'est effectué. Une tentative 3-D Secure inachevée expire avant qu'un nouveau débit ne soit effectué. Si un second débit reste payé pour un panier déjà payé (par exemple dans un autre onglet du navigateur), aucune commande n'est modifiée et une note sur la commande payée vous demande de la rembourser ou de l'annuler dans le tableau de bord Omise.

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 parce que son débit a échoué ou expiré, ou que vous l'avez annulée ou remboursée), le client est renvoyé au paiement avec Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order., et le prochain Confirm Order paie une nouvelle commande. Si cette commande est déjà payée et que le panier contient désormais d'autres produits ou quantités, le client est également renvoyé au paiement, et le nouveau panier reçoit une nouvelle commande.

Le webhook fonctionne aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute une action de démarrage qui laisse passer le webhook et le retour du client depuis 3-D Secure.

L'extension n'accepte que les cartes. Elle ne propose pas d'autres moyens de paiement Omise (PromptPay, TrueMoney, paiement mobile, paiement en plusieurs fois), ni cartes enregistrées ou clients Omise, ni abonnements, ni capture partielle.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client est sur la page 3-D Secure, ou la carte a été refusée. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Sur OpenCart 4, une commande non payée du paiement peut recevoir le statut Voided, que OpenCart 4 définit lorsque le client revient à l'étape Confirm Order. L'extension traite une telle commande comme une commande sans statut, et un paiement ultérieur la confirme tout de même.

Order Status After Payment (par défaut Processing) : le paiement a été confirmé. Une note indique le montant, le débit Omise (chrg_...) et la manière dont il a été confirmé (paiement, retour de 3-D Secure, webhook, nouvelle tentative de paiement, capture manuelle ou synchronisation manuelle).

Authorized Status (par défaut Pending) : la carte a été autorisée avec Authorize only. Utilisez Capture payment ou Void authorization.

Awaiting Payment Status (par défaut Pending) : Omise n'a pas encore confirmé le paiement. Le webhook ou Sync payment status met la commande à jour.

On Hold (Review) Status (par défaut Pending) : le montant ou la devise du débit diffère de la commande, par exemple parce que la commande a été modifiée pendant 3-D Secure. La note indique les deux valeurs. Vérifiez la commande et exécutez-la, ou remboursez le paiement.

Failed Status (par défaut Failed) : un paiement en attente a échoué plus tard. Une commande payée n'est jamais rétrogradée par un événement d'échec ultérieur.

Canceled Status (par défaut Canceled) : le débit a expiré ou l'autorisation a été annulée.

Refunded Status (par défaut Refunded) : le paiement a été entièrement remboursé par l'intermédiaire de l'extension.

Si un débit payé ou autorisé arrive pour une commande déjà au statut annulé ou remboursé, la commande n'est pas rouverte. Une note vous demande de vérifier le tableau de bord Omise et de rembourser ou rouvrir la commande manuellement.

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

Onglet VibeFox Omise Payment

Dans Sales > Orders, ouvrez une commande payée avec Omise. En bas de la page de commande, à côté de History et Additional, l'onglet VibeFox Omise Payment affiche l'identifiant du débit avec une étiquette Test pour les paiements de test, l'action de paiement, le statut du débit, la marque de la carte et les derniers chiffres, les montants Charged / order / refunded, les boutons, le formulaire de remboursement, l'historique des remboursements et les Omise notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension. Les boutons nécessitent le droit de modifier l'extension (à régler dans System > Users > User Groups) et la clé secrète du mode dans lequel le paiement a été effectué. Le résultat de chaque action est affiché dans l'onglet.

Capture payment : capture la totalité du montant autorisé et place la commande sur Order Status After Payment. Affiché uniquement pour les commandes autorisées.

Void authorization : annule l'autorisation ; aucun argent n'est capturé et la commande passe sur Canceled Status. Affiché uniquement pour les commandes autorisées.

Sync payment status : relit le débit depuis Omise, par exemple après une capture ou un remboursement effectué dans le tableau de bord Omise, met la commande à jour et ajoute une note avec le statut du débit et le total remboursé chez Omise.

Les changements de statut effectués depuis l'onglet ne notifient pas le client et ne déplacent pas les stocks, comme un changement manuel de statut.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est prérempli), facultativement un Reason (optional), puis cliquez sur Refund via Omise. Confirmez la question Refund this amount through Omise? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Les remboursements sont effectués dans le montant et la devise débités par Omise ; ainsi, après un écart de montant ou de devise, vous pouvez rembourser jusqu'à ce que le client a réellement payé, et non le total de la commande. Le remboursement est envoyé dans le mode dans lequel le paiement a été effectué, de sorte que la clé secrète de ce mode doit être renseignée. Le motif est enregistré avec le remboursement chez Omise. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec l'identifiant de remboursement Omise. Un remboursement total place la commande sur Refunded Status ; un remboursement partiel ne modifie pas le statut. Pour une autorisation qui n'a pas encore été capturée, seul un remboursement total est possible, et il annule l'autorisation. Si Omise rejette le remboursement, l'onglet affiche Refund failed. avec le message d'Omise, et aucun remboursement n'est enregistré.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent au client par l'intermédiaire d'Omise. Les remboursements effectués dans le tableau de bord Omise ne sont pas enregistrés dans OpenCart ; Sync payment status affiche le total remboursé.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Omise Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox Omise 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 revérifier 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-omise 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 issue de 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, Omise n'est pas affiché aux clients lors du paiement. 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 toujours le mode de paiement dans la boutique, avec la mention (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. 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

Omise n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que les deux clés du mode actuel sont saisies (clés de test en mode test, clés de production sinon) et que le client paie dans l'une des devises prises en charge. La page des réglages affiche un avertissement lorsque des clés manquent. Vérifiez également 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 ou en Awaiting Payment Status : le webhook ne fonctionne pas. Dans le tableau de bord Omise, vérifiez que l'URL du webhook est exactement celle affichée dans Webhook URL et qu'elle utilise HTTPS. Sur une commande existante, cliquez sur Sync payment status. Activez Debug log pour voir les réponses du webhook.

Le webhook répond Charge ID does not match order ou Order not found : le débit de l'événement n'a pas été créé par cette boutique pour cette commande. Rien n'est modifié.

Le webhook répond Order is being processed, retry later ou Failed to verify charge : le panier a été verrouillé par une autre requête au même moment, l'API Omise n'a pas pu être jointe, ou la clé secrète du mode du paiement est absente. Omise relance le webhook.

Le webhook répond The order status could not be set, retry later : le statut de la commande n'a pas pu être défini à ce moment-là. Omise relance le webhook. Activez Debug log pour connaître la raison.

L'URL du webhook affiche Method not allowed dans le navigateur : c'est normal. L'URL n'accepte que les requêtes provenant d'Omise.

Avertissement à l'enregistrement : key must start with ... ou must be a live key : une clé a été collée dans le mauvais champ et n'a pas été enregistrée. Les clés de test commencent par pkey_test_ / skey_test_, les clés de production par pkey_ / skey_.

Le client voit Card payments are temporarily unavailable : les clés sont incorrectes, ou le jeton de carte appartient à l'autre mode (un jeton de test en mode réel, ou l'inverse). Vérifiez les clés et Test mode.

Le client voit We could not reach the payment provider : aucune réponse valide n'est venue d'Omise lors de la création du débit. Un débit a pu être créé malgré tout ; vérifiez le tableau de bord Omise avant que le client ne paie à nouveau.

Le client voit This order is already being paid : le paiement a été soumis deux fois au même moment. Le client attend un instant et consulte ses e-mails avant de réessayer.

La commande est au statut de vérification après le paiement : lisez les notes de l'onglet VibeFox Omise Payment (voir Order statuses), puis exécutez la commande ou remboursez le paiement.

Le remboursement échoue avec un message concernant le mode : le paiement a été effectué en mode test ou en mode réel, et la clé secrète de ce mode n'est pas définie. Saisissez-la et réessayez.

Le remboursement partiel d'une commande autorisée échoue : le paiement est seulement autorisé. Capturez-le d'abord, ou remboursez la totalité du montant pour l'annuler.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Omise 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 reprennent leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension est également supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laisse passer le webhook et le retour de 3-D Secure en mode maintenance). Si Delete data on uninstall est activé, les autres réglages (titre, description, mode test, clés, action de paiement, options du webhook et de journalisation) et le journal de débogage sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les débits et remboursements Omise sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

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

Omise est une marque déposée de son titulaire. Cette extension n'est ni affiliée à Omise ni approuvée par Omise.