Создание ссылки на оплату/привязку счета СБП

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

Предварительно должна быть создана платежная сессия:
- либо для разовой оплаты;
- либо для оплаты с последующим созданием подписки;
- либо платежный токен.
Для выпуска ссылки на оплату/привязку счета используем данный метод. Ссылка необходимо передать пользователю, можно использовать готовые sdk НСПК, открывать напрямую полученную ссылку в браузере плательщика, либо реализовать свой интерфейс выбора банка для оплаты. Список банков MTS Pay отдает в методе Список банков СБП

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

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

POST
Host: https://sandbox.pay.mts.ru/public/v1/
Endpoint: /invoice/create HTTP/1.1
Content-Type: application/json
Session-Id: {значение}
<Основные параметры>

Поле	Тип	Обязат.	Описание
Session-Id	string [36]	да	Идентификатор платежной сессии

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

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

Тело запроса

redirectUrl	string	нет	Ссылка для редиректа пользователя после оплаты
isSbpTokenCreate	boolean	нет	Признак запроса на создание СБП Счета

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

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

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

Тело ответа

Поле	Тип	Обяз.	Описание
result	object	нет	Обязательно, если подтверждение не требуется и процесс завершен

Описание структуры result

Поле	Тип	Обяз.	Описание
paymentPageURL	string	да	Ссылка на форму оплаты счета (платежную страницу)

Пример

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

POST
Host: https://sandbox.pay.mts.ru/public/v1/
Endpoint: /invoice/create HTTP/1.1
Content-Type: application/json
Session-Id: d6946779-dd1a-4e91-8e21-e0ddc8a00288
<Основные параметры> (пример в описании)
Content-Type: application/json

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

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

Тело ответа

{
    "result": {
        "paymentPageURL": "https://qr.nspk.ru/AD10001G6CVRKNKV99Q9L63O2TP45IP7?type=02&bank=100000000017&sum=1&cur=RUB&crc=8244"
    }
}

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

code	message	userMessage
00199998	Validation error	Не пройдена валидация данных
00199999	An unexpected error has occurred	Непредвиденная ошибка
00100001	Session {0} not found	Сессия не найдена
00100003	The payment is already completed within this session {0}	Платеж уже завершен в рамках этой сессии
00100004	The sequence of operations is broken. {0}	В процессе проведения операции произошла ошибка. Попробуйте позже.
00100011	Payment tool not available	Операция не выполнена. Измените способ оплаты и попробуйте снова.
00100018	Payment method not provided for this payment scenario	Платежный метод не поддерживается для данного сценария платежа
06005101	Validation error	Не пройдена валидация данных
06005102	Authorization Error	Ошибка авторизации
06005103	An unexpected error has occurred	Непредвиденная ошибка