VibeFox Eupago for PrestaShop

Présentation

VibeFox Eupago Gateway ajoute à PrestaShop les paiements Eupago pour le Portugal. Vous choisissez une méthode de paiement pour la commande : Multibanco, MB WAY ou carte de crédit. Avec Multibanco, le client reçoit une entité et une référence pour payer dans un distributeur automatique de billets ou dans sa banque en ligne. Avec MB WAY, le client approuve une demande dans l'application MB WAY. Avec la carte de crédit, le client paie sur la page de carte d'Eupago puis revient sur votre boutique.

Il convient aux boutiques qui vendent en euros et disposent d'un compte Eupago. Le module propose une seule méthode Eupago par installation et ne gère que les paiements uniques. Il ne prend pas en charge les remboursements depuis PrestaShop (remboursement dans le back-office Eupago), ni les cartes enregistrées, les abonnements ou la pré-autorisation, ni les autres méthodes Eupago comme PayShop, Cofidis Pay ou Bizum, ni les rappels par SMS, ni la date d'expiration Multibanco, ni l'interrogation du statut.

Principales fonctionnalités

Multibanco, MB WAY ou carte : la référence Multibanco est affichée sur la page de confirmation de commande et ajoutée à l'e-mail de confirmation de commande. Le numéro de téléphone MB WAY est demandé lors du paiement, et les numéros portugais peuvent être saisis sans +351.

Commande payée uniquement après confirmation d'Eupago : une commande n'est marquée payée que par une notification Eupago vérifiée : un Webhook 2.0 signé ou le callback hérité authentifié par votre clé API. Pour les paiements par carte, la commande n'est créée qu'après la confirmation du paiement par Eupago.

Contrôles stricts : le montant (au centime près) et la devise doivent correspondre à la commande, la référence de paiement doit avoir été créée pour ce panier, et la notification doit provenir du même environnement (sandbox ou production). Tout autre cas place la commande dans Eupago payment on hold avec une note.

Pas de double traitement : les notifications répétées ne sont appliquées qu'une fois, donc aucune commande, note ni e-mail de statut en double. Un paiement tardif pour une commande annulée est mis en attente de vérification plutôt que perdu.

Sandbox et production : clés API et clés de webhook distinctes pour chaque mode. Changer de mode change les clés et l'hôte Eupago.

Statut de commande au choix : Payment accepted ou Delivered après le paiement, avec un seul changement de statut.

Bloc Eupago sur la page de commande : les tentatives de paiement avec la méthode, la référence ou le téléphone masqué, l'ID de transaction Eupago et le statut, ainsi que les notes du module. Journal facultatif sans clés, e-mails ni numéros de téléphone complets.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte Eupago avec la clé API de votre canal et une clé de Webhook 2.0 (sandbox et production sont deux comptes distincts). Devise du panier : EUR. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).