VibeFox Culqi for PrestaShop

Présentation

VibeFox Culqi Payment ajoute à PrestaShop Culqi, le service de paiement péruvien. À l'étape de paiement, le client paie par carte ou par Yape dans la fenêtre contextuelle Culqi Checkout, sans quitter votre boutique. Les données de la carte sont saisies dans la fenêtre Culqi et n'atteignent jamais votre serveur. Votre serveur crée ensuite le débit avec la Culqi Charges API, et la commande n'est créée qu'après la confirmation du débit par Culqi. Les paiements refusés ou abandonnés ne laissent donc aucune commande impayée.

Il convient aux boutiques situées au Pérou qui vendent en sol péruvien (PEN) ou en dollar américain (USD) et disposent d'un compte Culqi. Le module n'accepte que les paiements uniques par carte et par Yape. Il ne gère ni codes PagoEfectivo ou CIP, ni application bancaire, ni agents, ni portefeuilles, ni Cuotéalo, ni cartes enregistrées, ni abonnements ou paiements échelonnés, ni webhooks Culqi, ni autorisation et capture séparées.

Principales fonctionnalités

Fenêtre contextuelle Culqi Checkout : cartes (Visa, Mastercard, American Express, Diners Club) et, en option, Yape dans une fenêtre sur votre page de paiement.

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 après confirmation de Culqi : la commande est créée lorsque Culqi répond par un débit réussi, et le montant et la devise débités sont comparés au panier. En cas d'écart, la commande passe en Culqi payment on hold avec une note.

Aucun double débit : un panier qui possède déjà une commande ou un débit Culqi n'est jamais débité à 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. Le code de refus est consigné dans le journal du module.

Modes test et production : des 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 le bloc Culqi payment de la commande, dans la limite du montant réellement débité par Culqi. Un remboursement total passe la commande en Refunded.

Réglages sûrs et journal : les clés dont le préfixe est incorrect sont refusées, et les clés secrètes enregistrées ne sont plus jamais affichées. Journal facultatif sans clés, données de carte ni données client.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Devise de la boutique : PEN ou USD. Un compte Culqi avec des clés d'API publique et secrète. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).