Проведение платежа платежным токеном

Введение

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

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

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

POST
Endpoint: https://sandbox.pay.mts.ru/private/v1/payments/token/process HTTP/1.1
Content-Type: application/json
<Основные параметры>

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

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

Тело запроса

Поле	Тип	Обязат.	Описание
amount	amount	да	Сумма платежа
currency	string[3]	нет	Валюта платежа, по умолчанию 643
extClientId	string	да	Идентификатор пользователя в системе Мерчанта
paymentTokenId	guid	да	Идентификатор токена в ПШ
usePreAuth	boolean	нет	Использовать двустадийную оплату по токену. По умолчанию false
serviceId	int64	условно	ID сервиса обязателен, если необходимо поддержать оплату одним платежным токеном для различных услуг (serviceId). может быть передан, только при согласованном сценарии оплаты платежным токеном различных услуг и включенной конфигурации MTS Pay
serviceParams{}	object	условно	Набор "параметр":"значение", описывающих реквизиты платежа (специфичных для каждого поставщика) обязателен, если передан serviceId
usePreAuth	boolean	нет	Использовать двустадийную оплату по токену. По умолчанию false
receiptId	int64	нет	id операции фискализации

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

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

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

Тело ответа

Поле	Тип	Обязат.	Описание
sessionId	string	да	Идентификатор платежной сессии
result	object	да	Объект с результатом операции
processingData	object	нет	Дополнительная информация об операции

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

Поле	Тип	Обяз.	Описание
rrn	string	нет	RRN Банка

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

Поле	Тип	Обяз.	Описание
operationDate	dateTime	да	Дата и время выполнения операции
paymentId	int64	да	Идентификатор платежа
processingId	string	да	Идентификатор платежа в системе процессинга
status	string	да	Статус операции inProgress - в процессе исполнения executed - выполнен

Пример

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

GET https://sandbox.pay.mts.ru/private/v1/payments/token/process HTTP/1.1
Host:
Content-Type: application/json
Request-Id: 599e4b42-e7ef-4e1b-80fb-cc59119c0dce

Тело запроса

{
  "amount" : 13.4,
  "currency" : "643",
  "extClientId" : "chelovekNeviDimka669",
  "paymentTokenId" : "15ff57f76b8d436b8c8a2d4dec32bae0"
}

{
  "amount": 13.4,
  "currency": "643",
  "extClientId": "chelovekNeviDimka669",
  "paymentTokenId": "15ff57f76b8d436b8c8a2d4dec32bae0",
  "serviceId": 5560,
  "serviceParams": {
    "NUMBER": "79160026188",
    "payerEmail": "tests12345@mts.ru",
    "id1": "108882256562"
  }
}

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

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

Тело ответа

{
  "sessionId": "string",
  "result": {
    "operationDate": "2026-02-11T07:36:28.466Z",
    "paymentId": 0,
    "processingId": "string",
    "status": "executed"
  },
  "processingData": {
    "rrn": "string"
  }
}

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

