VibeFox Moyasar for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur.

Devise : la devise du paiement doit être SAR, AED, USD, EUR, KWD, BHD ou OMR. Pour toute autre devise, le mode de paiement est masqué lors du paiement.

Compte Moyasar : vous avez besoin des clés API secrètes de votre compte Moyasar (test et production). Seules les clés secrètes sont utilisées. La clé publique (publishable key) n'est pas nécessaire, car le paiement a lieu sur la page de Moyasar. Un webhook dans le Dashboard Moyasar est recommandé (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 fichier zip unique contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_moyasar_payment_gateway.ocmod.zip. Installez uniquement 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 sélectionnez le fichier wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip. L'extension ne contient aucune modification OCMOD : Extensions > Modifications n'a donc pas besoin d'être actualisé. Au lieu de passer par 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 Moyasar Payment Gateway 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 situé en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Collez vos clés secrètes Moyasar et cliquez sur Save. Le premier enregistrement génère le secret partagé du webhook et l'affiche une seule fois au-dessus des réglages. Configurez le webhook dans le Dashboard Moyasar avec ce secret (voir Configuration).

5. Activez Enable/Disable et cliquez sur Save. Passez une commande de test en mode test, puis désactivez Test mode.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et sélectionnez le fichier wcp_moyasar_payment_gateway.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é de celui-ci.

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

4. Saisissez la clé de licence, les clés Moyasar 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 Webhook URL).

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 Moyasar Payment Gateway > 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 vous avertit lorsque le mode actuel ne dispose d'aucune clé secrète (le mode de paiement est alors masqué lors du paiement), lorsqu'aucun secret partagé de webhook n'est enregistré (le webhook rejette alors tous les appels) ou lorsque la devise par défaut de la boutique n'est pas prise en charge. Tant que l'extension est activée en mode test, elle affiche Le mode test est actif : les paiements sont simulés, aucun argent n'est débité. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, Title doit comporter de 1 à 128 caractères, Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre égal ou supérieur à 0, et la zone géographique ainsi que les statuts de commande doivent exister ; sinon, rien n'est enregistré. L'extension refuse une clé publique, une clé de l'autre mode ou une clé contenant des espaces : le reste est enregistré avec Réglages enregistrés, sauf la clé affichée en rouge., l'ancienne clé est conservée et la raison est affichée. Si l'extension est activée sans la clé secrète du mode actuel, les réglages sont enregistrés avec un avertissement.

Moyasar

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

