VibeFox Culqi for PrestaShop

Overview

VibeFox Culqi Payment adds Culqi, the Peruvian payment service, to PrestaShop. At the payment step the customer pays by card or Yape in the Culqi Checkout popup and never leaves your shop. Card data is entered in the Culqi window and never reaches your server. Your server then creates the charge with the Culqi Charges API, and the order is created only after Culqi confirms the charge, so declined or abandoned payments leave no unpaid orders.

It suits shops in Peru that sell in Peruvian Sol (PEN) or US Dollar (USD) and have a Culqi account. The module takes one-time payments by card and Yape only. It has no PagoEfectivo or CIP codes, bank app, agents, wallets or Cuotéalo, no saved cards, subscriptions or installments, no Culqi webhooks and no separate authorize and capture.

Key features

Culqi Checkout popup: cards (Visa, Mastercard, American Express, Diners Club) and, optionally, Yape in a window on your checkout page.

3-D Secure: when the bank requires it, Culqi 3-D Secure opens automatically and the charge is completed after the authentication.

Paid only when Culqi confirms: the order is created after Culqi answers with a successful charge, and the charged amount and currency are compared with the cart. A mismatch puts the order in Culqi payment on hold with a note.

No double charges: a cart that already has an order or a Culqi charge is never charged again, even after a double click, a second tab or a retry.

Clear declines: the customer sees the message from Culqi and can try another card. The decline code is written to the module log.

Test and live modes: separate public and secret keys for each mode. Refunds always use the keys of the mode the payment was made in.

Refunds from the order page: full and partial refunds in the Culqi payment block of the order, up to the amount Culqi actually charged. A full refund sets the order to Refunded.

Safe settings and log: keys with a wrong prefix are refused, saved secret keys are never shown again. Optional log without keys, card data or customer details.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. A shop currency PEN or USD. A Culqi account with public and secret API keys. A VibeFox license key from vibefox.net (one key per domain).