VibeFox Yoco for OpenCart

Présentation

VibeFox Yoco Pay Gateway ajoute à OpenCart 3 et OpenCart 4, via l'API Checkout de Yoco, les paiements par carte et Instant EFT en rands sud-africains (ZAR). À la dernière étape de la commande, le client clique sur Confirm Order, est redirigé vers la page de paiement hébergée par Yoco, paie sur cette page et revient dans votre boutique. Les données de carte ne transitent jamais par votre site. OpenCart crée la commande avant le paiement, mais la commande n'obtient un statut qu'une fois que Yoco a confirmé le paiement ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques sud-africaines qui vendent en ZAR et disposent d'un compte Yoco avec paiements en ligne. L'extension ne prend en charge que les paiements uniques. Elle n'a ni cartes enregistrées, ni abonnements, ni formulaire de carte sur le site, ni autorisation et capture séparées, et elle ne fonctionne qu'en ZAR, avec un montant minimum de commande de R2.00.

Principales fonctionnalités

Paiement hébergé Yoco : un checkout Yoco est créé pour le total de la commande, en centimes. Une requête répétée après un double clic ou un délai d'attente reçoit le même checkout, et non un second.

Payée uniquement lorsque Yoco confirme : l'extension demande à Yoco le statut du checkout lorsque le client revient et lorsqu'un webhook signé arrive. La commande n'obtient son statut que lorsque Yoco indique que le checkout est terminé, puis OpenCart envoie ses e-mails de commande habituels.

Webhooks configurés pour vous : lorsque vous enregistrez une clé secrète, l'extension 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 dans un statut de vérification, 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 déjà payé n'est pas débité à nouveau, et un second paiement est signalé dans les notes de la commande.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l'onglet VibeFox Yoco Pay Gateway de la commande, pour le montant débité 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 production : clés secrètes et secrets de webhook distincts pour chaque mode. Une clé dont le préfixe est incorrect n'est pas enregistrée.

Vos propres statuts de commande et conditions OpenCart : choisissez le statut d'une commande payée, d'un paiement en cours de vérification et d'un remboursement total ; zone géographique, montant minimum de commande et ordre d'affichage. Journal avec clés et adresses e-mail masquées.

Prérequis

OpenCart 3.0.x (testé sur 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé sur 4.1.0.3), PHP 8.0 ou ultérieur. Un seul téléchargement contient les paquets pour les deux versions. Une devise rand sud-africain (ZAR) activée dans la boutique. 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).