code	message	userMessage
00299998	Validation error	Не пройдена валидация данных
00299999	An unexpected error has occurred	Непредвиденная ошибка
01000002	Inactive merchant	Мерчант не активный
01000003	Service not found	Услуга (serviceId) не найдена
01000004	Service not available	Выбранный сервис недоступен мерчанту
00200002	Certificate is not valid	Сертификат не прошел проверку
00200026	Invalid operation for current payment token status: Current status: {0}	Платежный токен в статусе, над которым данная операция запрещена
00200043	Payment token temporarily blocked	Платежный токен временно заблокирован
02000001	This method is not supported for this payment tool. Payment tool: {paymentToolType}	данный метод не поддерживается для этого способа оплаты. Способ оплаты: {paymentToolType}
02000002	Inactive merchant	В процессе проведения операции произошла ошибка. Попробуйте позже.
02000003	Invalid operation for current payment status: Current status: {0}	Платеж в статусе над которым данная операция запрещена
02000004	Payment {0} not found from merchant {1}	Платеж не найден
02000005	It was not succeeded to reversal payment. There was time for possibility of execution of operation	Отменить платеж не удалось. Вышло время на возможность выполнения операции
02000008	Operation is processed. Repeat operation once again, with the same data set to know the result of operation.	Операция обрабатывается. Повторите операцию еще раз, с тем же набором данных, чтобы узнать результат операции.
02000009	Error of check of parameters of payment.	Ошибка проверки параметров платежа. {текст сообщения от Мерчанта}
02000012	Total amount of payment not matching its components	Общая сумма платежа не соответствует компонентам платежа
02000014	Refunds amount exceeds transaction amount	Сумма возмещений превышает сумму транзакции. Уменьшите сумму и повторите операцию.
02000015	Refunds loyalty amount exceeds transaction loyalty amount	Cумма возмещений баллов системы лояльности превышает сумму баллов в исходной транзакции. Уменьшите сумму и повторите операцию.
02000016	Payment transaction has been changed, reversal not allowed	Платежная транзакция была изменена, отмена не допускается
02000017	Payment completed unsuccessfully	Попробуйте повторить операцию или обратитесь в службу поддержки
02000018	The operation is not supported by the selected payment tool	Операция не поддерживается выбранным платежным инструментом
02000020	The processing system rejected the return request	Процессинговая система отклонила запрос на возврат
02000021	Unknown operation status. Contact Support.	Неизвестный статус операции. Обратитесь в службу поддержки.
02000022	The serviceCategoryType has a payment, payment status in progress	Произошла системная ошибка. Деньги списаны, но мы скоро их вернём.
02000024	Operation amount exceeds pre-authorization amount	Сумма операции превышает сумму предавторизации. Уменьшите сумму и повторите операцию.
02000026	The limit for unsuccessful operations of this type has been reached. Contact support.	Достигнут лимит по неуспешным операциям данного типа. Обратитесь в службу поддержки.
02000027	Operation amount exceeds the permissible value	Сумма операции превышает допустимое значение. Уменьшите сумму и повторите операцию.
02000028	There is no loyalty in this operation	в этой операции нет лояльности
02000029	Only full return is possible for this type of transaction	Для данного типа операций возможен только полный возврат
02000030	There is another active transaction by this payment. Wait for execution.	По данному платежу есть другая активная операция. Дождитесь выполнения.
02000031	Refill is not available for PaymentTool	Пополнение недоступно для данного платёжного инструмента
02000032	Refill is not available	В пополнение указанного реквизита недоступно
02000033	Refill is not available	Пополнение в настоящий момент недоступно
02000035	Cancellation cannot be made more than once.	Отмена не может быть произведена более одного раза.
02000036	Cancel operation is not allowed for two-stage payment. Please use the refund method	Для двухстадийной оплаты запрещена операция отмены. Используйте метод возврата
02000037	Reversaland refund operations are not allowed for refill transactions.	Для транзакций пополнения запрещены операции отмены и возврата
02000038	Verification payments are prohibited for refill transactions	Для транзакций пополнения запрещены верификационные платежи
02005000	PCEK: unexpected error. extSystemErrorCode: [errorCode]	Непредвиденная ошибка
02005001	PCEK: payment confirmation problems. extSystemErrorCode: [errorCode]	Проблемы с подтверждением платежа. Попробуйте снова.
02005002	PCEK: card expired. extSystemErrorCode: [errorCode]	Истёк срок действия карты
02005003	MPI: 3d secure problems. extSystemErrorCode: [errorCode]	Проблемы с подтверждением платежа. Попробуйте снова.
02005006	PCEK: payment limits restriction. extSystemErrorCode: [errorCode]	Превышен лимит на платежи через выбранный способ оплаты
02005007	PCEK: service unavailable.	Сервис временно недоступен. Попробуйте повторить позже.
02005009	PCEK: insufficient funds. extSystemErrorCode: [errorCode]	Недостаточно средств
02005011	PCEK: CVC/CVV is invalid. extSystemErrorCode: [errorCode]	Неверный код безопасности (CVC/CVV)
02005013	PCEK: expiry date is invalid. extSystemErrorCode: [errorCode]	Неверный срок действия карты
02005014	PCEK: card pan is invalid. extSystemErrorCode: [errorCode]	Неверный номер карты
02005016	Bank acquirer: invalid merchant or terminal. extSystemErrorCode: [errorCode]	Оплата через выбранный способ оплаты временно недоступна
02005017	Bank issuer: general error. extSystemErrorCode: [errorCode]	Ваш банк отклонил платёж
02005018	Bank issuer: potential fraud or safety restriction. extSystemErrorCode: [errorCode]	Оплата по выбранной карте недоступна
02005019	PCEK: payment declined. extSystemErrorCode: [errorCode]	Платёж отклонен. Смените способ оплаты и попробуйте снова.
02005023	PCEK: The amount is greater than the maximum allowed. extSystemErrorCode: [errorCode]	Сумма платежа больше максимально разрешенной
02005024	PCEK: The amount is less than the minimum allowed. extSystemErrorCode: [errorCode]	Сумма платежа меньше минимально разрешенной
02005025	PCEK: potential fraud or safety restriction. extSystemErrorCode: [errorCode]	Платёж отклонён системой безопасности
02005027	PCEK Provider: On this payment reversaling is executed earlier extSystemErrorCode: [errorCode]	По данному платежу выполнена отмена ранее
02005028	PCEK Provider: On this payment refunding is executed earlier extSystemErrorCode: [errorCode]	По данному платежу выполнен полный возврат ранее
02005030	Fraudcontrol: exceeding limits. extSystemErrorCode: [errorCode]	Платёж отклонен системой безопасности
02005031	PCEK: invalid provider or provider configuration. extSystemErrorCode: [errorCode]	Оплата через выбранный способ оплаты временно недоступна
02005032	ESPP: account top up is not available. extSystemErrorCode: [errorCode]	Пополнение выбранного счёта недоступно
02005033	PCEK Provider: The system cannot process the payment	Операция не выполнена. Выберите другой способ оплаты или обратитесь в службу поддержки.
02005034	PCEK FM: bank card is used in another account. extSystemErrorCode: [errorCode]	Банковская карта уже привязана к другому аккаунту
02005036	Bank issuer: payment restriction. extSystemErrorCode: [errorCode]	Ваш банк ограничил оплату с выбранной карты
02005040	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Превышен лимит на платежи
02005042	PCEK: service unavailable. extSystemErrorCode: [errorCode]	Сервис временно недоступен
02005043	PCEK: bank issuer have some problems. extSystemErrorCode: [errorCode]	Ваш банк отклонил платёж
02005044	PCEK FM: potential fraud or safety restriction. extSystemErrorCode: [errorCode]	Платёж отклонён системой безопасности
02005047	PCEK Provider: service unavailable. extSystemErrorCode: [errorCode]	Сервис временно недоступен
02005048	PCEK Provider: wrong payment parameters specified. extSystemErrorCode: [errorCode]	Неверные реквизиты оплаты
02005049	PCEK: payment from billing account is not available. extSystemErrorCode: [errorCode]	Оплата со счёта телефона временно недоступна
02005051	ESPP: service unavailable. extSystemErrorCode: [errorCode]	Оплата временно недоступна
02005052	ESPP: client is legal entity. extSystemErrorCode: [errorCode]	Выбранный способ оплаты доступен только физическим лицам
02005053	ESPP: payment restriction installed by the client. extSystemErrorCode: [errorCode]	Оплата со счёта запрещена
02005054	ESPP: incorrect account parameters. extSystemErrorCode: [errorCode]	Оплата через выбранный способ оплаты временно недоступна
02005055	ESPP: insufficient funds. extSystemErrorCode: [errorCode]	Недостаточно средств
02005056	Bank issuer: insufficient funds extSystemErrorCode: [errorCode]	Недостаточно средств
02005057	Bank issuer: invalid CVC or another safety restriction. extSystemErrorCode: [errorCode]	Неверный код безопасности (CVC/CVV)
02005058	Bank issuer: card expired. extSystemErrorCode: [errorCode]	Истек срок действия карты
02005059	Bank acquirer: reversal is not possible, try calling a refund. extSystemErrorCode: [errorCode]	Отмена невозможна, попробуйте совершить возврат
02005060	Bank issuer: potential fraud or safety restriction. extSystemErrorCode: [errorCode]	Ваш банк отклонил платеж. Ограничения на карте.
02005061	Bank acquirer: general error. extSystemErrorCode: [errorCode]	Банк отклонил платёж
02005062	Bank issuer: recurring operations are not available for this card. extSystemErrorCode: [errorCode]	Ваш банк отклонил платёж
02005063	PCEK Limit checker: mts account limits restriction	Превышен лимит на платежи через выбранный способ оплаты
02005064	Bank issuer: payment restriction. extSystemErrorCode: [errorCode]	Ваш банк ограничил оплату с выбранной карты
02005065	Bank acquirer: fatal general error. extSystemErrorCode: [errorCode]	Банк отклонил платёж
02005066	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Операция не выполнена. Повторите попытку позже
02005067	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Платёж отклонён, попробуйте оплатить мобильный в приложении банка или онлайн-банке
02005068	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Счета получателя попали в базу данных ЦБ РФ из-за подозрительных переводов
02005069	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Ваши данные попали в базу данных ЦБ РФ, подробнее https://www.cbr.ru/Reception/Message/Register
02005070	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Деактивируйте VPN для проведения оплаты
02005071	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Подозрительная активность с устройства. Повторите в другом браузере
02005072	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Ваше приложение устарело. Обновите версию.
02005073	Bank issuer: Reduce the payment amount or try again later	Уменьшите сумму платежа или попробуйте позже
02005074	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Перевод этому получателю невозможен. Проверьте, что верно ввели реквизиты.
02005075	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	Мы заметили подозрительную активность с устройства. Пройдите верификацию в офисе Банка для снятия действующих ограничений.
02005076	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	В данный момент проведение операций недоступно в связи с обновлением данных о Вашем номере телефона. Попробуйте через 24 часа
02005077	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	На данный момент проведение операции невозможно. Попробуйте воспользоваться иным сервисом
02005078	PCEK FM: safety restriction. extSystemErrorCode: [errorCode]	На данный момент Вам ограничено использование ДБО и карт. Необходимо предоставить документы, раскрывающие источник происхождения денежных средств, а также пояснения относительно экономического смысла проводимых операций
02006300	chargingEP: Insufficient funds	Недостаточно средств. Измените способ оплаты и попробуйте снова.
02006301	chargingEP: Payment cannot be processed according to these parameters	Операция не выполнена. Измените способ оплаты или обратитесь в службу поддержки.
02006302	chargingEP: The system cannot process the payment	Операция не выполнена. Измените способ оплаты или обратитесь в службу поддержки.
02006303	chargingEP: Service unavailable	Сервис временно недоступен
02006304	chargingEP: Account is partially blocked, there are not enough funds.	Недостаточно средств. Погасите задолженность или измените способ оплаты
02006401	StreamPayments: service unavailable	Сервис временно недоступен. Попробуйте повторить позже.
02006402	StreamPayments: system cannot process the payment. extSystemErrorCode: [errorCode]	Операция не выполнена. Выберите другой способ оплаты или обратитесь в службу поддержки.
02006405	StreamPayments: оperation execution error	Операция не выполнена. Повторите попытку или обратитесь в службу поддержки.
02006406	StreamPayments: оperation not found	Операция не найдена
02006407	StreamPayments: system cannot process the operation	Операция не выполнена. Обратитесь в службу поддержки.
02007000	Not identified error	Непредвиденная ошибка
02007001	The system cannot process the payment	Не удалось завершить оплату частями. Все средства по платежу вернутся в ближайшее время
02007002	Сard expired	Истёк срок действия карты
02007003	Insufficient funds	Недостаточно средств
02007004	CVC/CVV is invalid	Неверный код безопасности (CVC/CVV)
02007005	Card pan is invalid	Неверный номер карты
02007006	General error	Ваш банк отклонил платёж
02007007	Potential fraud or safety restriction	Оплата по выбранной карте недоступна
02007008	Potential fraud or safety restriction	Платёж отклонён системой безопасности
02007009	On this payment reversaling is executed earlier	По данному платежу выполнена отмена ранее
02007010	Potential fraud or safety restriction	Ваш банк отклонил платеж. Ограничения на карте.
02007011	The system cannot process the reversal	Не удалось завершить отмену оплаты.
02007012	The system cannot process the refund	Не удалось завершить возврат платежа
02007013	Operation not support	Операция не поддерживается
02007014	Payment instrument not available	Платежный инструмент недоступен
02007015	The limit on the amount of transactions has been exceeded	Превышен лимит по сумме операций
02007016	The limit on the number of transactions has been exceeded	Превышен лимит по количеству операций
02007017	Invoice not found	Счет не найден
02007018	Validation error	Не пройдена валидация данных
02007022	Precondition Required: {0}	Не выполнены условия запроса"
02007023	The system cannot process the payment	Ваш банк отклонил платёж
02007026	The transaction was declined by the cardholder	Операция отклонена держателем карты
02007027	The payment deadline has expired since the registration of the payment	Истек срок, отведенный на оплату заказа с момента регистрации платежа
02007028	Purchase payment error	Во время оплаты возникла ошибка. Проверьте баланс и попробуйте снова.
02007029	PaymentToken/subscription is invalid. PaymentToken/subscription needs to be recreated.	Платёжный токен/подписка не действительны. Необходимо пересоздать платёжный токен/подписку.
02007031	No connection with the issuing bank	Нет связи с банком, выпустившим карту
02007032	payment gateway failure	Код отказа платёжного шлюза по умолчанию (Операция отклонена. Обратитесь в магазин)
02007999	Service unavailable	Сервис временно недоступен. Попробуйте повторить позже.
07000002	Payment token {0} not found	В процессе проведения операции произошла ошибка. Обратитесь в службу поддержки.