VibeFox Vindi for OpenCart

Обзор

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

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

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

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

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

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

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

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

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

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

Условия OpenCart: гео-зона, минимальная сумма заказа, порядок сортировки и собственные статусы заказов. Журнал не содержит ключей и данных покупателей.

Требования

OpenCart 3.0.x (проверено на 3.0.5.0) или OpenCart 4.0.2 и новее (проверено на 4.1.0.3), PHP 8.0 или новее. Один архив содержит пакеты для обеих версий. В магазине валюта бразильский реал (BRL). Аккаунт Vindi с ключом API (и тестовый аккаунт песочницы Vindi для проверок). Лицензионный ключ VibeFox с vibefox.net (один ключ на домен).