VibeFox HyperPay for PrestaShop

Обзор

VibeFox HyperPay Payment Gateway добавляет в PrestaShop оплату картами через виджет COPYandPAY от HyperPay. После подтверждения заказа в оформлении покупатель видит платёжный виджет HyperPay на странице оплаты вашего магазина и оплачивает там картами VISA, Mastercard, mada, American Express, STC Pay или Apple Pay. Данные карты вводятся только в виджете HyperPay и никогда не попадают на ваш сервер. Заказ создаётся только после того, как HyperPay подтвердит оплату, поэтому брошенные или отклонённые платежи не оставляют неоплаченных заказов.

Модуль подходит магазинам в Саудовской Аравии, ОАЭ, Иордании, Бахрейне, Омане, Катаре, Египте и на других рынках MENA с учётной записью мерчанта HyperPay. Модуль не поддерживает возвраты и отмены из PrestaShop (выполняйте их в панели управления HyperPay), сохранённые карты, подписки, проверку домена для Apple Pay, отдельные Entity ID для каждого бренда, а также методы «купи сейчас, плати потом» (buy now, pay later).

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

Виджет HyperPay: виджет COPYandPAY на странице оплаты, подключается с Subresource Integrity, на языке покупателя, если HyperPay поддерживает этот язык. Вы выбираете, какие бренды он показывает.

Оплата засчитывается только после подтверждения HyperPay: по серверному запросу статуса, когда покупатель возвращается в магазин, и по зашифрованным вебхукам (AES-256-GCM), если браузер закрыт. Один только адрес возврата никогда не создаёт оплаченный заказ.

Проверка по корзине: платёж должен принадлежать одной из платёжных сессий HyperPay, созданных для этой корзины, а сумма и валюта должны совпадать. При несовпадении заказ переводится в статус HyperPay payment on hold с примечанием.

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

Списание или предавторизация: списание сразу либо резервирование суммы с последующим списанием действием Capture payment в блоке HyperPay заказа.

Тестовый и рабочий режим: отдельные Access Token, Entity ID и ключ вебхука для каждого режима. Проверки статуса, списания и вебхуки всегда используют тот режим, в котором была создана платёжная сессия.

Понятные сообщения: отклонённые, незавершённые или ещё не подтверждённые платежи объясняются покупателю в оформлении заказа, а корзина сохраняется для повторной попытки.

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

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее с расширением OpenSSL. Учётная запись мерчанта HyperPay с Access Token и Entity ID (тестовые и рабочие) и платёжный вебхук с ключом расшифровки. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).