VibeFox Transbank for PrestaShop

Présentation

VibeFox Transbank Gateway ajoute les paiements Transbank Webpay Plus à PrestaShop pour les boutiques du Chili. À l'étape de paiement, le client choisit Webpay Plus, est redirigé vers le formulaire de paiement Webpay, paie par carte de crédit, de débit ou prépayée, puis revient sur votre boutique. Les données de carte ne transitent jamais par votre site. La commande n'est créée qu'après la confirmation du paiement par Transbank : les paiements annulés ou refusés ne laissent donc aucune commande impayée.

Il convient aux boutiques qui vendent en pesos chiliens (CLP) et disposent d'un code de commerce Webpay Plus standard. Transbank n'a pas de webhook de paiement : le paiement est confirmé de serveur à serveur lorsque le client revient de Webpay. Le module ne gère ni Webpay Plus Mall, ni cartes enregistrées Oneclick, ni abonnements, ni capture différée, ni conversion de devise, et les remboursements effectués dans le portail Transbank ne sont pas importés.

Principales fonctionnalités

Redirection vers Webpay Plus : une transaction Transbank est créée pour le total du panier en pesos entiers, et le client paie sur le formulaire Webpay.

Payée seulement après confirmation de Transbank : au retour du client, le module confirme (commit) la transaction auprès de Transbank. La commande n'est créée que lorsque Transbank approuve le paiement. Si le montant, le buy order ou la session ne correspondent pas à ce que la boutique a envoyé, la commande passe en Transbank payment on hold pour vérification.

Aucun débit pour un panier modifié : si le total du panier a changé après le début du paiement (dans un autre onglet, ou avec un bon de réduction expiré), la transaction n'est pas confirmée : le client n'est donc pas débité et paie le nouveau total.

Confirmée au plus une fois : recharger la page de retour, utiliser le bouton Précédent du navigateur ou deux retours simultanés ne confirment jamais un paiement deux fois et ne créent jamais une seconde commande.

Sûre en cas d'erreur : si l'appel de confirmation échoue, le module demande à Transbank le statut réel de la transaction avant de créer la commande.

Remboursements depuis la page de commande : remboursements totaux et partiels en pesos entiers dans le bloc Transbank Webpay Plus de la commande, toujours dans l'environnement où le paiement a été effectué. Un remboursement total passe la commande en Refunded.

Test sans identifiants : l'environnement d'intégration utilise automatiquement le code de commerce de test public de Transbank.

Bloc de commande et journal : le paiement, toutes les tentatives Webpay du panier et les notes Transbank sur la page de commande. Les erreurs sont toujours journalisées, les détails sur demande, sans données de carte ni clés.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Devise du panier : peso chilien (CLP). Pour les paiements réels, un code de commerce de production Webpay Plus et une API Key Secret fournis par Transbank. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).