Title : le nom du mode de paiement que le client voit lors du paiement. C'est aussi le nom enregistré dans la commande. Par défaut : Pay with Moyasar. Obligatoire, 128 caractères maximum.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. En mode test, l'étape ajoute (Mode test : aucun paiement réel n'est effectué.)

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

Geo Zone : proposer Moyasar uniquement pour les adresses de facturation 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 Moyasar soit proposé. Laissez le champ vide pour proposer Moyasar quel que soit le montant.

Clés API

Copiez les clés secrètes depuis Moyasar Dashboard > Settings > API Keys (la page contient un lien vers celle-ci). Les clés de test et de production sont distinctes. Le mode test n'utilise que la clé de test ; le mode production, uniquement la clé de production.

Test mode : utilise la clé secrète de test : les paiements sont simulés et aucun argent n'est débité. Par défaut : activé. Désactivez-le pour accepter de vrais paiements avec la clé secrète de production. Les factures de l'autre mode continuent d'utiliser la clé de leur propre mode pour les vérifications de statut et les remboursements.

Test secret key : la clé secrète du mode test. Elle commence par sk_test_.

Live secret key : la clé secrète du mode production. Elle commence par sk_live_.

Les clés et les secrets enregistrés ne sont jamais réaffichés. Le champ reste vide et affiche Enregistré — laissez vide pour le conserver. Saisissez une nouvelle valeur uniquement si vous voulez la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ puis cliquez sur Save.

Notifications de paiement (webhook)

Le webhook est recommandé, sans être obligatoire. Les commandes sont également confirmées lorsque le client revient sur la boutique, ainsi que par la notification de facture que Moyasar envoie automatiquement à votre boutique lorsque la facture est payée. Le webhook couvre les clients qui ferment leur navigateur avant de revenir et signale les remboursements effectués dans le Dashboard Moyasar. Ajoutez-le dans Moyasar Dashboard > Settings > Webhooks.

Webhook URL : affichée en lecture seule avec un bouton Copy. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook ; sur OpenCart 4, à https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook. Elle se construit à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle qu'elle est affichée dans les réglages. Méthode HTTP : POST. L'URL doit être accessible depuis Internet.

Webhook shared secret : saisissez la même valeur que le Shared secret du webhook dans Moyasar, ou cochez Generate a new secret et enregistrez. Si rien n'est enregistré, Save génère un secret aléatoire. Un secret généré est affiché une seule fois au-dessus des réglages après l'enregistrement, puis jamais plus : copiez-le immédiatement dans Moyasar. Les webhooks sans le bon secret partagé sont rejetés. Un même secret partagé sert aux deux modes.

Sélectionnez ces événements pour le webhook (ils sont aussi listés dans cette section) :

Aucune donnée provenant d'un webhook ou d'une notification n'est directement tenue pour fiable : pour chacun, l'extension lit la facture depuis l'API Moyasar avec la clé secrète du mode dans lequel la facture a été créée, et vérifie qu'elle a bien été créée par cette boutique. Les paiements issus d'autres intégrations sur le même compte Moyasar sont ignorés.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (commande incomplète). La commande ne reçoit un statut qu'après que Moyasar a confirmé la facture. Chacun des champs ci-dessous liste vos statuts de commande OpenCart.

Status after payment : le statut défini après un paiement confirmé. Par défaut : En traitement. Choisissez Complete si les commandes payées doivent être terminées immédiatement, ou votre statut de vérification si chaque commande payée doit attendre une vérification manuelle.

Awaiting Moyasar payment status : Moyasar retient le paiement pour examen ; la commande passe à Status after payment lorsque Moyasar le confirme. Par défaut : En attente.

Moyasar payment on hold status : Moyasar a indiqué un montant ou une devise différents du total de la commande, ou la facture a été payée après que la commande a été annulée ou a reçu un autre statut. La commande n'est pas marquée comme payée. Par défaut : En attente, car OpenCart ne dispose pas de statut En suspens. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Payment error status : le paiement examiné a échoué. Par défaut : Échoué.

Refunded status : défini une fois le paiement entièrement remboursé depuis la page de la commande. Par défaut : Remboursé.

Avancé

Debug log : consigne les appels à l'API et les notifications dans moyasar_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web et, à 5 Mo, il est déplacé vers moyasar_p_debug.old.log.php. Les erreurs et les avertissements sont toujours journalisés. Les clés API, les données de carte et les informations des clients ne sont jamais journalisées. Par défaut : désactivé.

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

Clean uninstall : lorsqu'elle est activée, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les données de paiement enregistrées avec les commandes (identifiants de facture et de paiement Moyasar) sont conservées, afin que les remboursements restent traçables. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les clés et les secrets ne sont pas exportés.

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

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Pay with Moyasar). À l'étape Confirm Order, le client voit votre description. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée une facture Moyasar pour le total de la commande dans la devise de la commande, puis envoie le client sur sa page de paiement. Là, le client paie avec n'importe quel moyen actif sur votre compte Moyasar. Sur 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. La facture affiche Order #, le numéro de commande et le nom de votre boutique.

