VibeFox Yoco for PrestaShop

Présentation

VibeFox Yoco Pay Gateway ajoute à PrestaShop les paiements par carte et Instant EFT en rands sud-africains (ZAR) via l'API Checkout de Yoco. À l'étape de paiement, le client choisit Yoco, est redirigé vers la page de paiement hébergée par Yoco, y règle son achat et revient sur votre boutique. Les données de carte ne transitent jamais par votre site, et les paiements abandonnés ne laissent aucune commande impayée.

Elle convient aux boutiques sud-africaines qui vendent en ZAR et disposent d'un compte Yoco avec paiements en ligne. Le module ne prend que les paiements uniques. Il ne gère ni cartes enregistrées, ni abonnements, ni formulaire de carte sur le site, ni autorisation et capture séparées ; il ne fonctionne qu'en ZAR et impose un montant minimum de commande de R2,00.

Principales fonctionnalités

Page de paiement hébergée par Yoco : un checkout Yoco est créé pour le total du panier, en centimes. Une nouvelle requête après un double clic ou un délai d'attente obtient le même checkout, et non un second.

Payée seulement après confirmation de Yoco : le module demande à Yoco le statut du checkout lorsque le client revient et lorsqu'un webhook signé arrive. La commande n'est créée que lorsque Yoco indique que le checkout est terminé.

Webhooks configurés pour vous : lorsque vous enregistrez une clé secrète, le module enregistre son URL de webhook auprès de Yoco pour ce mode et stocke le secret de signature. Les webhooks sans signature valide sont rejetés.

Contrôle du montant et de la devise : un paiement d'un montant ou d'une devise différents place la commande en Yoco payment on hold, avec une note. Un paiement pour une commande annulée ou remboursée ne la rouvre pas.

Aucun double traitement : un webhook et le retour du client arrivant en même temps sont traités l'un après l'autre. Un panier, une commande, un paiement enregistré.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc Yoco payment de la commande, sur le montant encaissé par Yoco et avec la clé du mode dans lequel le paiement a été effectué. Les remboursements effectués dans le portail Yoco sont enregistrés automatiquement.

Modes test et réel : clés secrètes et secrets de webhook distincts pour chaque mode. Une clé au mauvais préfixe n'est pas enregistrée.

Bloc Yoco sur la page de commande : le paiement, toutes les tentatives de paiement du panier, l'historique des remboursements et les notes du module. Journal avec clés et adresses e-mail masquées.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Devise de la boutique : rand sud-africain (ZAR). Un compte Yoco avec paiements en ligne et ses clés secrètes. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).