Перейти к содержимому
Плагины
Открыть .md
На странице

Как подключить Paymos к HikaShop на Joomla

Установите плагин, проверьте тестовый заказ и настройте оплату криптовалютой в HikaShop.

Начните с заказа в Sandbox. Так вы увидите страницу оплаты глазами покупателя и сможете проверить статус заказа в HikaShop до того, как откроете способ оплаты в магазине.

Что нужно для установки

Плагин работает в Joomla 5.4 или 6.2 с HikaShop 6.8.1 либо более поздним патчем ветки 6.8. Нужны PHP 8.3 или новее с cURL и OpenSSL и сайт, доступный по HTTPS из интернета. Штатные таблицы HikaShop для заказов, истории, товаров, позиций заказа, скидок и пользователей должны использовать InnoDB. В настройках HikaShop выберите created в поле Order created status. Убедитесь, что статусы confirmed и refunded доступны.

Как проверить первый заказ

  1. Скачайте бесплатный ZIP для Joomla. В админке Joomla откройте System → Install → Extensions и загрузите архив. Затем в System → Manage → Plugins включите Payment - Paymos for HikaShop.
  2. В HikaShop откройте System → Payment methods. Создайте и сохраните способ оплаты. Нажмите Connect Paymos и выберите проект.
  3. Выберите Sandbox, сохраните настройки и опубликуйте тестовый способ оплаты там, где будете проверять магазин. Оформите заказ и пройдите оплату. В Sandbox реальные средства не переводятся. Когда будете готовы принимать платежи, выберите Live и сохраните настройки.

Joomla хранит ключи в зашифрованном виде и использует для этого секрет своей установки. Если основной URL сайта изменится, подключите проект заново.

Когда HikaShop подтверждает заказ

Покупатель платит на странице Paymos, где используются сумма и валюта из сохранённого заказа. Плагин проверяет подпись уведомления и сверяет его с данными платежа из API и заказом. Если платёж относится к этому заказу и поступила вся сумма или больше, заказ один раз переходит в confirmed. При недоплате он остаётся неподтверждённым. Поздний платёж или расхождение в данных проверьте отдельно.

Если уведомление не дошло, нажмите Check payment в заказе. Для этой проверки cron не нужен. Возврат покупателя на сайт сам по себе не подтверждает оплату. Чтобы вернуть его на штатную страницу HikaShop, в поле Success URL проекта укажите полный адрес Joomla с путём /index.php?option=com_hikashop&ctrl=checkout&task=after_end. Эта настройка действует на весь проект.

Как проверить возврат

Если возвраты включены и платёж подходит, из заказа можно вернуть всю сумму или только переплату. API рассчитывает сумму и определяет получателя по исходному отправителю. Пока возврат в работе, статус заказа не меняется. После полного возврата HikaShop выставляет refunded. При возврате переплаты заказ сохраняет текущий статус, а запись о возврате появляется в истории. Чтобы обновить сведения о начатом возврате, нажмите Check refund. Может взиматься комиссия сети. Правила возвратов.

Дождитесь завершения открытых операций, прежде чем отключать или удалять плагин. Disconnect и удаление очищают локальные ключи, история заказов сохраняется.

Лицензия

Плагин распространяется по GPL-2.0-or-later, SDK — по MIT.