VibeFox KOMOJU for PrestaShop

Обзор

VibeFox KOMOJU Payment добавляет платежи KOMOJU в PrestaShop. На этапе оплаты покупатель выбирает KOMOJU, переходит на платёжную страницу KOMOJU и выбирает там способ: кредитная или дебетовая карта, оплата в магазине у дома (konbini), PayPay, банковский перевод и другие местные способы — в зависимости от вашей учётной записи KOMOJU и валюты корзины. Данные карты никогда не попадают на ваш сайт. Заказ создаётся только после подтверждения платежа KOMOJU, поэтому незавершённые платежи не оставляют неоплаченных заказов.

Модуль подходит магазинам Японии, Азии и Европы, которым нужны местные способы оплаты с учётной записью мерчанта KOMOJU. Модуль принимает только разовые платежи. В нём нет формы карты на вашем сайте, сохранённых карт, подписок и ручного списания в PrestaShop.

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

Платёжная страница KOMOJU: платёжная сессия создаётся на сумму корзины в валюте корзины. JPY, KRW и VND передаются без десятичных знаков. Способ доступен только для 20 валют, поддерживаемых KOMOJU.

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

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

Konbini и банковский перевод: заказ ожидает оплаты в статусе Awaiting KOMOJU payment, когда выдана платёжная квитанция, и переходит в Payment accepted, когда покупатель оплачивает. Истёкшая квитанция отменяет заказ.

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

Тестовая и рабочая среда: отдельные секретные ключи и токены вебхуков. Каждый платёж запоминает свою среду, поэтому возвраты и проверки статуса используют нужный ключ после переключения.

Возвраты с экрана заказа: полные и частичные возвраты в блоке KOMOJU payment, до суммы, которую KOMOJU фактически списал. Полный возврат переводит заказ в Refunded. Возвраты, сделанные в панели KOMOJU, записываются автоматически.

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

Требования

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