VibeFox Hubtel for PrestaShop

Обзор

VibeFox Hubtel Pay Gateway добавляет в PrestaShop платежи через Hubtel в Гане. На этапе оплаты покупатель выбирает Hubtel, переходит на защищённую страницу Hubtel Online Checkout, оплачивает через MTN MoMo, Telecel Cash, AirtelTigo Money, картой Visa или Mastercard либо GhQR и возвращается в ваш магазин. Заказ создаётся только после подтверждения платежа Hubtel, поэтому брошенные платежи не оставляют неоплаченных заказов.

Модуль подходит магазинам в Гане, которые продают в ганских седи (GHS) и имеют бизнес-аккаунт Hubtel. Hubtel должен внести IP-адрес вашего веб-сервера в белый список для Transaction Status API, а у Hubtel нет общедоступной тестовой среды, поэтому все платежи реальные. Модуль не поддерживает возвраты из PrestaShop, подписки, сохранённые карты и выбор платёжного канала внутри магазина.

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

Оплата на странице Hubtel: платежи через Mobile Money и банковскими картами на странице Hubtel. Покупатель выбирает канал оплаты там.

Оплата только после подтверждения Hubtel: колбэки Hubtel не подписаны, поэтому модуль никогда им не доверяет. Он запрашивает аутентифицированный Hubtel Transaction Status API и создаёт заказ как оплаченный, только когда Hubtel сообщает статус Paid на точную сумму корзины в GHS.

Проверка суммы: при несовпадении суммы заказ переводится в статус Hubtel payment on hold с примечанием для менеджера магазина.

Ничего не нужно настраивать в Hubtel: URL колбэка передаётся с каждым платежом.

Защита от потерянных колбэков: возврат покупателя проверяет платёж, cron-URL запускает фоновые проверки, а менеджер магазина может нажать Check Hubtel payment status на странице заказа.

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

Отмена в Hubtel: покупатель возвращается к оформлению заказа с сообщением и может повторить попытку. Корзина сохраняется.

Блок Hubtel на странице заказа: все попытки оплаты заказа с их статусом и транзакцией в Hubtel, а также примечания Hubtel. Необязательный журнал без API-ключей и данных покупателей.

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее с расширением cURL. Бизнес-аккаунт Hubtel с API ID, API Key и номером торгового счёта (POS Sales ID), а также IP-адрес вашего сервера, внесённый Hubtel в белый список. Валюта магазина — ганский седи (GHS). Для фоновых проверок рекомендуется cron на сервере. Лицензионный ключ VibeFox с vibefox.net (один ключ на домен).