# Как подключить 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](https://github.com/Paymos-labs/hikashop/releases/latest). В админке 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**. Может взиматься комиссия сети. [Правила возвратов](/ru/docs/support/refunds.md).

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

## Лицензия

Плагин распространяется по [GPL-2.0-or-later](https://github.com/Paymos-labs/hikashop/blob/main/LICENSE), SDK — по MIT.
