VibeFox Culqi for OpenCart

Présentation

VibeFox Culqi Payment ajoute Culqi, le prestataire de paiement péruvien, à OpenCart 3 et OpenCart 4. À la dernière étape du tunnel d’achat, le client clique sur Confirm Order et paie par carte ou Yape dans la fenêtre Culqi Checkout, sans quitter votre boutique. Les données de carte sont saisies dans la fenêtre de Culqi et n’atteignent jamais votre serveur. Votre serveur crée ensuite le débit avec l’API Culqi Charges. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu’après la confirmation du débit par Culqi ; les paiements refusés ou abandonnés restent donc des commandes manquantes.

Elle convient aux boutiques du Pérou qui vendent en sol péruvien (PEN) ou en dollar américain (USD) et disposent d’un compte Culqi. L’extension n’accepte que les paiements uniques par carte et par Yape. Elle ne propose ni application bancaire, ni agents, ni portefeuilles ou Cuotéalo, ni cartes enregistrées, abonnements ou paiements échelonnés, ni webhooks Culqi, ni autorisation et capture séparées.

Principales fonctionnalités

Fenêtre Culqi Checkout : cartes (Visa, Mastercard, American Express, Diners Club) et, en option, Yape dans une fenêtre à l’étape de confirmation de votre tunnel d’achat.

3-D Secure : lorsque la banque l’exige, Culqi 3-D Secure s’ouvre automatiquement et le débit est finalisé après l’authentification.

Payée uniquement lorsque Culqi confirme : le statut de la commande est défini une fois que Culqi a répondu par un débit réussi, et le montant débité ainsi que la devise sont comparés à la commande. En cas d’écart, la commande passe dans un statut de vérification avec une note. OpenCart envoie ensuite ses e-mails habituels de commande.

Aucun double débit : une commande qui a déjà un débit Culqi n’est jamais débitée à nouveau, même après un double clic, un second onglet ou une nouvelle tentative.

Refus clairs : le client voit le message de Culqi et peut essayer une autre carte à la même étape. Une note sur la commande et le journal conservent le code de refus.

Modes test et réel : clés publique et secrète distinctes pour chaque mode. Les remboursements utilisent toujours les clés du mode dans lequel le paiement a été effectué.

Remboursements depuis la page de commande : remboursements totaux et partiels dans l’onglet VibeFox Culqi Payment de la commande, jusqu’au montant effectivement débité par Culqi. Un remboursement total définit le statut Refunded.

Conditions OpenCart et réglages sûrs : zone géographique, montant minimum de commande, ordre de tri et vos propres statuts de commande. Les clés au mauvais préfixe sont refusées, et les clés secrètes enregistrées ne sont plus jamais affichées. Journal optionnel, sans clés, données de carte ni données clients.

Prérequis

OpenCart 3.0.x (testé avec la version 3.0.5.0) ou 4.0.2 et ultérieur (testé avec la version 4.1.0.3), PHP 8.0 ou ultérieur. Un même téléchargement contient les paquets pour les deux versions. Une devise de boutique activée : PEN ou USD. Un compte Culqi avec des clés API publique et secrète. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).