VibeFox Transbank for PrestaShop

Обзор

VibeFox Transbank Gateway добавляет в PrestaShop оплату через Transbank Webpay Plus для магазинов в Чили. На этапе оплаты покупатель выбирает Webpay Plus, переходит на форму оплаты Webpay, оплачивает кредитной, дебетовой или предоплаченной картой и возвращается в ваш магазин. Данные карты никогда не попадают на ваш сайт. Заказ создаётся только после того, как Transbank подтвердит платёж, поэтому отменённые или отклонённые платежи не оставляют неоплаченных заказов.

Модуль подходит магазинам, которые продают в чилийских песо (CLP) и имеют стандартный код торговца Webpay Plus. У Transbank нет платёжного вебхука: оплата подтверждается от сервера к серверу, когда покупатель возвращается из Webpay. В модуле нет Webpay Plus Mall, сохранённых карт Oneclick, подписок, отложенного списания и конвертации валют, а возвраты, сделанные в портале Transbank, не импортируются.

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

Переход на Webpay Plus: создаётся транзакция Transbank на сумму корзины в целых песо, и покупатель платит на форме Webpay.

Оплачено только после подтверждения Transbank: при возврате покупателя модуль подтверждает (commit) транзакцию в Transbank. Заказ создаётся, только если Transbank одобрил платёж. Если сумма, buy order или сессия не совпадают с тем, что отправил магазин, заказ переходит в статус Transbank payment on hold для проверки.

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

Подтверждение не более одного раза: перезагрузка страницы возврата, кнопка «Назад» в браузере или два возврата одновременно никогда не подтверждают платёж дважды и не создают второй заказ.

Безопасность при ошибках: если запрос подтверждения не прошёл, модуль запрашивает у Transbank реальный статус транзакции, прежде чем создавать заказ.

Возвраты со страницы заказа: полные и частичные возвраты в целых песо в блоке Transbank Webpay Plus заказа, всегда в той среде, где был произведён платёж. Полный возврат переводит заказ в статус Refunded.

Тест без учётных данных: тестовая среда автоматически использует публичный тестовый код торговца Transbank.

Блок заказа и журнал: платёж, все попытки Webpay по корзине и заметки Transbank на странице заказа. Ошибки всегда записываются в журнал, подробности по запросу, без данных карт и ключей.

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее. Валюта корзины: чилийское песо (CLP). Для реальных платежей — рабочий код торговца Webpay Plus и API Key Secret от Transbank. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).