VibeFox Vindi for PrestaShop

Обзор

VibeFox Vindi Gateway подключает PrestaShop к API Vindi для магазинов Бразилии, которые продают в бразильских реалах (BRL). Покупатели платят картой на странице счёта Vindi или через boleto, PIX и BolePix (boleto + PIX). Данные карты никогда не попадают на ваш сайт. Для boleto и PIX заказ остаётся в статусе Awaiting Vindi payment, а покупатель получает ссылку на boleto и коды PIX на странице подтверждения заказа, в личном кабинете и в письме.

Модуль подходит бразильским магазинам, у которых уже есть учётная запись Vindi и которым нужны разовые платежи без собственной формы карты. Для платежей картой заказ создаётся только после подтверждения оплаты Vindi, поэтому брошенные платежи не оставляют неоплаченных заказов. Модуль принимает только единоразовые платежи в один платёж. В нём нет подписок и регулярных списаний, сохранённых карт, рассрочки (parcelamento) и формы карты на вашем сайте, а платежи boleto нельзя вернуть.

Основные возможности

Четыре способа оплаты: банковская карта, boleto, PIX и BolePix. Вы выбираете, какие из них предлагать при оформлении заказа.

Поле CPF / CNPJ: запрашивается при оформлении заказа для boleto и PIX и проверяется по контрольным цифрам. По возможности оно заполняется данными из адреса покупателя.

Оплата только после подтверждения Vindi: платёж принимается только после того, как модуль прочитал счёт через API Vindi и проверил валюту, код корзины, клиента Vindi и точную сумму. При расхождении заказ отправляется на удержание с примечанием.

Защищённый вебхук: URL вебхука содержит секретный токен, и каждое уведомление лишь запускает повторную проверку через API Vindi.

Без двойных оплат: новая попытка использует уже созданный ожидающий счёт Vindi или сначала отменяет его. Когда неоплаченный заказ отменяется в магазине, его счёт Vindi тоже отменяется.

Рабочая среда и sandbox: отдельные API-ключи. Каждый платёж запоминает, где был создан его счёт, поэтому проверки и возвраты всегда выполняются в той же среде.

Возвраты со страницы заказа: полные и частичные возвраты платежей картой и PIX в блоке Vindi payment, не более суммы, которую Vindi фактически списал. Полный возврат переводит заказ в статус Refunded.

Блок Vindi на странице заказа: счета по корзине, история возвратов и примечания модуля.

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее, валюта магазина: бразильский реал (BRL). Учётная запись Vindi с API-ключом (и тестовая учётная запись Vindi sandbox для проверки). Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).