La commande n'est marquée comme payée qu'après confirmation de Moyasar : l'extension lit la facture depuis l'API Moyasar et vérifie qu'elle est payée, qu'elle appartient à cette commande, et qu'elle correspond exactement au montant et à la devise de la commande. La commande reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails habituels et la mise à jour du stock, et le client voit la page de confirmation de commande d'OpenCart avec le message Your payment with Moyasar has been received. Si Moyasar retient le paiement pour examen, la page affiche Your payment is being reviewed by Moyasar. The order will be updated automatically when Moyasar confirms it — please do not pay again. Si la commande est en suspens pour votre examen, la page affiche We have received your payment and are reviewing your order. We will contact you if anything is needed — please do not pay again. Si un paiement en cours d'examen échoue plus tard, la page affiche Your Moyasar payment was not completed. Please contact us about this order.

Si le client revient sans avoir payé (par exemple avec le bouton retour de la page de paiement), il revient au paiement avec l'un de ces messages : The payment at Moyasar was not completed. You can try again or choose another payment method., Your Moyasar payment was declined or has expired. Please try again or choose another payment method. ou, lorsque le paiement ne peut pas encore être vérifié, We could not confirm your payment with Moyasar yet. If you completed the payment, the order will be updated automatically in a few minutes — please check your e-mail before paying again. Le panier est conservé. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement.

Le client peut réessayer. OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée, alors qu'OpenCart 4 conserve une seule commande pour le paiement et paie de nouveau cette même commande. L'extension vérifie d'abord les factures ouvertes du même panier : si la page de paiement ouverte de cette commande a toujours le même mode, le même montant et la même devise, elle est réutilisée ; sinon, l'ancienne facture est annulée chez Moyasar et une nouvelle est créée, de sorte que l'ancienne ne peut plus être payée. Si une facture antérieure du panier s'avère déjà payée, ce paiement est confirmé à la place d'en créer un nouveau.

