Инструкция для настройки плагина ЮKassa для Shopaholic

Главная . Настройки плагина ЮKassa для Shopaholic

Авторизуйтесь на сайте OctoberCMS, и приобретите плагин в маркетплейсе по ссылке: https://octobercms.com/plugin/bizmark-yandexkassashopaholic после приобретения, привяжите проект на котором вы хотите использовать плагин.

Конфигурация

Чтобы использовать модуль, нужно подключить магазин к ЮKassa и получить параметры shopId и Секретный ключ.

shopId появится в личном кабинете Кассы сам, когда вы подключитесь к сервису,
секретный ключ нужно самостоятельно выпустить и активировать в личном кабинете ЮKassa по инструкции.

В личном кабинете ЮKassa откройте в сайдбаре слева "Настройки магазина". Единственное что необходимо заполнить – это "URL для уведомлений", таком формате:

https://mywebsite.com/shopaholic/yookassa/

(где mywebsite.com подставьте свой домен).

Сразу под "URL для уведомлений" поставьте галочки у следующих событий:

payment.succeeded
payment.waiting_for_capture
payment.canceled

Откройте панель управления своего сайта, перейдите в настройки и нажмите на "Методы оплаты":

2. Из личного кабинета ЮKassa скопируйте shopId и «Секретный ключ».

Вставьте Секретный ключ в поле Секретный ключ и shopId в поле Идентификатор магазина.

Основная настройка завершена.

Дополнительная настройка 54-ФЗ

Купите или возьмите в аренду онлайн-кассу одного из партнеров ЮKassa.
Заключите договор с оператором фискальных данных (ОФД).
Получите квалифицированную электронную подпись (КЭП).
Зарегистрируйте онлайн-кассу на сайте налоговой (в личном кабинете юрлица).
Заполните настройки для работы по 54-ФЗ в личном кабинете ЮKassa.
Включите в настройках метода оплаты "54-ФЗ чек", и в выпадающих списках под переключателем укажите "Признак способа расчета" и "Признак предмета расчета".

Обработка события возврата пользователя
после успешной или неуспешной оплаты

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

Пример выполнения редиректа на страницу "Спасибо за оплату".

$obEvent->listen(BizMark\YooKassaShopaholic\Classes\Helper\PaymentGateway::EVENT_RETURN_URL, function ($obOrder) {
    return Page::url('order-complete-page', ['slug' => $obOrder->secret_key]);
});