VibeFox ePay.bg for OpenCart

Présentation

VibeFox ePay.bg Gateway ajoute à OpenCart 3 et OpenCart 4 ePay.bg, le prestataire de paiement bulgare. À la dernière étape de commande, le client clique sur Confirm Order, est redirigé vers la page de paiement d'ePay.bg et paie là-bas par carte bancaire ou avec un compte ePay.bg. ePay.bg envoie ensuite à votre boutique une notification signée, et seule cette notification donne un statut à la commande. OpenCart crée la commande avant le paiement, donc les tentatives non payées restent des commandes manquantes. Les données de carte ne transitent jamais par votre site.

Elle convient aux boutiques qui vendent en lev bulgare (BGN), en euros (EUR) ou en dollars américains (USD) et qui disposent d'un compte marchand ePay.bg. L'extension ne gère que les paiements uniques. Elle ne permet pas de rembourser depuis OpenCart (les remboursements se font dans l'espace marchand d'ePay.bg), ni les cartes enregistrées, les abonnements ou paiements récurrents, ni les codes de paiement en espèces EasyPay ou B-Pay.

Principales fonctionnalités

Page de paiement ePay.bg : une demande de paiement signée pour le total de la commande dans la devise de la commande (BGN, EUR ou USD) est envoyée à ePay.bg, où le client paie par carte ou avec un compte ePay.bg.

Payée uniquement après confirmation d'ePay.bg : les notifications ne sont acceptées qu'avec une somme de contrôle HMAC-SHA1 valide et uniquement pour une facture émise par l'extension. Le retour du client dans la boutique ne paie jamais une commande. OpenCart envoie ensuite ses e-mails habituels de commande.

Contrôle du montant, de la devise et du mode : le montant, la devise et le mode (test ou réel) signés sont enregistrés puis vérifiés à nouveau à l'arrivée du paiement. Un écart place la commande dans un statut de vérification avec une note.

Aucun double traitement : les notifications répétées ou simultanées n'appliquent jamais un paiement deux fois. Un refus ou une expiration tardive ne modifie jamais une commande payée.

Demandes refusées et expirées : la commande ne reçoit aucun statut, le panier est conservé, et le client peut payer à nouveau ou choisir un autre moyen de paiement.

Test et réel : identifiants distincts pour demo.epay.bg et www.epay.bg. Les paiements lancés avant le changement de mode sont toujours confirmés.

Vos réglages : préfixe de facture, délai d'expiration de la demande de paiement, langue de la page ePay.bg (anglais ou bulgare), statut de commande après paiement avec vos propres statuts OpenCart, zone géographique, montant minimum de commande et ordre de tri.

Onglet ePay.bg sur la page de commande : facture, montant demandé, STAN, code BORICA et notes ePay.bg. Les demandes de paiement et les notifications sont consignées dans un journal facultatif sans clés secrètes ni données de carte ; les erreurs sont toujours journalisées.

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 supérieur. Un même téléchargement contient les paquets pour les deux versions. Devise de paiement BGN, EUR ou USD. Un compte marchand ePay.bg avec un numéro de client (MIN) et une clé secrète, et l'URL de notification de votre boutique saisie dans votre profil marchand ePay.bg. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).