Подключение рекуррентных платежей через ЮKassa

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

На платформе GetCourse реализованы повторяющиеся платежи через Платежный модуль GetCourse Pay и платежные системы CloudPayments, Stripe или ЮKassa (рассмотрим ЮKassa в этой статье).

Содержание:

1. Как подключить повторяющиеся платежи.
2. Как протестировать работу повторяющихся платежей.
3. Как пользователь узнает, что его карта будет привязана.

Активация рекуррентных платежей через ЮKassa зависит от типа настройки интеграции с платежной системой:

1. Новый метод — через API-протокол.
2. Старый метод — через HTTP-протокол.

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

При обращении предоставьте скриншот, демонстрирующий возможность пользователя отменить автоплатежи. Для создания скриншота обратитесь в службу поддержки Getcourse.

Важно: генерация сертификата не требуется.

После получения одобрения активации рекуррентных платежей со стороны ЮKassa перейдите непосредственно к пункту 5 — активации ребиллинга в вашем аккаунте.

Если в вашем аккаунте настроен прием платежей через ЮKassa по протоколу HTTP, для активации рекуррентных платежей выполните следующие шаги:

1. Подготовьте запрос на выдачу дополнительного сертификата.
2. Заполните техническую анкету вашей организации.
3. Отправьте заявку на выдачу сертификата менеджеру ЮKassa.
4. Проведите тестовый платеж (для тестового режима).
5. Активируйте функцию ребиллинга в настройках вашего аккаунта.

1. Для создания файла запроса на сертификат в формате .csr следуйте инструкции от ЮKassa и используйте соответствующую статью.

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

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

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

2. Заполните предоставленную менеджером ЮKassa Техническую анкету организации.

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

95.213.153.162 

95.213.153.163 

95.213.153.164 

95.213.153.165 

95.213.244.211

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

В случае запроса от ЮKassa на предоставление скриншота возможности отказа от автоплатежей, прикрепите скриншот, подтверждающий наличие дополнительного блока "Привязанные карты" в профиле клиента. В этом блоке пользователь может отключить автоплатеж или удалить привязанную карту.

Убедитесь, что скриншот содержит адресную строку браузера, которая соответствует адресу, указанному в заявке на подключение. Для этого включите ребиллинг в настройках ЮKassa (инструкция представлена ниже), проведите тестовый платеж с карты, а затем сделайте скриншот вкладки "Мой профиль" с адресной строкой.

3. После обработки заявки менеджер ЮKassa пришлет вам сертификат для проведения тестового платежа.

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

После получения сертификата перейдите в раздел "Профиль" → "Настройки аккаунта" → вкладка "Интеграция" → "Перейти к ручной настройке интеграций онлайн-касс и платежных агрегаторов".

Откройте настройки ЮKassa и заполните следующие поля:

1. «Сертификат»: в этом поле вставьте содержимое сертификата, который был прислан ЮKassa. Начинается он со строки "-----BEGIN CERTIFICATE-----".

2. «Приватный ключ»: в это поле вставьте содержимое файла private.key, который был создан при формировании запроса на сертификат (см. пункт 1).

3. «Пароль сертификата»: в это поле введите пароль, который вы установили для приватного ключа и для электронной подписи.

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

4. После заполнения указанных полей выполните тестовый платеж.

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

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

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

5. После успешного подключения боевых платежей в настройках интеграции ЮKassa переведите опцию "Ребиллинг" в положение "Включено".

1. Создайте заказ на продукт для вашего тестового пользователя.

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

3. Настройте продукт и создайте упрощенный процесс в соответствии с инструкцией.

4. Создайте тестовую задачу по покупке пользователя из предыдущего шага, убедившись, что опция "Выполнять действия по-настоящему" отмечена.

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

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

При необходимости пользователь может отказаться от автоматического продления или удалить карту в своем профиле.