VibeFox Moyasar for OpenCart

Présentation

VibeFox Moyasar Payment Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements via la page de paiement hébergée de Moyasar. À la dernière étape du paiement, le client clique sur Confirm Order, est redirigé vers une page de paiement Moyasar créée pour la commande, paie avec mada, Visa, Mastercard, Apple Pay, STC Pay ou une autre méthode active sur votre compte Moyasar, puis revient sur votre boutique. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'après la confirmation du paiement par Moyasar ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques d'Arabie saoudite et du CCG qui souhaitent accepter les paiements locaux et internationaux avec un compte Moyasar. L'extension ne gère que les paiements uniques. Elle ne propose pas de formulaire de carte sur votre propre tunnel de commande, ni de cartes enregistrées, d'abonnements, ou d'autorisation et de capture séparées. Les moyens de paiement affichés sur la page Moyasar se configurent dans votre compte Moyasar, et non dans l'extension.

Principales fonctionnalités

Page de paiement Moyasar : une facture est créée pour le total de la commande dans la devise de la commande : SAR, AED, USD, EUR, KWD, BHD ou OMR. Les devises à trois décimales sont correctement converties en fils.

Payée seulement après confirmation de Moyasar : l'extension lit la facture depuis l'API Moyasar avec votre clé secrète avant de définir le statut de la commande. Le retour du client, la notification de facture et le webhook facultatif sont vérifiés de la même manière. OpenCart envoie ensuite ses e-mails habituels de commande.

Contrôle du montant et de la devise : le montant et la devise payés sont comparés à la commande. Un écart place la commande dans un statut de vérification accompagné d'une note.

Aucun double traitement : chaque paiement n'est appliqué qu'une fois, même lorsque des confirmations arrivent en même temps. Une nouvelle tentative réutilise ou annule la page de paiement ouverte du panier, de sorte qu'elle ne peut pas être payée deux fois.

Modes test et production : clés secrètes distinctes pour chaque mode. Chaque paiement est vérifié et remboursé avec la clé du mode dans lequel il a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Moyasar Payment Gateway de la commande, jusqu'au montant débité par Moyasar. Un remboursement total d'un paiement par carte effectué il y a moins de 2 heures est envoyé sous forme d'annulation (void). Les remboursements effectués dans le tableau de bord Moyasar sont signalés sur la commande.

Vos propres statuts de commande : choisissez le statut OpenCart pour une commande payée, un paiement en cours d'examen par Moyasar, un paiement bloqué, une erreur de paiement et un remboursement total.

Conditions OpenCart : zone géographique, montant minimal de la commande et ordre de tri. Journal sans clés, données de carte ni coordonnées des clients.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé sur 4.1.0.3), PHP 8.0 ou ultérieur. Une seule archive contient les paquets des deux versions. Un compte Moyasar avec des clés API secrètes ; un webhook dans le tableau de bord Moyasar est recommandé. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).