Токен для рекуррентных переводов

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

Для этого проведите один успешный перевод с указанием сохранить данные банковской карты. В ответ на такой перевод вернется токен. Токен можно сохранить и проводить с ним следующие переводы.

Как получить токен при создании сессии

Передайте в запросе recurrent=true (в объекте payment_options).

Это можно сделать при старте перевода.

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

В этом случае вам нужно получить согласие пользователя на своей стороне — заранее.

Статусы токена

Когда вы создаете токен, он становится активным (is_active: true) — по нему можно проводить переводы.

Если токен неактивен (is_active: false), перевод не пройдет, вернется ошибка.

Как узнать статус токена

Отправьте запрос token/info. В поле type передайте значение recurrent_token, в поле recurrent_token.token —  токен, статус которого нужно узнать.

В ответе будет получен info с датой, до которой действует токен (finished_at), и его статусом (is_active). Дата окончания действия токена finished_at никак не проверяется на стороне Банка — токен останется активным и после даты, указанной в этом параметре. Если is_active: true, значит, по этому токену можно проводить переводы.

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

Как отключить токен

Если вы больше не хотите использовать токен для переводов (например, пользователь отключил автоплатеж), отправьте запрос recurrent/disable.

В ответе будет получен recurrent. Если is_active: false, значит, токен отключен, по нему больше нельзя проводить переводы.

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