Автоплатежи с оплатой при первой операции
Обзор возможностей
Сценарий позволяет сохранить платежные данные покупателя и далее использовать их для повторных автоматических платежей.
Для сохранения данных покупатель должен выполнить первый платеж вручную. Дальнейшие платежи инициируются по вашему запросу.
Особенности сценария:
- В сценарии может быть использован любой платежный метод, который поддерживает автоплатежи (см. справочник платежных методов)
- При первой операции покупатель должен предоставить согласие на хранение его платежных данных и их дальнейшее использование на определённых условиях. Ознакомление покупателя с условиями и получение согласия находится на вашей стороне
- При автоплатежах:
- Оплата инициируется вашим запросом, выполняется автоматически и не требует действий со стороны покупателя
- Расписание автоплатежей хранится на вашей стороне. Периоды между автоплатежами могут быть любыми и могут отличаться друг от друга
- Сумма автоплатежа может отличаться от суммы платежа при первой операции
- Платежный метод используется тот же, что и при первой операции и не может быть изменен при проведении автоплатежа
Сценарий состоит из двух этапов:
Последовательность шагов
Шаг 1: проведение первого платежа (родительского)
- Выполните первый платеж по сценарию оплата через платежную форму Softline Payments.
При этом:- В запросе на создание платежа (
/v1/payment
) передайте дополнительный параметр"recurring_indicator":true
, чтобы зарегистрировать платеж в качестве родительского для последующих автооплат - Обратите внимание! Платежная форма Softline Payments имеет стандартный вид и не содержит дополнительных сообщений о том, что платежные данные будут сохранены для последующих автоплатежей. Получение согласия покупателя на автоплатежи выполняется на вашей стороне
- В запросе на создание платежа (
- Дождитесь успешного завершения оплаты. Для этого подождите пока придет webhook-уведомление или проверьте статус платежа с помощью запроса получения данных о платеже. Подробнее описание этого шага см. в сценариях, по которым выполняется первый платеж
Шаг 2: проведение последующих автоплатежей
- Выполните запрос на авторизацию для работы с API (
/v1/login_check
) - Выполните запрос на проведение автоплатежа (
/v1/payment/recurring
)- В результате будет создан платеж и инициировано проведение оплаты
- Автоплатеж будет выполнен с использованием платежных данных из родительского платежа
- Валюта автоплатежа должна совпадать с валютой родительского платежа
- При проведении оплаты нами предпринимается только одна попытка выполнения
- Дождитесь успешного завершения оплаты. Для этого подождите пока придет webhook-уведомление или проверьте статус платежа с помощью запроса получения данных о платеже
- В случае успешной оплаты вы получите webhook-уведомление о событии order.payment.succeeded. Статус обработки платежа изменится на paid
- При ошибке оплаты вы получите webhook-уведомление о событии order.payment.failed. Статус платежа не изменится
- Если платеж не был оплачен, то его статус останется not paid. Срок жизни платежа в этом равен 90 дней. После этого происходит автоматическое изменение статуса на deleted
- Если нужно повторить попытку оплаты, то выполните запрос на проведение автоплатежа (
/v1/payment/recurring
). В результате будет создан новый платеж. Обратите внимание, создание нового платежа не влияет на ранее созданный. Их оплата выполняется независимо друг от друга.