VibeFox Kushki for PrestaShop

Overview

VibeFox Kushki Payment adds card payments with Kushki to PrestaShop for shops in Ecuador and Colombia. At the payment step the customer enters the card in the Kushki hosted card form, which is shown inside your checkout page but served by Kushki. The form returns a one-time token, and your shop charges it on the server through the Kushki API. Card numbers never reach your site. The order is created only after Kushki approves the charge, so declined or abandoned payments leave no unpaid orders.

It suits shops that charge in USD or COP and want a card form on their own checkout page without handling card data. The module takes one-step card payments only. It has no partial refunds, saved cards, subscriptions, cash or bank transfer (PSE) payments, debit-card redirect payments or separate authorize and capture.

Key features

Kushki hosted card form: the card form of Kushki on the payment step of the PrestaShop checkout. Installments (diferido) chosen in the form are passed to the charge.

Paid only when Kushki confirms: the order is created only after Kushki approves the charge with a ticket number. A different amount or currency reported by Kushki puts the order in Kushki payment on hold with a note.

Tax as IVA: the amount and currency always come from the cart. The cart tax is reported to Kushki as IVA, untaxed lines separately.

Signed webhooks: optional webhooks create the order for a payment whose API response was lost and add notes for voids and refunds made in the Kushki Console. Notifications without a valid signature are rejected.

No double charges: a per-cart lock stops double charges on a double click or a second tab, and repeated webhooks never create a second order.

Test and live modes: separate Merchant IDs and webhook signatures for each mode. Refunds always go to the mode the payment was made in.

Full refunds from the order page: the Kushki payment block of the order refunds the whole amount Kushki charged. The order is set to Refunded.

Kushki block on the order page: ticket number, reference, environment, refund history and the Kushki notes of the order. Log without Merchant IDs, card tokens or customer e-mails.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. A cart currency of USD or COP. A Kushki account with test and live Public and Private Merchant IDs, and HTTPS for live payments. A VibeFox license key from vibefox.net (one key per domain).