Возобновление подписки

Доступно только в статусе repeatedPay или suspended.

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

Заголовок запроса

POST
Endpoint: https://sandbox.pay.mts.ru/private/v1/subscriptions/{subscriptionId}/recovery/session/create HTTP/1.1
Content-Type: application/json
<Основные параметры>

Так же, передается SSL сертификат.

Основные параметры

Поле	Тип	Обяз.	Описание
Request-Id	guid	да	Идентификатор конкретного запроса
Requestor-Name	string	нет	Наименование сервиса. Для веба - домен, на котором запущен виджет. Для SDK - идентификатор приложения. Для API - имя вызывающей системы.
Requestor-Type	string	нет	Тип витрины. API Web Widget Web Page SDK Apple SDK Android
Requestor-Version	string	нет	Версия виджета/sdk

Параметр запроса

Поле	Тип	Обяз.	Описание
subscriptionId	guid	да	Идентификатор подписки, уникальное текстовое значение

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

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

Поле	Тип	Обяз.	Описание
sessionId	guid	да	Идентификатор платежной сессии

Примеры

Заголовок запроса

POST /subscriptions/{subscriptionId}/recovery/session/create HTTP/1.1
Host:
Content-Type: application/json
<Основные параметры> (пример в описании)

Тело запроса

{}

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

{
  "sessionId": "0b722ef4eb6b4cbe999e1c5bbcb4e456"
}

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

Описание ответного сообщения в продакшн.

Коды и описание представлено в таблице:

code	message	userMessage	isFatal	Комментарий
00299998	Validation error	Не пройдена валидация данных	нет	в modelState указывается список полей с некорректным типом данных или отсутствующими обязательными полями
00299999	An unexpected error has occurred	Непредвиденная ошибка	да
00100001	Session {0} not found	Сессия не найдена	да
01000002	Inactive merchant	Мерчант не активный	да
01000004	Service not available	Выбранный сервис недоступен мерчанту	да
00200006	Invalid operation for current subscription status: Current status: {0}	Подписка в статусе, над которым данная операция запрещена	да	Доступно только в статусе repetedPay или suspended.
00200013	The subscription {0} not found for merchant {1}	Подписка не найдена	да
00200022	Subscription not available for service	Подписки не доступны для сервиса	да
00200023	The promo period is active for the subscription, renewal is not possible	Для подписки активен промо период, возобновление не возможно	да
03000008	Invalid operation for current subscription status: Current status: {0}	В процессе проведения операции произошла ошибка. Попробуйте позже.	да