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: зворотні виклики (callbacks) 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 (один ключ на домен).