Инструкция по установке платёжного плагина paykeeper

1. Для установки платёжного плагина необходимо произвести следующие действия:

- Скачайте архив плагина и загрузите архив paykeeper-<version>.transport.zip в папку core/packages/ вашего сайта.
- В панели управления перейдите "Приложения - Установщик - Искать пакеты локально - Да".
- В таблице пакетов появится пакет "paykeeper". Нажмите кнопку "Установить".
- Завершите установку.

Также плагин можно установить стандартным способом, используя опцию "Загрузить пакет" и выбрав архив.

2. Необходимо создать новые или настроить существующие 4 страницы:

1) Страница для формы оплаты PayKeeper, куда будет происходить перенаправление со страницы оформления заказа. Вставить в поле "Содержимое ресурса" вызов сниппета:

[[!Paykeeper? action='payment']]

2) Страница для принятия POST-оповещения об успешной оплате от сервера PayKeeper. Вставить в поле "Содержимое ресурса" вызов сниппета:

[[!Paykeeper? action='callback']]

3) Страница с сообщением об успешной оплате. Содержание любое. Эту страницу можно использовать для перенаправления после успешной оплаты.
4) Страница с сообщением об отмене оплаты. Содержание любое. Эту страницу можно использовать для перенаправления в случае отказа от оплаты.

3. Измените параметры сниппета Paykeeper:

PK_PAYMENT_FORM_ID - номер страницы для формы оплаты PayKeeper, созданная на шаге 2.1. Только цифра.
PK_PAYMENT_FORM_URL - платежный адрес вашего сервера PayKeeper. Например, https://имя_вашего_сервера_paykeeper/create/. Если вам сообщили, что ваш сервер с PayKeeper имеет адрес https://mysite.server.paykeeper.ru/, то необходимо указать https://mysite.server.paykeeper.ru/create/.
PK_SECRET_SEED - секретное слово. Вставьте придуманное или сгенерированное секретное слово из раздела настройки личного кабинета вашего сервера с PayKeeper в разделе "Получение информации о платежах".
PK_STATUS_PAID - номер статуса после оплаты. Цифра. По умолчанию 5.
PK_STATUS_PENDING - номер статуса при переходе на оплату. Цифра. По умолчанию 1.
PK_VAT_GOODS - НДС для товаров. Допустимые значения: none, 0, 10, 20, 110 или 120. По умолчанию none, означающее, что НДС не облагается.
PK_VAT_SERVICE - НДС для услуг. Допустимые значения: none, 0, 10, 20, 110 или 120. По умолчанию none, означающее, что НДС не облагается.

4. В шаблоне формы оформления заказа должен быть выпадающий список (select) для выбора метода оплаты. Пример:

<select name="payment">
    <option value="При получении" [[!+fi.payment:FormItIsSelected='При получении']]>При получении</option>
</select>

Добавьте строку <option value="paykeeper">Оплата картами на сайте</option>. Должно выглядеть, например, так:

<select name="payment">
    <option value="paykeeper">Оплата картами на сайте</option>
    <option value="При получении" [[!+fi.payment:FormItIsSelected='При получении']]>При получении</option>
</select>

На странице формы оформления заказа в вызове сниппета FormIt в список используемых хуков необходимо добавить paykeeper перед redirect. Например:

[[!FormIt?
&hooks='spam,shk_fihook,paykeeper,redirect'
&submitVar='order'
&redirectTo='1'
&validate='address:required,fullname:required,email:email:required,phone:required'
&errTpl='<br /><span class="error">[[+error]]</span>'
]]

Теперь после отправки заказа на следующей странице будет появляться страница с формой оплаты PayKeeper.

5. Настройте ваш сервер PayKeeper.
- Необходимо зайти в ваш личный кабинет PayKeeper (обычно адрес имеет вид http://<ваш_сайт>.server.paykeeper.ru/payments/), перейти на страницу настроек и в левом вертикальном меню выбрать категорию настроек "Получение информации о платежах".
- В выпадающем списке "Способ получения уведомления о платежах" выбрать "POST-оповещения".
- В поле ввода "URL, на который будут отправляться POST-запросы" нужно указать полный адрес страницы для принятия оповещения об успешной оплате из шага 2.2.
- В поле ввода "Секретное слово" значение должно быть такое же, что и в параметре PK_SECRET_SEED из шага 3.