VibeFox Braintree for PrestaShop

Présentation

VibeFox Braintree Gateway ajoute à PrestaShop les paiements par carte de crédit et de débit via Braintree (PayPal). À l'étape de paiement, le client saisit sa carte dans l'interface Braintree Drop-in UI, un formulaire sécurisé fourni par Braintree, directement sur la page de paiement. Le numéro de carte n'atteint jamais votre boutique ; le module ne reçoit qu'un jeton de paiement à usage unique. La commande n'est créée qu'après l'acceptation du paiement par Braintree, de sorte que les cartes refusées ne laissent aucune commande impayée.

Il convient aux boutiques disposant d'un compte marchand Braintree qui souhaitent accepter les paiements par carte sur leur propre page de paiement, avec 3-D Secure 2 pour l'authentification forte du client (SCA) dans l'EEE et au Royaume-Uni. Le module ne prend que les paiements par carte. Il ne gère ni cartes enregistrées, ni abonnements, ni boutons PayPal, Venmo, Apple Pay ou Google Pay, et il n'utilise pas de webhooks Braintree : les litiges et les refus de règlement ne sont pas synchronisés avec PrestaShop.

Principales fonctionnalités

Braintree Drop-in UI: le formulaire de carte s'affiche dans l'option de paiement, sur la page de paiement de PrestaShop, dans la langue de la boutique.

3-D Secure 2: Enabled (les authentifications échouées sont bloquées) ou Required (seuls les paiements avec transfert de responsabilité sont acceptés), avec une vérification côté serveur du jeton de paiement.

Sale or Authorize only: débit immédiat, ou réservation des fonds que vous capturez ou annulez ensuite dans le bloc Braintree de la page de commande.

Commande créée seulement après acceptation par Braintree : le montant et la devise débités sont comparés au panier. Un débit dans une devise ou pour un montant incorrect est annulé automatiquement, et le client n'est pas débité.

Aucun double débit : un verrou par panier et des jetons de paiement à usage unique garantissent qu'un panier n'est jamais débité deux fois. Si la carte a été débitée mais que la commande n'a pas pu être créée, la tentative suivante crée la commande sans nouveau débit.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc Braintree payment, pour le montant et la devise effectivement débités par Braintree. Un remboursement total d'une transaction non encore réglée est effectué sous forme d'annulation. Les remboursements, captures et annulations utilisent l'environnement (sandbox ou production) du paiement.

Compte marchand par devise : facultatif, par exemple EUR=mystore_EUR, USD=mystore_USD. Les devises sans décimale, comme JPY et KRW, sont débitées en montants entiers.

Sandbox et production côte à côte : identifiants distincts pour chaque environnement, lien depuis la commande vers la transaction dans le Braintree Control Panel, et journal sans clés, données de carte ni données clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte Braintree avec le Merchant ID, la clé publique (Public Key) et la clé privée (Private Key) ; 3-D Secure activé pour le compte, sauf si vous le désactivez. Aucun webhook n'est nécessaire. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).