VibeFox ifthenpay for PrestaShop

Présentation

VibeFox ifthenpay Gateway ajoute à PrestaShop les paiements ifthenpay pour les clients portugais. Une seule méthode est proposée au moment du paiement, choisie dans les réglages : références Multibanco, MB WAY ou carte bancaire. Avec Multibanco, le client reçoit une entité, une référence et le montant à payer à un distributeur automatique ou dans sa banque en ligne ; avec MB WAY, le client approuve une demande dans l'application MB WAY ; avec la carte bancaire, le client paie sur la page sécurisée de carte d'ifthenpay, et la commande n'est créée qu'après confirmation du paiement.

Il convient aux boutiques situées au Portugal qui vendent en euros et disposent d'un compte ifthenpay avec une clé pour la méthode choisie. Le module ne propose qu'une méthode ifthenpay par installation. Il ne gère pas les remboursements depuis PrestaShop, ni Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX ou Pay-by-Link, ni les abonnements ou cartes enregistrées, ni l'expiration automatique des références Multibanco impayées, ni l'interrogation du statut de paiement.

Principales fonctionnalités

Multibanco: une référence dynamique est créée pour le total du panier. La commande attend dans Awaiting ifthenpay payment, et la référence s'affiche sur la page de confirmation de commande et dans l'e-mail de confirmation de commande.

MB WAY: le client saisit le numéro de mobile lié à MB WAY (numéros portugais ou format international 351#912345678) et approuve le paiement dans l'application.

Carte bancaire: paiement sur la page de carte d'ifthenpay, confirmé par le retour signé (HMAC-SHA256 avec votre clé Credit Card) ou par le callback. Aucune commande n'existe avant le paiement.

Callbacks protégés: les callbacks ne sont acceptés qu'avec votre clé anti-phishing. Une requête falsifiée ne modifie jamais une commande.

Contrôle du montant: le montant payé est vérifié au centime près par rapport au total de la commande. Un montant différent place la commande dans ifthenpay payment on hold, avec une note.

Pas de double traitement: les callbacks et retours répétés ne changent rien : un paiement, une note. Les commandes annulées qui sont payées sont mises en attente de vérification, et les commandes remboursées ne sont jamais rouvertes.

Mode test et statut de commande: la carte bancaire et Multibanco utilisent le sandbox d'ifthenpay en mode test. Après le paiement, la commande passe à Payment accepted ou à Delivered.

Bloc ifthenpay sur la page de commande: les tentatives de paiement avec référence ou identifiant de demande, un avertissement pour les commandes en attente et les notes du module. Le journal ne contient ni clés ni numéros de téléphone.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte ifthenpay avec la clé de la méthode choisie et le callback activé par ifthenpay. Devise du panier : euro (EUR). Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).