VibeFox ePay.bg for PrestaShop

Présentation

VibeFox ePay.bg Gateway ajoute à PrestaShop ePay.bg, le prestataire de paiement bulgare. À l'étape de paiement, le client choisit ePay.bg, est redirigé vers la page de paiement d'ePay.bg et y paie avec une carte bancaire ou un compte ePay.bg. ePay.bg envoie ensuite une notification signée à votre boutique, et seule cette notification crée la commande. Les données de carte ne passent jamais par votre site, et les paiements abandonnés ne laissent aucune commande impayée.

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. Le module n'accepte que les paiements uniques. Il ne propose ni remboursements depuis PrestaShop (les remboursements se font dans le panneau marchand d'ePay.bg), ni cartes enregistrées, abonnements ou paiements récurrents, ni 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 du panier dans la devise du panier (BGN, EUR ou USD) est envoyée à ePay.bg, où le client paie par carte ou avec un compte ePay.bg.

Commande 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 le module. Le retour du client dans la boutique ne crée ni ne paie jamais une commande.

Contrôle du montant, de la devise et du mode : le montant, la devise et le mode (test ou production) signés sont enregistrés et vérifiés de nouveau à l'arrivée du paiement. En cas d'écart, la commande passe à ePay.bg payment on hold avec une note.

Aucun double traitement : les notifications répétées ou parallèles ne créent jamais une deuxième commande et n'enregistrent jamais le paiement deux fois. Un avis tardif de refus ou d'expiration ne modifie jamais une commande payée.

Demandes refusées et expirées : aucune commande n'est créée, le panier est conservé et le client peut payer à nouveau ou choisir un autre mode de paiement.

Test et production : identifiants distincts pour demo.epay.bg et www.epay.bg. Les paiements commencé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) et statut de la commande après paiement.

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

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Devise du panier BGN, EUR ou USD. Un compte marchand ePay.bg avec un numéro client (MIN) et une clé secrète, et l'URL de notification saisie dans votre profil marchand ePay.bg. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).