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

Рекуррентные платежи — схема, при которой донор не просто совершает платеж на вашем сайте, но дает согласие на повторные автоматические списания в будущем. Такие авто-платежи совершаются обычно раз в месяц.

В рамках Яндекс.кассы рекуррентные платежи выполняются с помощью специального протокола — Merchant Web Services (MWS). Чтобы задействовать его на вашем сайте, выполните нижеследующие шаги.

1. Уведомите менеджера в Яндекс.Кассе

По умолчанию при подключении и настройке Яндекс.кассы для сайта MWS не используется (если это не было оговорено вами заранее, на этапе заключения договора с платежным оператором).

Чтобы задействовать MWS, свяжитесь с вашим менеджером на стороне Яндекс.Кассы (по тел. или email) и попросите подключить протокол MWS для вашего сайта — для приема рекуррентных платежей.

2. Создание запроса на сертификат и получение сертификата

В ответ вы получите инструкции по созданию двух важных файлов:

  • закрытого ключа (файл с расширением «key«),
  • запроса на сертификат (файл с расширением «csr«).
    • ВНИМАНИЕ: при создании запроса на сертификат вам необходимо будет указать пароль. Обязательно запомните его — он понадобится ниже.

Файл закрытого ключа (он может называться как угодно — например, your-private.key) необходимо загрузить на ваш сайт (например, с помощью медиабиблиотеки).

Файл запроса на сертификат вы должны переслать менеджеру в Яндекс.Кассу.

Если не будет никаких организационных препятствий, в ответ на это вы получите уже сам сертификат (файл с расширением «cer«). Его необходимо загрузить на ваш сайт (как и в случае с файлом закрытого ключа).

3. Настройки Яндекс.Кассы в Лейке

На этом этапе у вас есть все необходимые параметры для настройки рекуррентных платежей через Яндекс.Кассу.

Откройте админ. раздел вашего сайта, раздел Лейка -> Настройки -> Платёжные системы. В настройках Яндекс.Кассы укажите значения следующих параметров:

  • Путь к SSL-сертификату для приёма рекуррентных платежей: адрес файла сертификата, ранее загруженного на ваш сайт. Адрес должен быть указан относительно папки /wp-content вашего сайта (например, /uploads/leyka/your-certificate-file.cer).
  • Путь к закрытому ключу SSL-сертификата: адрес файла закрытого ключа, ранее загруженного на ваш сайт. Адрес должен быть указан относительно папки /wp-content вашего сайта (например, /uploads/leyka/your-private.key).
  • Пароль для закрытого ключа SSL-сертификата: пароль, который ранее вы указали при создании запроса на сертификат.
  • Галочка «Доступны ежемесячные пожертвования» также должна быть отмечена.

После выполнения этих настроек не забудьте сохранить их значения.

4. Cron-процедура для рекуррентных списаний

На этом этапе сайт уже может создавать рекуррентные подписки (они также называются «инитными» или «начальными» платежами). Однако автоматических ежемесячных списаний по этим подпискам Лейка ещё не выполняет.

Заключительный шаг — создание cron-job на вашем хостинге. Это команда для серверной программы cron, которая обеспечит регулярное и автоматическое выполнение другой команды.

  • Cron-job должен выполняться 1 раз в сутки, лучше всего где-то в промежутке 01:00-06:00 по часовому поясу, на который настроен ваш сайт.
  • Cron-job должен состоять в вызове адреса https://your-website.org/leyka/service/do_recurring/

Проверить работу автоматических списаний можно следующим образом:

  1. Создать новую рекуррентную подписку, сделав пожертвование через Яндекс.Кассу и отметив галочку «ежемесячные списания». Платёж должен быть доведён до статуса «оплачено».
  2. Вызвать в браузере адрес https://your-website.org/leyka/service/do_recurring/. После вызова проверьте состояние пожертвований в админ. разделе Лейки (страница «Пожертвования»).
    • Если всё правильно, вы увидите новое пожертвование с размером, который вы указали ранее при создании рекуррентной подписки. Это новое пожертвование также должно быть в статусе «оплачено».
    • На этом настройка рекуррентных платежей через Лейку будет завершена.