Подключение рекуррентных платежей через Яндекс.Кассу

Рекуррентные платежи, также известные как платежи по подписке или «автоплатёж» — возможность выполнять регулярные списания денег с банковской карты покупателя без повторного ввода реквизитов карты и без участия плательщика для инициации очередного платежа.

На GetCourse возможность проводить рекуррентные платежи реализована через платёжные системы CloudPayments или Яндекс.Кассу (о ней и пойдёт речь в этой статье).

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

1. Для того, чтобы составить файл запроса на сертификат в формате .csr, воспользуйтесь инструкцией от Яндекса и нашей статьёй.

В процессе формирования запроса у вас будет создано два файла: request.csr (именно его нужно приложить к заявке) и private.key (понадобится в дальнейшем). Также обратите внимание, что пароль, который вы указываете для приватного ключа, и пароль для электронной подписи должны совпадать — сохраните его себе, чтобы не забыть.

В инструкции от Яндекса в пункте 4 указано, как заполнять заявку на сертификат. За помощью в заполнении полей вы можете обратиться к вашему менеджеру платежной системы.

2. Заполните Техническую анкету Организации, которую пришлет вам менеджер Яндекс.Кассы:

• Во втором и третьем пункте укажите наши IP для рекуррентных платежей (и для тестового, и для рабочего режима):

  95.213.153.162

  95.213.153.163

  95.213.153.164

  95.213.153.165

  95.213.244.211

• Поле URL для уведомления о возврате (errorDepositionNotificationUrl) — оставьте пустым.

• В Яндекс.Кассе от вас также могут подтребовать показать возможность отказа от автоплатежей. В ответ вы можете приложить скриншот, подтверждающий, что профиле клиента появляется дополнительный блок — Привязанные карты, в котором при желании пользователь может убрать галочки с автоплатежа/удалить привязанную карту:

• Обратите внимание, что сотрудники Яндекс.Кассы запрашивают скриншот с адресной строкой (чтобы адрес в браузере соответствовал тому, который указан в заявке на подключение).  Необходимо включить ребиллинг в настройках Яндекс кассы (инструкция ниже), оплатить тестовый платеж с карты, и затем сделать скриншот вкладки «Мой профиль» с адресной строкой:

3. После обработки вашей заявки менеджер Яндекс.Кассы пришлет вам сертификат для проведения тестового платежа (уточните у менеджера, подключен ли вам тестовый режим или сразу боевой!).

Сертификат можно открыть с помощью блокнота (правой кнопкой мыши «Открыть с помощью...»), чтобы скопировать его содержание:

Перейдите в раздел «Настройки аккаунта» — вкладка «Интеграция» — настройки Яндекс.Кассы и заполните следующие поля:

• «Сертификат» — в это поле вносится сертификат, присланный Яндекс.Кассой. Начинается со строчки -----BEGIN CERTIFICATE-----
• «Приватный ключ» — в это поле вносится содержимое файла private.key, который был создан при формировании запроса на сертификат (см. п.1). Для того, чтобы скопировать содержимое файла, нужно открыть его в блокноте.
• «Пароль сертификата» — в это поле вносится пароль, который вы задавали для приватного ключа и для электронной подписи.

4. После заполнения данных полей необходимо провести тестовый платеж.

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

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

Если все пройдет успешно, со стороны Яндекс.Кассы вам будет подключен боевой режим платежей.

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

5. После подключения боевых платежей в настройках интеграции Яндекс.Кассы вам необходимо будет проставить Ребиллинг «Включено»:

1. Создайте своему тестовому пользователю заказ на продукт, который можно продлевать автоматически.

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

3. Создайте данному пользователю новый заказ с тем же самым продуктом и по кнопке «Действия» в карточке заказа выберите пункт «Оплатить автоматически»:

Если все прошло успешно, то можно переходить к настройке процесса для автоматических списаний.

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

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

После того, как карта пользователя будет привязана к его аккаунту, при оплате заказа у него появляется возможность оплатить банковской картой в один клик:

Администраторы аккаунта могут удалить данные банковской карты пользователя. Для этого нужно зайти в карточку пользователя и нажать на значок корзины:

Вы можете создать страницу для пользователей с информацией о том, как привязать и отвязать карту, а также дать возможность клиентам самостоятельно удалить свою карту, привязанную к их профилю. Пример такой страницы вы можете увидеть по ссылке.