Платёжный токен (сессия)

Частотность регулярных платежей должна соответствовать требованиям НСПК: в случае неуспешной попытки списания эквайер имеет возможность в течение 30 дней провести повторные попытки, но не чаще одного раза в сутки. Исключением является сценарий холдирования средств.

Функционал подписок требует экосистемную авторизацию web sso. Карты, привязанные при оплате вашего продукта, будут доступны пользователю при оплате по другим продуктам экосистемы.
Управлять картами пользователь сможет на витринах profile.mts.ru и сайте/мобильном приложении МТС Деньги/МТС Банк.

Основные параметры аналогичны описанию Разовая покупка (сессия), в данном разделе приведено описание дополнительных параметров.

Описание функционала

Для чего нужен данный функционал?

Функционал необходим, если вы хотите управлять регулярными списаниями самостоятельно или с помощью платформ (например, MasterHub или Enablement Platform).

Обратите внимание: в случае интеграции через Enablement Platform - сессию на оплату создает Enablement Platfrom.

Описание процесса взаимодействия

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

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

Процесс взаимодействия

1. Выбираете необходимый сценарий создания платежного токена.
2. Для создания платежного токена требуется создать платежную сессию с расширением передачи параметра createPaymentToken. В ответе получаете sessionId и paymentTokenId.
3. С полученным sessionId инициализируете виджет (веб-виджет, iOS, Android) и проводите оплату.
4. Получаете уведомление о результате платежа (если это не верификационный платеж) и уведомление о создании платежного токена (можно проводить оплату по платежному токену). 
5. Предоставляете плательщику возможность пользоваться услугой.
6. При наступлении момента необходимости списания денег выполняете соответствующий запрос.

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

Создание платежной сессии с созданием платежного токена

Аналогично разделу создания платежной сессии, но с добавлением параметра createPaymentToken и его значением true.

Нельзя использовать вместе с блоком subscription

В ответ вы получите не только id сессии, но и id платежного токена. Важно отметить, что при инициализации виджета - нужно обязательно передать tokenId.

Если вам не разрешено создавать платежные токены, вы получите код ошибки: 00200025. Для включения данного функционала напишите на paymentsupport@mts.ru согласно заявке на консультацию.

Особые случаи

Если во время оплаты, требовалось создать платежный токен, но возникли нештатные ситуации:

• не смогли привязать новую карту;
• не смогли активировать платежный токен.

то в таких случаях мы:

• отменим совершенный платеж (и отправим вам уведомление об этом, т.е. в этом случае вы  получите уведомление об успехе платежа и уведомление об отмене платежа);
• так же мы отклоним создание платежного токена, переведем его в статус declined.

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

Входные параметры

Выходные параметры

Тело ответа

Пример

Запрос

{
  "serviceId" : 5560,
  "serviceParams" :
  {
    "NUMBER" : "79160026188",
    "payerEmail" : "tests12345@mts.ru",
    "id1" : "108882256562"
  },
  "amount" : 13.4,
  "currency" : "643",
  "extClientId" : "89150123456",
  "createPaymentToken": true
}

Ответ

{
  "sessionId": "0b722ef4eb6b4cbe999e1c5bbcb4e456",
  "paymentTokenId": "15ff57f76b8d436b8c8a2d4dec32bae0"
}

Возможные коды ошибок

Основные коды ошибок - см. Разовая покупка.