VibeFox ePay.bg for PrestaShop

Обзор

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

Модуль подходит магазинам, которые продают в болгарских левах (BGN), евро (EUR) или долларах США (USD) и имеют мерчант-аккаунт ePay.bg. Модуль принимает только разовые платежи. В нём нет возвратов из PrestaShop (возвраты выполняются в мерчант-панели ePay.bg), нет сохранённых карт, подписок и регулярных платежей, нет кодов оплаты наличными EasyPay и B-Pay.

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

Платёжная страница ePay.bg: на ePay.bg отправляется подписанный платёжный запрос на сумму корзины в валюте корзины (BGN, EUR или USD), и покупатель оплачивает там картой или с помощью учётной записи ePay.bg.

Заказ создаётся только после подтверждения ePay.bg: уведомления принимаются только с действительной контрольной суммой HMAC-SHA1 и только для счёта, который выставил модуль. Возврат покупателя в магазин никогда не создаёт и не оплачивает заказ.

Проверка суммы, валюты и режима: подписанные сумма, валюта и режим (тестовый или рабочий) сохраняются и проверяются снова при поступлении платежа. При расхождении заказ переходит в статус ePay.bg payment on hold с примечанием.

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

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

Тестовый и рабочий режим: отдельные учётные данные для demo.epay.bg и www.epay.bg. Платежи, начатые до смены режима, всё равно подтверждаются.

Ваши настройки: префикс счёта, срок действия платёжного запроса, язык страницы ePay.bg (английский или болгарский) и статус заказа после оплаты.

Блок ePay.bg на странице заказа: счёт, запрошенная сумма, STAN, код BORICA и примечания модуля. Платёжные запросы и уведомления записываются в необязательный журнал без секретных ключей и данных карт; ошибки записываются всегда.

Требования

PrestaShop от 8.0 до 9.x, PHP 8.0 или новее. Валюта корзины — BGN, EUR или USD. Мерчант-аккаунт ePay.bg с номером клиента (MIN) и секретным ключом, а также URL уведомлений, указанный в вашем мерчант-профиле ePay.bg. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).