OpenCart 4 conserve la commande pendant le paiement jusqu'à l'affichage de la page de confirmation de commande. Si cette commande a été fermée sans paiement entre-temps (par exemple parce que vous l'avez annulée ou que son paiement a échoué), le client est renvoyé au paiement avec le message Votre commande précédente a été annulée ou son paiement a échoué. Veuillez confirmer à nouveau la commande., et le prochain Confirm Order paie une nouvelle commande. Une commande du panier qui a été payée puis annulée ou remboursée ne bloque plus le panier.

Si Moyasar ne parvient pas à démarrer le paiement, le client reste à l'étape Confirm Order avec un bref message au-dessus du bouton, par exemple The Moyasar payment service is not responding. Please try again in a few minutes., et peut choisir un autre mode de paiement. Les détails sont écrits dans le journal.

Le webhook et la notification de facture fonctionnent aussi lorsque la boutique est en mode maintenance, car OpenCart 3 laisse passer les requêtes des extensions de paiement ; sur OpenCart 4, l'extension ajoute pour elles une action de démarrage, qui permet aussi au client de revenir depuis Moyasar.

L'extension ne gère que les paiements uniques sur la page de Moyasar. Elle ne propose pas de formulaire de carte sur votre propre page de paiement, ni cartes enregistrées ou tokenisation, ni abonnements, ni autorisation et capture séparées.

Commandes et remboursements

Statuts de commande

Aucun statut (commande incomplète) : le client a été envoyé vers Moyasar et n'a pas payé, Moyasar n'a pas encore confirmé le paiement, ou le paiement a été refusé, a expiré ou a été annulé. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status défini sur Missing Orders.

Status after payment (par défaut En traitement) : le paiement a été confirmé. Une note indique comment le paiement a été confirmé (webhook, notification de facture, retour du client ou paiement), l'identifiant de la facture, l'identifiant du paiement et le mode de paiement, par exemple la marque de la carte et les quatre derniers chiffres.

Awaiting Moyasar payment status (par défaut En attente) : Moyasar retient le paiement pour examen. La commande passe à Status after payment lorsque Moyasar confirme le paiement, ou à Payment error status lorsque celui-ci échoue.

Moyasar payment on hold status (par défaut En attente) : Moyasar a indiqué un montant ou une devise différents du total de la commande, ou la facture a été payée après que vous avez annulé la commande ou modifié son statut. La commande n'est pas marquée comme payée, mais le montant réellement débité est enregistré pour les remboursements. La note l'explique. Vérifiez le paiement dans le Dashboard Moyasar, puis traitez la commande ou remboursez le paiement.

Payment error status (par défaut Échoué) : le paiement examiné a échoué.

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

Une commande payée ou remboursée n'est jamais modifiée par des événements ultérieurs. Si vous avez déjà défini vous-même un statut payé, le paiement est enregistré et le statut n'est pas modifié. Si une seconde facture d'un panier déjà payé est également réglée (par exemple depuis deux onglets du navigateur), la commande payée n'est pas modifiée. Une note vous invite à rembourser le paiement en double dans le Dashboard Moyasar.

Les notes sont des entrées de l'History de la commande qui ne sont pas visibles par le client.

Onglet VibeFox Moyasar Payment Gateway

Dans Sales > Orders, ouvrez une commande payée avec Moyasar. En bas de la page de la commande, à côté de History et de Additional, l'onglet VibeFox Moyasar Payment Gateway affiche la Moyasar invoice (avec une étiquette Test mode pour les paiements de test), le Moyasar payment, la Method, le Status, les montants Paid / refunded, le formulaire de remboursement, l'historique des remboursements et les Moyasar notes de la commande. L'onglet est affiché aux utilisateurs ayant accès à l'extension.

Remboursements

Dans l'onglet VibeFox Moyasar Payment Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), facultativement un Reason (optional), puis cliquez sur Refund via Moyasar. Confirmez la question Rembourser ce montant via Moyasar ? Cette action est irréversible. Les remboursements totaux et partiels sont pris en charge. Vous devez disposer du droit de modifier l'extension (à définir dans System > Users > User Groups). Les remboursements sont effectués dans le montant et la devise débités par Moyasar : après un écart de montant, vous ne pouvez donc rembourser que ce que le client a réellement payé, et non le total de la commande. Un remboursement total d'un paiement par carte effectué il y a moins de 2 heures est envoyé sous forme d'annulation (void : annulation avant règlement, sans frais) ; les paiements STC Pay et tous les autres cas sont remboursés. Le remboursement utilise la clé secrète du mode dans lequel le paiement a été effectué (test ou production), cette clé doit donc être renseignée. L'extension vérifie d'abord auprès de Moyasar la devise, le statut et le montant remboursable du paiement. Si Moyasar n'accepte pas le remboursement, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement ou une annulation réussi est ajouté à l'historique des remboursements et aux notes. Un remboursement total définit la commande sur Refunded status sans notifier le client et sans remettre les produits en stock, comme pour un changement de statut manuel. Un remboursement partiel ne modifie pas le statut. Les remboursements sont disponibles une fois que Moyasar a confirmé le paiement.

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

Les remboursements et annulations effectués dans le Dashboard Moyasar parviennent par le webhook. Si Moyasar indique un montant remboursé supérieur à celui enregistré par l'extension, une note est ajoutée à la commande. Le statut de la commande n'est pas modifié automatiquement. Mettez-le à jour manuellement si nécessaire, sans utiliser Refund via Moyasar.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Moyasar Payment Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > 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 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: opencart-payment-moyasar 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. 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, Moyasar n'est pas proposé aux clients lors du paiement. Si un paiement est tout de même lancé, 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, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, 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é automatiquement à chaque ouverture du Dashboard ou de la page Edit de l'administration : une fois par jour pendant les 14 premiers jours suivant 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

Moyasar n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode actuel dispose d'une clé secrète : Test secret key en mode test, Live secret key en mode production. La page des réglages affiche un avertissement lorsque la clé manque. Le client doit payer en SAR, AED, USD, EUR, KWD, BHD ou OMR (la devise sélectionnée dans la boutique). Vérifiez également que l'adresse de paiement se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages.

Le paiement est passé, mais la commande reste sans statut : les confirmations n'ont pas atteint votre boutique. Configurez le webhook : dans le Dashboard Moyasar, vérifiez qu'il existe, que son URL correspond exactement au Webhook URL des réglages, que la méthode est POST, que les quatre événements sont sélectionnés et que son secret partagé est identique à celui enregistré dans Webhook shared secret. La commande reçoit également son statut lorsque le client revient sur la boutique ou tente de payer à nouveau le même panier.

Le webhook répond Unauthorized : le secret partagé dans Moyasar diffère de celui enregistré. Saisissez le secret du webhook Moyasar dans Webhook shared secret et enregistrez, ou cochez Generate a new secret, enregistrez et collez le secret affiché dans Moyasar.

Le webhook répond Webhook secret not configured : aucun secret partagé n'est enregistré, par exemple après sa suppression avec Clear the saved value on save. Cliquez sur Save pour en générer un et copiez-le dans Moyasar.

Le webhook répond Key not configured : la facture a été créée dans un mode (test ou production) dont la clé secrète est vide. Saisissez cette clé.

Le webhook répond Verification failed ou Try again later : la facture n'a pas pu être lue depuis l'API Moyasar, le panier était mis à jour par une autre requête au même moment, ou le statut de la commande n'a pas pu être défini. Moyasar renouvellera le webhook. Activez le Debug log pour voir la raison.

L'URL du webhook affiche Method not allowed dans le navigateur : c'est normal. L'URL n'accepte que les requêtes POST envoyées par Moyasar.

Erreur à l'enregistrement concernant la clé : une clé publique (pk_...) ou une clé de l'autre mode a été collée, ou la clé contient des espaces. La valeur précédente a été conservée. Les clés de test commencent par sk_test_, les clés de production par sk_live_.

Le client voit une erreur après Confirm Order : activez le Debug log et consultez le champ Log sur la page de l'extension. Le message Ce mode de paiement n'est pas disponible. signifie que la session de paiement ne correspond plus à la commande, ou que le mode de paiement a été désactivé entre-temps : le client recharge la page de paiement. Le message Ce mode de paiement est temporairement indisponible. Veuillez choisir un autre mode de paiement ou nous contacter. indique en général une clé secrète erronée ou manquante. Le message Un paiement pour cette commande a déjà été reçu et est en cours d'examen. Veuillez nous contacter plutôt que de payer à nouveau. signifie que le panier a déjà une facture payée dont le statut de commande n'a pas pu être défini ; consultez le journal.

La commande est en statut de suspension après paiement : lisez les Moyasar notes dans l'onglet VibeFox Moyasar Payment Gateway. Le montant ou la devise payé différait de la commande, ou le paiement est arrivé après l'annulation de la commande. Traitez la commande ou remboursez le paiement.

Aucun formulaire de remboursement dans l'onglet : l'onglet indique la raison : le paiement n'est pas encore confirmé, il est entièrement remboursé, ou votre groupe d'utilisateurs n'a pas le droit de modifier l'extension.

Le remboursement échoue : lisez le message. Si le paiement a été effectué dans l'autre mode, saisissez la clé secrète de ce mode. Si le montant est supérieur à ce qui peut encore être remboursé par Moyasar, une partie du paiement a déjà été remboursée, par exemple dans le Dashboard Moyasar. Si Moyasar n'a pas confirmé le montant remboursé, vérifiez le paiement dans le Dashboard Moyasar avant de réessayer.

Pour les développeurs : l'extension déclenche les événements OpenCart moyasar_p_supported_currencies et moyasar_p_invoice_params pour modifier les devises prises en charge et les données de la facture.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Moyasar Payment Gateway. 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 nouvelle 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 en mode maintenance). Si Clean uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, clés, secret partagé du webhook, journal de débogage) ainsi que le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les factures, paiements et remboursements Moyasar sont toujours conservés, de sorte que les anciennes commandes 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 Moyasar Payment Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet téléchargé.

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