Данный метод позволяет изменить платежный инструмент у текущей подписки.
Операция доступна только для подписок в статусе:
Необходимо создать сессию и с полученным идентификатором (sessionId) начать работу с виджетом (полученную сессию Вы вставляете в ссылку вызова виджета - https://sandbox.pay.mts.ru/pages/pay?sessionId=полученная_сессия) , где клиент самостоятельно выберет платежный инструмент для существующей подписки.
Заголовок запроса
POST |
Так же, передается SSL сертификат.
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| Request-Id | guid | да | Идентификатор конкретного запроса |
Requestor-Name | string | нет | Наименование сервиса.
|
| Requestor-Type | string | нет | Тип витрины.
|
| Requestor-Version | string | нет | Версия виджета/sdk |
Тело запроса
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| id | guid | да | Идентификатор подписки, уникальное текстовое значение |
| paymentToolsFilter | object | нет | Набор инструкция для фильтрации ПМ/ПИ |
Описание структуры paymentToolsFilter
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| allowedPaymentTools | array | нет | Допустимые платежный инструмент
|
allowedCardTypes | array | нет | Допустимые типы карт
|
Заголовок ответа
Content-Type: application/json; charset=utf-8 |
Тело ответа
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
sessionId | guid | да | Идентификатор платежной сессии |
POST /subscriptions/payment_tool/update/session/create HTTP/1.1 |
{
"id": "3417b9ff-6906-4ba1-b741-024d7cbfd8b4",
"paymentToolsFilter": {
"allowedPaymentTools": [
"newСard",
"sbp"
]
}
}
Content-Type: application/json; charset=utf-8 |
{
"sessionId": "0b722ef4eb6b4cbe999e1c5bbcb4e456"
}
code | message | userMessage |
|---|---|---|
| 00299998 | Validation error | Не пройдена валидация данных |
| 00299999 | An unexpected error has occurred | Непредвиденная ошибка |
| 01000002 | Inactive merchant | Мерчант не активный |
| 00200002 | Certificate is not valid | Сертификат не прошел проверку |
| 00200006 | Invalid operation for current subscription status: Current status: {0} | Подписка в статусе, над которым данная операция запрещена |
| 00200013 | The subscription {0} not found for merchant {1} | Подписка не найдена |
| 03000008 | Invalid operation for current subscription status: Current status: {0} | В процессе проведения операции произошла ошибка. Попробуйте позже. |