VibeFox Hubtel for OpenCart

Обзор

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

Расширение подходит магазинам в Гане, которые продают в ганских седи (GHS) и имеют бизнес-аккаунт Hubtel. Hubtel должен добавить IP-адрес вашего веб-сервера в белый список для своего API проверки статуса транзакций. У Hubtel нет публичной тестовой среды, поэтому все платежи настоящие. В расширении нет возвратов из OpenCart, подписок, сохранённых карт и выбора платёжного канала внутри магазина.

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

Размещённая страница оплаты Hubtel: оплата через мобильные деньги и картой на странице Hubtel. Канал покупатель выбирает там.

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

Проверка суммы: если сумма отличается, заказ переходит в выбранный вами статус проверки с примечанием.

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

Потерянные callback-уведомления учтены: возврат покупателя проверяет платёж, URL cron запускает фоновые повторные проверки, а на странице заказа можно нажать Check Hubtel payment status.

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

Вкладка Hubtel на странице заказа: все попытки оплаты заказа с их статусом и транзакцией в Hubtel, а также примечания Hubtel.

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

Требования

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