VibeFox Vindi for PrestaShop

Overview

VibeFox Vindi Gateway connects PrestaShop to the Vindi API for shops in Brazil that sell in Brazilian Real (BRL). Customers pay by credit card on the Vindi bill page, or by boleto, PIX or BolePix (boleto + PIX). Card data never touches your site. For boleto and PIX the order waits in Awaiting Vindi payment, and the customer gets the boleto link and the PIX codes on the confirmation page, in the account and in the e-mail.

It suits Brazilian shops that already have a Vindi account and want one-off payments without building a card form. For card payments the order is created only after Vindi confirms the payment, so abandoned payments leave no unpaid orders. The module takes single payments in one installment only. It has no subscriptions or recurring billing, no saved cards, no installments (parcelamento) and no card form on your site, and it cannot refund boleto payments.

Key features

Four payment methods: credit card, boleto, PIX and BolePix. You choose which ones are offered at checkout.

CPF / CNPJ field: asked at checkout for boleto and PIX and checked by its check digits. It is prefilled from the customer's address when possible.

Paid only when Vindi confirms: the payment is accepted only after the module has read the bill back from the Vindi API and checked the currency, the cart code, the Vindi customer and the exact amount. A mismatch puts the order on hold with a note.

Protected webhook: the webhook URL contains a secret token, and every notification only triggers a fresh check through the Vindi API.

No double payments: a new attempt reuses the pending Vindi bill or cancels it first. When an unpaid order is cancelled in the shop, its Vindi bill is cancelled too.

Live and sandbox: separate API keys. Each payment remembers where its bill was created, so checks and refunds always use that environment.

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

Vindi block on the order page: the bills of the cart, the refund history and the module's notes.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later, shop currency Brazilian Real (BRL). A Vindi account with an API key (and a Vindi sandbox account for testing). A VibeFox license key from vibefox.net (one key per domain).