Вы находитесь на странице: 1из 214

«УТВЕРЖДАЮ» «УТВЕРЖДАЮ»

Руководитель отдела ….. Технический директор


ПАО «МТС» ООО «РБС»

__________________ / _____________/ __________________ /_____________./

ПРОЦЕССИНГОВЫЙ ЦЕНТР СЕРВИСА «ЭЛЕКТРОННЫЙ


КОШЕЛЕК МТС ДЕНЬГИ»
Протокол подключения витрин и приложений
Описание протокола

Москва 2016 г
История изменений
Верс
Дата Изменения Автор
ия

0.1 23.06.2016 Начальная версия документа. Описаны методы для реализации сценария платежа Рябов А.Н.
с лицевого счета в пользу ТСП на сайте МТС-Деньги getServices, getWallet,
registerWallet, getBindings, getPaymentTerms, performPayment, getPaymentResult

0.6 09.07.2016 1. Добавлены справочники с типами платежных инструментов, статусы Рябов А.Н.
платежных инструментов
1. Добавлены методы для реализации сценариев привязки банковской карты,
оплаты банковской картой:
2. В методы «getBindings – Получение списка Платежных инструментов»,
«getPaymentTerms – Запрос расчета комиссии и лимитов на платеж»,
«payment – Произвести платеж или перевод» добавлена поддержка оплаты
банковскими картами

25.07.2016 1. Изменено название документа. Прежнее название «Спецификация API. Рябов А.Н.
Описание протокола», новое – «Протокол подключения витрин и
приложений. Описание протокола». Разделы с описанием сервисов для
подключения платежных агрегаторов перенесены в отдельный документ
«Протокол подключения агрегаторов».
2. Изменено название сервиса performPayment, чтобы не возникало путаницы с
одноименным сервисом в протоколе подключения агрегаторов. Новое
название сервиса – payment (см.п.7.2)
3. Изменен ответ сервиса payment: исключены параметры resultType,
confirmationType. Добавлены параметры PaReq и acsUrl для технологии
3DSecue

28.07.2016 1. Сервис getPaymentResult переименован в getPaymentStatus. Определены параметры Рябов А.Н.


2. Добавлен справочник «state - Статус операции» (п.2.1.6)
3. Добавлен раздел «» с описанием механизма взаимодействия с ACS банка эмитента
через браузер клиента
4. Добавлена поддержка нового типа платежного инструмента - WALLET_ACCOUNT
(ЭДС)

05.08.2016 2. Переименованы методы Рябов А.Н.


 createCardBinding – Инициация регистрации карты
3. Изменен код платежного иструмента в п.2.1.1 «bindingType - Типы платежных
инструментов»: EMONEY_ACCOUNT (прежний код WALLET_ACCOUNT)
Добавлен метод

06.09.2016 Переработано описание для группы сервисов – «Переводы между платежными Рашин Г.Д.
инструментами». Определение комплексных типов binding, amount вынесено в
отдельные главы. В местах использования сделаны ссылки на комплексный тип.

06.09.2016 1. Добавлен параметр confirmationType в ответе для запроса payment, если Аносов Д.А.
операция требует подтверждения
2. Параметр errorCause переименован в errorDesc в ответе для payment
3. Добавлены примеры ответов на запрос payment для различных случаев

07.09.2016 1. Справочник cardType (2.1.4) приведен к актуальному виду Аносов Д.А.


2. Актуализировано описание getPaymentStatus. Теперь ответ данного метода
содержит полную информацию об операции (сервис, сумма, платежный
инструмент). Добавлены примеры.
3. Из ответа на payment и аналогичных методов удалено поле resultType. О
статусе операции нужно ориентироваться по errorCode, state, confirmationType
4. Актуализировано описание метода confirmTransactionByOtp. Добавлены
примеры.
5. Актуализировано описание метода reSendOtp. Добавлены примеры.

09.09.2016 1. Добавлено описание протокола взаимодействия с ТСП. Рашин Г.Д.


2. Добавлено описание пополнения ЭДС.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 2 из 214
ООО «Рунет Бизнес Системы» :
:
15.09.2016 1. В ответе для getBToBTransferTerms поле fromBinding переименовано в Аносов Д.А.
srcBinding, поле toBinding переименовано в dstBinding. Актуализирован пример
ответа.
2. В ответе для transferBindingToBinding поле fromBinding переименовано в
srcBinding, поле toBinding переименовано в dstBinding. Добавлено поле state.
Актуализирован пример ответа.

16.09.2016 1. Добавлено описание методов finish3dsTransfer и confirmTransferByOtp. Аносов Д.А.


2. Приведены примеры ответов для getBToBTransferTerms и
transferBindingToBinding для различных типов ПИ и способов подтверждения.

23.09.2016 1. Добавлено описание кодов ответов, связанных с взаимодействием со Аносов Д.А.


сторонними системами

27.09.2016 1. Добавлен код ответа 404 в случае, если не найден обработчик для Аносов Д.А.
вызываемого метода API (опечатка/метод не реализован и т.д.)

28.09.2016 1. Актуализировано описание ответов для getCardToBTransferTerms и Аносов Д.А.


transferCardToBinding

29.08.2016 1. Добавлено описание API для получения истории операций Аносов Д.А.
2. Исправлено название полей ответа для getCardToBTransferTerms: srcBinding
(было fromBinding) и dstBinding (было toBinding)
3. В ответах для методов группы «переводы» измененны названия полей ответа
на следущие: srcBinding (было fromBinding) и dstBinding (было toBinding)
4. В запросах группы переводов параметр – идентификатор ПИ списания
bindingId переименован в srcBindingId, идентификатор ПИ пополнения
targetBindingId/foreignBindingId переименован в dstBindingId

04.10.2016 1. Актуализирован список кодов ошибок Аносов Д.А.


2. Актуализированы примеры ответа для API getBToCardTransferTerms и
transferBindingToCard
3. Актуализированы примеры ответа для API getBToEMTransferTerms и
transferBindingToEMoney

05.10.2016 1. Добавлено описание метода getOperationDetails Аносов Д.А.

07.10.2016 1. Актуализировано описание ответов для методов getCardToEMTransferTerms и Аносов Д.А.


transferCardToEMoney
2. Актуализировано описание ответов для методов getCardToCardTransferTerms
и transferCardToCard

11.10.2016 1. Добавлено поле status в ответе метода getWallet Аносов Д.А.

19.10.2016 1. В примере запроса на генерацию сертификата в разделе «Авторизация запросов» Рябов А.Н.
изменена длина ключа на 2048 бит

19.10.2016 1. Добавлено поле allowedSrcTypes в описании структуры файла поставщиков Аносов Д.А.
2. Добавлено описание кодов ошибок 239,240,241,243

02.11.2016 1. Добавлено значение GENERAL_CARD в справочник значений bindingType Аносов Д.А.


для обозначения карт-продуктов МТС-банка
2. Актуализировано описаное метода и примеры для bindMtsBankCustomer
3. Добавлено описание кодов ошибок 30xxx, связанных с взаимодействием с
системами Банка
4. Добавлено описание методов updateBankProducts и
getProductBindingWithBalance

08.11.2016 1. В ответе для метода bindMtsBankCustomer убран список bindings Аносов Д.А.

03.12.2016 1. Изменено описание комплексного типа apCreationData – параметры Аносов Д.А.


balanceThreshold и monthlyLimit представлены в виде пар параметров – сумма и
валюта
2. В ответах методов для работы с автоплатежами убран параметр mdOrder
3. Актуализирован пример для метода createAutopayment

05.12.2016 1. Добавлено описание кодов ответов 267-277 Аносов Д.А.


2. Добавлено описание методов confirmAutopaymentCreationByOtp и
reSendAutopaymentCreationOtp
3. Изменен тип данных для параметра apData для метода editAutopayment
4. Параметр operationNotification удален из вызова методов suspendAutopayment
и unsuspendAutopayment (т.к. не поддерживается модулем АвП)

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 3 из 214
ООО «Рунет Бизнес Системы» :
:
06.12.2016 1. Добавлено описание кодов ответов 278-280 Аносов Д.А.
2. Исправлен пример указания списка идентификаторов автоплатежей в примере
вызова сервиса deleteAutopaymentsBatch

08.12.2016 1. Добавлено описание кодов ответов 281-287 Аносов Д.А.

14.12.2016 1.Добавлено описание кодов ошибок 288-290 Аносов Д.А.


2. Исправлены коды ошибок Foris, по ошибке были описаны как 20ХХХ, на
самом деле должно было быть 10ХХХ

17.01.2017 Добавлено поле для возврата информации о начисленных бонусных баллах за Рашин Г.Д.
операцию в ряд методов.

23.01.2017 Добавлено описание методов проверки номера телефона по одноразовому


паролю. generateCustomerCheckOtp, validateCustomerCheckOtp,
resendCustomerCheckOtp.

26.01.2017 Актуализировано описание ответов для методов createCardBinding, Аносов Д.А.


confirmCardBinding3ds, confirmCardBindingByAmount,
createCardBindingAfterPayment

28.02.2017 Добавлено описание кода ответа 136. Самарин Ю.


Н.

10.03.2017 Добавлено описание кода ответа 291. Аносов Д.А.

22.03.2017 Добавлено описание метода createCardBindingWoCheck Аносов Д.А.

22.03.2017 Добавлено поле otpExpiresAt в ответах для payment, transferBindingToBinding, Аносов Д.А.
transferBindingToEMoney, transferBindingToCard

27.03.2017 Добавлено поле eCommercePurchaseCategories в структуре файла поставщиков Аносов Д.А.

27.03.2017 Добавлены коды ошибки 20996, 20995 Аносов Д.А.

29.03.2017 Добавлено описание группы сервисов «Электронная коммерция» Аносов Д.А.

30.03.2017 Добавлен параметр comment в методах get*Terms, transfer*To*, Аносов Д.А.


eCommercePurchase, eCommercePurchaseByMdOrder и поле comment в ответах
методов payment, transfer*To*, eCommercePurchase,
eCommercePurchaseByMdOrder, confirmTransactionByOtp, finish3ds,
getOperationDetails, getOperationsHistory

21.04.2017 Добавлены коды ошибки 293 и 294 Аносов Д.А.

27.04.2017 Добавлен комплексный тип данных providerReceiptParams Аносов Д.А.


Добавлено поле (список) receiptParams в описании формата файла поставщиков
и в описании ответа на запрос getPaymentTerms
Добавлено поле (список) providerReceiptParams в описании ответа на запрос
payment, getPaymentStatus, finish3ds, confirmTransactionByOtp,
getOperationsHistory, getOperationDetals

12.05.2017 Добавлены код ошибки 295 Аносов Д.А.

29.06.2017 Добавлено описание метода /mdes/getCardDataForTokenization – Расчет TAV Аносов Д.А.

04.07.2017 Добавлено описание полей pan и expiry в ответе Аносов Д.А.


метода/mdes/getCardDataForTokenization

24.07.2017 Добавлено описание кодов ошибок 296, 297, 298, 299, 300, 301, 302, 303 Аносов Д.А.

24.07.2017 Добавлено описание группы сервисов «Переводы неклиентам» Аносов Д.А.


Добавлено описание комплексного типа данных transferOnDemandData

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 4 из 214
ООО «Рунет Бизнес Системы» :
:
26.07.2017 Добавлено описание комплексных типов serviceData, operation. Аносов Д.А.
Актуализироано описание ответов и примеры для API: payment, finish3ds,
confirmTransactionByOtp, reSendOtp, getPaymentStatus, transfer*To*, purchase.
Удалено описание неиспользуемых методов: preAuth, completion, settlement,
confirmSMS.
В запросе refund удалены неиспользуемые параметры: merchanrtName, serviceId.
Актуализировано название (confirmOtp -> confirmOTP) и описание метода
confirmOTP: удален неиспользуемый параметр partnerMdOrder. В ответе поле
authCode->approvalCode!!!
Актуализировано описание методов refund, reversal, getStatus: в ответе поле
authCode->approvalCode!!!
Актуализироано описание ответов и примеры для API getOperationsHistory,
getOperationDetails: в блоке service поля serviceCategoryType->category,
serviceCategoryName->categoryName. В блоке данных о чужом ПИ убрано поле
bindingType, добавлено поле phoneNumber.
Актуализировано описание ответов и примеры для API по переводам не
клиентам.
Актуализированы параметры обязательности полей для типа binding.
В ответах для «транзакционных» методов и истории поле refnum переименовано
в refNum.
Добавлен тип операции TOP_UP. (В перечне значений operation.operationType).

07.08.2017 В описании комплексного типа operation было добавлено описания полей, Аносов Д.А.
временно добавленных для обеспечения обратной совместимости: refnum,
authCode, пустого srcBinding.

27.09.2017 Добавлены опциональные поля minAmount, maxAmount в тип binding. Самарин Ю.


Добавлены коды ошибок 304, 305. Н.

28.09.2017 Добавлен код ошибки 306 Аносов Д.А.

12.10.2017 Добавлены поля minAmount и maxAmount в ответах методов, связанных с Аносов Д.А.
переводами, в т.ч. переводами не-клиентам, в случае, если сумма перевода
выходит за заданные настройками рамки.

22.10.2017 Добавлены коды ошибки 307, 308 Аносов Д.А.

25.10.2017 Добавлен код ошибки 309 Аносов Д.А.

17.11.2017 Добавлен код ошибки 3000 Аносов Д.А.

17.11.2017 Добавлено описание комплексного типа user. Аносов Д.А.


Изменено описание ответа для метода getWallet.
Добавлено описание метода getWalletByUserId.

13.02.2018 Добавлено описание метода /sms/send.do Самарин Ю.


Н.

26.02.2018 Добавлен раздел «Группа сервисов Управлением виртуальными картами», Самарин Ю.


содержащий описание метода создания виртуальной карты. Н.

26.02.2018 Добавлены коды ошибок 89, 90. Самарин Ю.


Н.

27.02.2018 Добавлено описание метода получения списка виртуальных Самарин Ю.


карт /virtualcard/list.do. Н.

20.03.2018 В запрос emoneyTopUp.do добавлен параметр localDate. Самарин Ю.


Н.

18.04.2018 Добавлено описание запроса unbindMtsBankCustomer.do Аносов Д.А.

18.04.2018 Добавлено описание использования HTTP-заголовка “commandId” в целях Аносов Д.А.


трассировки

19.04.2018 Добавлено описание нового значения bindingType: Аносов Д.А.


EXTERNALLY_TOKENIZED_CARD
Добавлено описание новых кодов ошибок 331,332,333
Добавлено описание новой группы методов для проведения платежей с
использованием ApplePay/GooglePay/SamsungPay

31.05.2018 В блок с информацией о совершенной операции добавлены элементы Самарин Ю.


srcParentBinding и dstParentBinding. Н.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 5 из 214
ООО «Рунет Бизнес Системы» :
:
22.06.2018 Добавлен раздел «Управление блокировками ПИ», добавлено описание нового Малеев
комплексного типа данных bindingBlock, добавлено описание новых кодов
ошибок (340, 341, 342). Добавлено описание нового поля cardId в типе данных И. С.
binding.

05.07.2018 Добавлено описание параметра requiredState в API getOperationsHistory.do Малеев


И. С.

16.07.2018 Добавлено описание метода /virtualcard/reCreateOnCompromised.do и кода ответа Аносов Д.А.


108.

24.07.2018 Добавлено описание кодоа ответа 109 и 110 Аносов Д.А.

24.07.2018 Добавлено описание API /mobileoperator/getInfoMyMsisdn.do Аносов Д.А.

25.07.2018 Обновлено описание ответа API /mobileoperator/getInfoMyMsisdn.do Аносов Д.А.

25.07.2018 Исправлено описание типа данных в ответе для /binding/getBindingBlockList.do Аносов Д.А.

01.08.2018 Добавлено поле transactionErrorCode в опичении комплексного типа operation Аносов Д.А.

06.08.2018 Добавлено описание кодов ответа 111 и 112 Аносов Д.А.

28.08.2018 Добавлено описание нового bindingType = BANK_ACCOUNT Аносов Д.А.

30.08.2018 Добавлено описание нового API: /smsapi/transfer.do в разделе API для SMS Малеев И.С.
переводов

13.09.2018 Удален раздел сервиса «автоплатежи» Самосват


О.А.

19.09.2018 Добавлено описание метода getTechnicalAccountBalance Аносов Д.А.

26.09.2018 Добавлено описание комплексного типа данных convertedAmount. Добавлено Аносов Д.А.
поле convertedAmount в описании ответа для getPaymentTerms и в описании
комплексного типа operation. Пример значения convertedAmount добавлен в
примере ответа для getPaymentTerms.

02.10.2018 Добавлено описание типов данных amountInfo и limitsInfo. В типе binding Аносов Д.А.
добавлено описание нового поля limitsInfo. Обновлен ответ в примере для
createElectronicMoneyAccount с учетом данного изменения.

05.10.2018 Корректировка раздела 7 (корректировка комбинаций доступных переводов) и Самосват


7.8 (описание CVC) О.А.

16.10.2018 Корректировка раздела «Управление блокировками» (341 <-> 340) Самосват


О.А.

17.10.2018 Корректировка разделов 2.2.2 и добавление раздела 2.2.12 с описанием кодов Самосват
отказа TIETO О.А.

16.10.2018 Корректировка раздела «Управление блокировками» (340 <-> 341) Самосват


О.А.

31.10.2018 В методы transferBindingToCard.do/getBToCardTransferTerms.do добавлен Самосват


параметр dstPhone - номер телефона получателя. В О.А.
методы transferCardToCard.do/getCardToCardTransferTerms.do добавлены
параметры srcPhone - номер телефона отправителя и dstPhone - номер телефона
получателя. Доработано в рамках задачи 2740.

15.11.2018 Обновлено описание и пример ответа для API /smsapi/transfer.do Аносов Д.А.

27.11.2018 Обновлено описание кода ошибки 192. MTSMON-2859 Аносов Д.А.

14.12.2018 Добавлен тип operation «легкий платеж». MTSMON-2784 Самосват


О.А.

14.12.2018 В метод getCardToEMTransferTerms.do добавлен опциональный параметр Самарин Ю.


srcPhone Н.

19.02.2019 Добавлено уточнение по поводу наличия поля confirmationType в комплексном Аносов Д.А.
типе данных operation

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 6 из 214
ООО «Рунет Бизнес Системы» :
:
01.03.2019 Добавлено описание API для MasterPass /masterpass/getBinding.do (в рамках Аносов Д.А.
MTSMON-3253)

06.03.2019 Добавлено описание API для MasterPass /masterpass/updateCardBindingData.do (в Аносов Д.А.


рамках MTSMON-3253)

06.03.2019 Удалено описание кодов ответов 247-266, 269-277, 279, 280. Данные коды Аносов Д.А.
относились у функционалу управления автоплатежами, которое уже давно было
вынесено за рамки ПЦ ЭК на сторону систем МТС.

12.03.2019 Удалено описание методов проверки номера телефона по одноразовому паролю. Аносов Д.А.
generateCustomerCheckOtp, validateCustomerCheckOtp, resendCustomerCheckOtp.
Т.к. перечисленные методы не реализованы.

18.03.2019 В описании комплексного типа operation добавлено описание новых полей Аносов Д.А.
isMasterPassOperation, masterPassMarkType, is3dsPerformed, isCvcProvided. (В
рамках MTSMON-3254)

04.04.2019 Добавлено описание API getProviderInfo.do (В рамках MTSMON-3291) Аносов Д.А.

09.04.2019 Добавлено описание поля autopaymentDisabled в описании структуры файла Аносов Д.А.
поставщиков (В рамках MTSMON-3248)

09.04.2019 Добавлено описание поля searchInvoicesв и блока invoiceSearchParams в Аносов Д.А.


описании структуры файла поставщиков (В рамках MTSMON-3072)

09.04.2019 Добавлено описание метода getGroupedPayments (В рамках MTSMON-3210) Аносов Д.А.

10.04.2019 Логический параметр isMasterPassOperation переделан на строковый Аносов Д.А.


masterpassOperationId (В рамках MTSMON-3352)

08.05.2019 В описании комплексного типа operation добавлен комментарий по поводу поля Аносов Д.А.
amount для операций VERIFY_PURCHASE

08.05.2019 Удалены описания более не используемых комплексных типов данных: Аносов Д.А.
apCreationData, apData, apState и apRemainderData

21.05.2019 В описании комплексного типа operation было добавлено поле Аносов Д.А.
operationPartnerName. (В рамках MTSMON-3397)

09.07.2019 В описании API getPaymentTerms.do, getXToYTransferTerms.do, payment.do и Аносов Д.А.


transferXToY.do добавлены опциональные параметры masterpassOperationId и
is3dsRequired. (В рамках MTSMON-3352)

09.07.2019 В описании API createCardBinding.do добавлен опциональный параметр Аносов Д.А.


masterpassOperationId. (В рамках MTSMON-3543)

23.07.2019 В описании API bindMtsBankCustomer.do добавлен опциональный параметр Аносов Д.А.


skipChangeIdentificationLevel. (В рамках MTSMON-3347)

12.08.2019 Добавлено описание состава типовых данных, возвращаемых в bindingsParams{} Тигулев М.В.
в ответе метода updateBankProducts

14.08.2019 Из справочника "Статусы операций" удален статус APPROVED, как не Тигулев М.В.
используемый. Успешный статус операции - DEPOSITED.

02.09.2019 Изменено назначение кода ошибки 113. Новое значение:"Для транзакции Тигулев М.В.
истекло разрешенное время отмены". Согласно доработке MTSMON-3671, эта
ошибка возникает, если отмена на оригинальную транзакцию направлена
позднее, чем через заданный промежуток времени.

10.10.2019 В рамках задачи MTSMON-3748 добавлен метод getMtsAccountBalance.do для Тигулев М.В.
получения баланса лицевого счета.

15.11.2019 Добавлены требования по использованию HTTP-заголовков. Тигулев М.В.

27.11.2019 В запрос getStatus добавлено поле mdOrder. Тигулев М.В.

17.12.2019 В рамках задачи MTSMON-3956 реализован интерфейс getPartners.do для Тигулев М.В.
запроса информации о партнерах.

18.12.2019 В рамках задачи MTSMON-3957 реализован интерфейс Тигулев М.В.


getPartnerByX509Token.do для получения информации о партнере по
предъявленному сертификату.
Изменена текстовая расшифровка для кода ошибки 20.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 7 из 214
ООО «Рунет Бизнес Системы» :
:
15.01.2020 В рамках задачи MTSMON-4002: Тигулев М.В.
- реализован интерфейс getBindingTypesForProvider.do для получения списка
доступных для ТСП ПИ.
- реализован интерфейс getUserBindingsForProvider.do для получения списка
доступных для пользователя кошелька ПИ.

17.01.2020 - Исправление опечаток. Тигулев М.В.


- В ответ на запрос refund.do добавлено поле "refundStatus".
- В запрос refund.do добавлен необязательный параметр
partnerRefundOperationId.

21.01.2020 Измененно описание кода ошибки errorCode = 115 на "Неверная сумма" Тигулев М.В.

13.02.2020 В рамках задачи MTSMON-3844 Тигулев М.В.


Добавлено новое поле в комплексный тип Binding expiresInLessThan

28.02.2020 В рамках задачи MTSMON-3238 в каталог платежей добавлены параметры для Тигулев М.В.
сопоставления параметров начисления клиента, которое получено из внешних
источников, соответствующим параметрам платежа в ПЦ ЭК.

05.03.2020 В рамках задачи MTSMON-4081 в каталог платежей добавлены параметры для Тигулев М.В.
микрокредитования.

12.03.2020 Добавлено описание метода /getAllPaymentsExtended Тигулев М.В.

19.03.2020 Скорректировано описание метода /getAllPaymentsExtended Тигулев М.В.

01.04.2020 Скорректировано описание метода /getTransferTargets Тигулев М.В.


Уточен порядок запроса ПИ-получателей в методе
/transferCardToBinding

15.04.2020 Добавлено расширенное описание типа binding для виртуальных карт, Тигулев М.В.
возвращаемого в ответ на запрос /virtulcard/list.do

16.04.2020 В рамках задачи MTSMON-3748 добавлены новые коды отказов 158, Тигулев М.В.
160 при получении баланса из МПТ

21.04.2020 В рамках задачи MTSMON-4253 в методах Тигулев М.В.


getCardToCardTransferTerms.do и transferCardToCard.do добавлена
поддержка параметра tokenizedTargetPan

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 8 из 214
ООО «Рунет Бизнес Системы» :
:
Содержание
1 Общие сведения.........................................................................................................................................................12
1.1 Назначение протокола..........................................................................................................................................12
1.2 Основные принципы.............................................................................................................................................12
1.3 Авторизация запросов...........................................................................................................................................13
1.4 Формат взаимодействия и описание примеров запросов..................................................................................13
2 Форматы и справочники данных.............................................................................................................................14
2.1 Стандартные справочники...................................................................................................................................14
2.2 Комплексные типы данных..................................................................................................................................24
3 Группа сервисов «Данные о партнерах».................................................................................................................38
3.1 getPartners – Запросить информацию о партнере...............................................................................................38
3.2 getPartnerByX509Token - Определить партнера по его сертификату..............................................................39
3.3 getBindingTypesForProvider – Доступные типы ПИ для платежной операции в пользу ТСП.......................41
3.4 getUserBindingsForProvider – Доступные ПИ пользователя кошелька для платежной операции в пользу
ТСП 43
4 Группа сервисов «Данные о поставщиках»............................................................................................................46
4.1 getServices – Получение базы поставщиков.......................................................................................................46
4.2 getProviderInfo – Получение информации о ТСП..............................................................................................52
4.3 getGroupedPayments – Получение базы поставщиков с учетом иерархической структуры групп платежей
53
5 Группа сервисов «Управление кошельками».........................................................................................................58
5.1 getWallet – Получение клиента............................................................................................................................58
5.2 getWalletByUserId – Получение клиента по идентификатору пользователя...................................................58
5.3 registerWallet – Создание кошелька.....................................................................................................................59
5.4 performSimplifiedIdentification – провести упрощенную идентификации.......................................................60
5.5 bindMtsBankCustomer – привязка клиента и инструментов МТС-Банка к ЭК...............................................61
5.6 unbindMtsBankCustomer – отвязка клиента и инструментов МТС-Банка к ЭК..............................................61
6 Группа сервисов «Платежные инструменты»........................................................................................................63
6.1 getBindings – Получение списка Платежных инструментов.............................................................................63
6.2 createCardBinding – Инициация регистрации карты..........................................................................................64
6.3 confirmCardBinding3ds – Подтверждение регистрации карты после 3DSecure..............................................67
6.4 confirmCardBindingByAmount – Подтверждение регистрации карты по сумме.............................................70
6.5 createCardBindingAfterPayment – Создание связки после платежа..................................................................72
6.6 createElectronicMoneyAccount – Открытие счета ЭДС......................................................................................74
6.7 updateBinding – Изменение параметров Платежного инструмента.................................................................76
6.8 deleteBinding – Удаление Платежного инструмента.........................................................................................77
6.9 getProductBindingWithBalance – Получение информации по привязанному платежному инструменту –
продукту Банка...............................................................................................................................................................78
6.10 updateBankProducts – обновление ПИ-продуктов Банка...................................................................................79
6.11 createCardBindingWoCheck – Привязка карты без проверки 3DS и верификационного платежа................81
6.12 getTechnicalAccountBalance – Получение баланса транзитного счета ЭДС....................................................82
6.13 getMtsAccountBalance.do - Получение информации о балансе лицевого счета, доступного для
электронной коммерции................................................................................................................................................83
7 Группа сервисов «Платежи»....................................................................................................................................85

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 9 из 214
ООО «Рунет Бизнес Системы» :
:
7.1 getPaymentTerms – Запрос расчета комиссии и лимитов на платеж................................................................85
7.2 payment – Произвести платеж или перевод........................................................................................................93
7.3 finish3ds – Завершить операцию с 3DSecure....................................................................................................103
7.4 confirmTransactionByOtp.do – Подтверждение операции одноразовым паролем.........................................105
7.5 reSendOtp.do – Повторная отправка одноразового пароля.............................................................................107
7.6 getPaymentStatus – Запрос состояния выполнения операции.........................................................................109
7.7 Поддержка технологии 3DSecure......................................................................................................................112
8 Группа сервисов «Переводы между ПИ».............................................................................................................114
8.1 getTransferTargets – Получение списка Платежных инструментов, доступных для использования в
качестве получателя платежа / перевода...................................................................................................................114
8.2 getBToBTransferTerms - Запрос проверки допустимости выбранного перевода и расчета комиссий в
случае перевода между привязанными к ЭК платежными инструментами..........................................................115
8.3 getCardToBTransferTerms - Запрос проверки допустимости выбранного перевода и расчета комиссий в
случае перевода с непривязанной карты на привязанный к ЭК платежный инструмент....................................120
8.4 getCardToEMTransferTerms - Запрос проверки допустимости выбранного перевода и расчета комиссий в
случае перевода с непривязанной карты на чужой счет ЭДС.................................................................................122
8.5 getBToEMTransferTerms - Запрос проверки допустимости выбранного перевода и расчета комиссий в
случае перевода с привязанного к ЭК платежного инструмента на чужой счет ЭДС.........................................125
8.6 getBToCardTransferTerms - Запрос проверки допустимости выбранного перевода и расчета комиссий в
случае перевода с привязанного к ЭК платежного инструмента на непривязанную карту.................................128
8.7 getCardToCardTransferTerms - Запрос проверки допустимости выбранного перевода и расчета комиссий
в случае перевода между непривязанными картами................................................................................................130
8.8 transferBindingToBinding - Операция перевода между привязанными к ЭК платежными инструментами
133
8.9 transferCardToBinding - Операция перевода с непривязанной карты на привязанный к ЭК платежный
инструмент...................................................................................................................................................................138
8.10 transferCardToEMoney - Операция перевода с непривязанной карты на чужой счет ЭДС........................141
8.11 transferBindingToEMoney - Операция перевода с привязанного к ЭК платежного инструмента на чужой
счет ЭДС.......................................................................................................................................................................143
8.12 transferBindingToCard - Операция перевода с привязанного к ЭК платежного инструмента на
непривязанную карту..................................................................................................................................................146
8.13 transferCardToCard – Операция перевода между непривязанными картами.................................................150
8.14 finish3dsTransfer - подтверждение перевода c помощью помощью 3ds........................................................152
8.15 confirmTransferByOtp - подтверждение перевода c помощью одноразового пароля...................................152
9 Пополнение ЭДС.....................................................................................................................................................153
9.1 emoneyTopUpCheck – проверка возможности внесения средств...................................................................153
9.2 emoneyTopUp - внесение средств......................................................................................................................154
9.3 emoneyTopUpReversal – отмена пополнения....................................................................................................155
9.4 emoneyTopUpStatus – проверка статуса пополнения.......................................................................................157
10 Интерфейс подключения ТСП...............................................................................................................................158
10.1 purchase - покупка..............................................................................................................................................158
10.2 refund – возврат...................................................................................................................................................160
10.3 reversal - отмена (для всех поддерживаемых типов операций)......................................................................162
10.4 getStatus - статус (для всех поддерживаемых типов операций).....................................................................163
10.5 confirmOTP – передача одноразового пароля, введенного клиентом............................................................164
11 Получение истории операций................................................................................................................................167
11.1 getOperationsHistory – запрос истории операций.............................................................................................167
11.2 getOperationDetails – деталей по операции.......................................................................................................172

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 10 из 214
ООО «Рунет Бизнес Системы» :
:
12 Группа сервисов «Электронная коммерция».......................................................................................................176
12.1 getECommercePurchaseTerms – запрос расчета комиссии и лимитов на e-commerce покупку...................176
12.2 eCommercePurchase – Произвести e-commerce покупку.................................................................................179
12.3 eCommercePurchaseByMdOrder – Произвести e-commerce покупку..............................................................182
13 Группа сервисов «Токенизация»...........................................................................................................................183
13.1 /mdes/getCardDataForTokenization – Расчет TAV.............................................................................................183
14 Группа сервисов «Переводы не клиентам»..........................................................................................................185
14.1 /transfer/ondemand/getTermsFromBinding – Запрос проверки допустимости и расчета комиссии для
перевода не клиенту с ПИ, привязанного к кошельку.............................................................................................185
14.2 /transfer/ondemand/getTermsFromCard – Запрос проверки допустимости и расчета комиссии для перевода
не клиенту с непривязанной карты............................................................................................................................187
14.3 /transfer/ondemand/executeByMdOrder – Запрос проведения перевода не клиенту с использованием
полученного ранее mdOrder........................................................................................................................................188
14.4 /transfer/ondemand/executeFromBinding – Запрос проведения перевода не клиенту с ПИ, привязанного к
кошельку.......................................................................................................................................................................191
14.5 /transfer/ondemand/executeFromCard – Запрос проведения перевода не клиенту с непривязанной карты.192
14.6 /transfer/ondemand/getIncoming – Запрос списка входящих переводов не клиентам....................................194
14.7 /transfer/ondemand/acceptToBinding – Получение входящего перевода на ПИ, привязанный к кошельку 195
14.8 /transfer/ondemand/acceptToCard – Получение входящего перевода на непривязанную карту...................197
14.9 /transfer/ondemand/acceptAsPayment – Получение входящего перевода как платеж....................................198
14.10 /transfer/ondemand/declineAccept – Отказ от входящего перевода получателем...................................200
14.11 /transfer/ondemand/cancel – Отмена перевода неклиенту отправителем................................................201
15 Группа сервисов «Управление виртуальными картами»....................................................................................204
15.1 /virtualcard/create.do – создать виртуальную карту и привязать ее к платежному инструменту.................204
15.2 /virtualcard/reCreateOnCompromised.do – перевыпустить виртуальную карту в случае компрометации. .204
15.3 /virtualcard/list.do – получить список виртуальных карт.................................................................................205
16 Группа сервисов «Платежи с использованием ApplePay/GooglePay/SamsungPay».........................................208
16.1 /tokenpayments/paymentWithApplePay.do – выполнить платеж с использованием ApplePay......................208
16.2 /tokenpayments/paymentWithGooglePay.do – выполнить платеж с использованием GooglePay..................211
16.3 /tokenpayments/paymentWithSamsungPay.do – выполнить платеж с использованием SamsungPay............213
17 Группа сервисов «Управление пользовательскими блокировками».................................................................217
17.1 /binding/addBindingBlockByCustomer.do – добавить полную пользовательскую блокировку....................217
17.2 /binding/removeBindingBlockByCustomer.do – убрать пользовательскую блокировку................................218
17.3 /binding/addBindingBlock.do – добавить блокировку.......................................................................................219
17.4 /binding/removeBindingBlock.do – убрать блокировку.....................................................................................220
17.5 /binding/getBindingBlockList.do – получить список бокировок для связки...................................................221
18 Вспомогательные операции...................................................................................................................................223
18.1 /sms/send.do – отправить SMS-сообщение........................................................................................................223
19 Информационные запросы.....................................................................................................................................224
19.1 /mobileoperator/getInfoMyMsisdn.do – получить информацию об операторе сотовой связи по переданному
номеру телефона..........................................................................................................................................................224
20 API для SMS переводов..........................................................................................................................................226
20.1 /smsapi/transfer.do – Произвести перевод..........................................................................................................226
21 API для MasterPass..................................................................................................................................................228
21.1 /masterpass/getBinding.do – Метод для получения ревкизитов карты............................................................228
21.2 /masterpass/updateCardBindingData.do – Метод для обновления ревкизитов карты.....................................229

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 11 из 214
ООО «Рунет Бизнес Системы» :
:
Имя файла: 521156780.docx Дата последней версии:
Разработчик Версия стр. 12 из 214
ООО «Рунет Бизнес Системы» :
:
1 Общие сведения

1.1 Назначение протокола


API для витрин и приложений предназначено для подключения к Процессинговому центру сервиса
«Электронный кошелек МТС Деньги» (далее – ПЦ ЭК) внешних систем удаленного обслуживания клиентов:
сайта dengi.mts.ru, витрин для приема платежей, системы мобильного приложения и т.п.

1.2 Основные принципы


Взаимодействие осуществляет по протоколу HTTPS.

1.2.1 Использование HTTP-заголовков


В целях повышения качества обслуживания, а также для облегчения диагностики ошибок, всем системам,
использующим настоящее API, необходимо использовать дополнительные параметры в HTTP-заголовках
запросов.
Параметр в заголовке Обязательность Описание
X-Request-Id Обязательный Уникальный идентификатор запроса, используется для
обеспечения идемпотентности ответов ПЦ ЭК на
запросы систем. Формируется по стандарту UUID без
дефисов.
Пример: X-Request-
Id="123e4567e89b12d3a456426655440000"

Параметр X-Request-Id должен быть уникальным


для каждого нового запроса к ПЦ ЭК и должен
повторяться при повторном обращении к ПЦ ЭК,
например, в случае таймаута ответа.

В качестве идентификатора допускается


использование значения partnerMdOrder.

При повторном обращении используется совместно с


параметром X-Repeated.
X-Repeated Опциональный Признак повторного сообщения, используется при
повторном обращении к ПЦ ЭК, например, в случае
таймаута ответа.
Параметр может принимать значения:
X-Repeated="true",
X-Repeated="false".

Отсутствие параметра эквивалентно значению


X-Repeated="false".
X-Phone Опциональный Номер телефона клиента, форматированный по стандарту
MSISDN, используется для разделения потоков по узлам
кластера.
Пример: X-Phone="79161234567"
Заполняется значением поля phone из тела запроса.
Параметр может отсутствовать для запросов, совершаемых
их неавторизованной зоны.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 13 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр в заголовке Обязательность Описание
Х-Transaction-Id Опциональный Идентификатор операции ПЦ ЭК, по которой формируется
повторное сообщение, либо запрашивается статус
выполнения.
Заполняется значением mdOrder из тела запроса.
Значение mdOrder возвращается узлом ПЦ ЭК в
ответе на первый запрос.
X-Node-Id Опциональный Номер узла ПЦ ЭК, который обработал запрос.
Возвращается узлом ПЦ ЭК в заголовке ответа на каждый
запрос.
Агрегатор должен получить параметр X-Node-Id,
сохранить его и использовать при последующих
обращениях к ПЦ ЭК в рамках одной бизнес-операции.

1.3 Авторизация запросов


Для авторизации запросов внешняя система, вызывающая сервисы ПЦ ЭК, должна использовать клиентский
сертификат, подписанный удостоверяющим центром CN=MTS SSL CA,O=Mobile TeleSystems OJSC,C=RU
Пример команды на генерацию CSR (запроса на получение сертификата)
openssl req -new -newkey rsa:2048 -keyout <system_name>.key -out <system_name>.csr -subj
"/C=RU/L=Moscow/O=<org_name>/CN=<system_name>"

Вызывающая система идентифицируется через используемое значение URL. При этом сертификат должен
соответствовать использованному значению. Этим объясняется отсутствие идентификации канала в
сообщениях, так как идентификация выполняется указанным способом.

1.4 Формат взаимодействия и описание примеров запросов


В документе все примеры методов приведены в формате таблиц простого вида.
Формат запроса
Содержимое ответа

Формат запроса указывается в виде GET. При этом в реальности поддерживается также обращение в формате
POST. Спецификация GET используется для облегчения представления примеров, а также рекомендуется для
использования в процессе тестирования ввиду простоты. В производственном окружении необходимо
использовать тип запроса POST ввиду того, что это не вызывать лишнего протоколирования параметров
запросов на серверах, что особенно важно при передаче секретных данных, например, номера карты. В
протоколе подразумевается, что ответное сообщение всегда идет с HTTP статусом 200.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 14 из 214
ООО «Рунет Бизнес Системы» :
:
2 Форматы и справочники данных

2.1 Стандартные справочники

2.1.1 bindingType - Типы платежных инструментов


ПЦ ЭК поддерживает следующие типы платежных инструментов

Таблица 1 Справочник "Типы платежных инструментов"


Код Описание

MTS_ACCOUNT Денежные средства на лицевом счете абонента МТС. Аванс за


услуги связи

BOUND_CARD Привязанная банковская карта стороннего банка (не МТС Банк)


Может быть картой МТС Банка в том случае, если пользователь не
осуществил в системе МТС Паспорт привязку профиля МТС к
своему профилю в МТС Банке

ANONYMOUS_CARD Непривязанная банковская карта. Этот код типа платежного


инструмента возвращается в ответе сервиса getPaymentTerms, если
для расчета комиссии был передан номер карты

EMONEY_ACCOUNT Электронные Денежные Средства (ЭДС) в системе Электронный


кошелек

GENERAL_CARD Карта МТС банка, без разделения на кредитную/дебетовую

EXTERNALLY_TOKENIZED_CARD Карта, токенизированная в сторонней системе (VTS/MDES)

BANK_ACCOUNT Счет в МТС банке

2.1.2 bindingStatus - Статусы платежных инструментов в кошельке


Отражает статус платежного инструмента в кошельке. Статус платежного инструмента в кошельке не отражает
состояние данного платежного средства на стороне эмитента. Например, в кошельке может находиться
активная банковская карта стороннего банка (bindingType="BOUND_CARD", bindingStatus = "0" Active), при
этом карта может быть заблокирована на стороне банка.

Таблица 2 Справочник "Статусы платежных инструментов"


Код Описание

0 Active Платежный инструмент подтвержден и может использоваться при оплате

1 Deactivated Платежный инструмент деактивирован клиентом

2 toVerify Платежный инструмент ожидает подтверждения клиентом

3 Archived Платежный инструмент архивирован ПЦ

2.1.3 issuerCategory - Тип эмитента


Категории эмитентов платежных инструментов

Таблица 3 Справочник "Типы эмитентов"


Код Описание

OWN Банковская карта МТС Банка

SIDED Банковская карта стороннего банка (не МТС Банк)

PARTNER Продукт партнера (на будущее)

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 15 из 214
ООО «Рунет Бизнес Системы» :
:
2.1.4 cardType - Тип банковской карты
Типы банковских карт

Таблица 4 Справочник "Типы банковских карт"


Код Описание

VISA Visa

MASTERCARD MasterCard

MAESTRO MasterCard Maestro

MIR НСПК МИР

2.1.5 cardStatus - Статус средства платежа на стороне эмитента


В дополнение к bindingStatus (п. 2.1.2), отражающему статус платежного инструмента в кошельке, справочник
cardStatus, описанный в настоящем разделе, отражает статус платежного средства на стороне эмитента.
Например, в кошельке может находиться активная банковская карта стороннего банка
(bindingType="BOUND_CARD", bindingStatus = "0" Active), при этом карта может быть заблокирована на
стороне банка.

Таблица 5 Справочник "Статусы платежных инструментов"


Код Описание

0 ACTIVE Средство платежа на стороне эмитента активно (или нет технической возможности
определить такой статус)

1 BLOCKED Средство платежа на стороне эмитента заблокировано

2.1.6 state - Статус операции


Операции в ПЦ ЭК могут находиться в различных статусах

Таблица 6 Справочник "Статусы операций"


Код Числово Платеж Описание
й код осуществлен?

CREATED 0 Нет Операция создана. Попыток совершения платежа


не было

DEPOSITED 2 Да Операция успешно выполнена


Расчеты произведены, и операция не может быть
отменена

REVERSED 3 Нет Операция отменена (была успешно выполнена и


отменена)

REFUNDED 4 Да По успешно выполненной операции был


осуществлен возврат (частичный или полный)

WAITING_CONFIRMATION 5 Нет Операция ожидает подтверждения со стороны


пользователя кошелька

DECLINED 6 Нет Операция отклонена

IN_PROGRESS 7 Нет Операция в процессе обработки

VOID 8 Нет Операция отменена клиентом. Используется,


например, если был неверный ввод параметров.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 16 из 214
ООО «Рунет Бизнес Системы» :
:
2.1.7 walletIdentificationLevel – Уровень идентификации клиента
Таблица 7 Справочник "Уровни идентификации клиента"
Код Описание

ANONYMOUS Клиент без идентификации.

SIMPLE_IDENTIFIED Клиент прошел процедуру упрощенной идентификации

FULL_IDENTIFIED Клиент полностью идентифицирован

2.1.8 errorCode – код ответа по операции


Код Описание

0 Удачная операция

1 Внутренняя ошибка

2 Нет сессии

4 Пустой идентификатор сессии

5 Неверный логин и пароль

6 Пустое имя пользователя

7 Неверное имя пользователя

8 Неуникальное имя пользователя

9 Пустой пароль

10 Неверный пароль, пароль не прошел проверку на сложность

11 Неверное имя

12 Пустое имя

13 Неверная фамилия

14 Пустая фамилия

15 Неверная электронная почта

16 Пустая электронная почта

18 Неверный телефон

19 Пустой телефон

20 Данные не найдены

21 Новый пароль неверный

23 Неверное имя пользователя или почта

24 Платеж отклонен

25 Отказ в аутентификации по алгоритму 3DSecure

26 Ошибка аутентификации по алгоритму 3DSecure

27 Пустой идентификатор связки (платежного инструмента)

29 Пустой номер карты

30 Неверный номер карты

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 17 из 214
ООО «Рунет Бизнес Системы» :
:
Код Описание

31 Пустая дата истечения срока действия карты

32 Неверная дата истечения срока действия карты

33 Пустое значение CVC2

34 Неверное значение CVC2

35 У карты истек срок действия

36 Неверное имя держателя карты

37 Ошибка проверки вовлечения в сервис 3DSecure

38 Пустой номер заказа

39 Неверный номер заказа

40 Пустая сумма

41 Неверная сумма

42 Код зарезервирован для использования в будущем

43 Все попытки подтверждения связки неуспешные (при подтверждении


прикрепляемой карты с помощью транзакции на случайную сумму)

44 Пустой номер поставщика услуг

45 Поставщик услуг не найден по уникальному номеру

46 Параметры поставщика услуг пустые

47 Параметры поставщика услуг неверные

48 Код зарезервирован для использования в будущем

49 Код зарезервирован для использования в будущем

51 Нельзя установить статус связки (платежного инструмента)

52 Код зарезервирован для использования в будущем

53 Неверное отчество

54 Мошенничество

55 Сумма меньше минимально разрешенной для сервиса

56 Сумма больше максимально разрешенной для сервиса

76 Неверный статус связки (платежного инструмента)

77 Пустая валюта

78 Недопустимая валюта, ошибка формата указания валюты или


использование валюта, не разрешенной для оплаты за оплачиваемый
сервис

79 Пустая текущая версия

80 Файл с фотографией пользователя слишком большой

81 Пустой код подтверждения

82 Код зарезервирован для использования в будущем

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 18 из 214
ООО «Рунет Бизнес Системы» :
:
Код Описание

83 Указан неверный пароль при входе в систему

84 При регистрации связки указано пустое значение для названия связки

85 Связка (платежный инструмент) уже есть в системе

86 Счет не найден

87 При подтверждении карточной связки с помощью случайной суммы


закончилось время, отведенное на эту процедуру (обычно сутки)

88 Повторный вызов вызова метода по mdOrder, если операция в этот


момент ожидает подтверждения (по 3DSecure или по One Time Password)

89 Некорректный тип ПИ. Тип ПИ не соответствует тому, что предусмотрен


конкретным методом.

90 ПИ типа виртуальная карта уже существует.

91 В результате вызова проверки проведения операции выяснилось, что у


кошелька нет платежных инструментов, доступных для выполнения
операции

92 Платеж не поддерживается поставщиком услуг

93 Все лимиты превышены

94 Превышен лимит на одну операцию

95 Превышен лимит на количество операций в день

96 Превышен лимит по сумме операций в месяц

97 Превышен лимит на количество операций в месяц

99 Указана неправильная случайная сумма при подтверждении


прикрепляемой карты с помощью транзакции на случайную сумму

100 Переданный идентификатор связки относится к ЭК другого пользователя

101 Связка не активна

102 Связка по умолчанию ошибочна

106 Попытка подтверждения неудачна

107 Все попытки подтверждения неудачны

108 С момента выпука предыдущей ВК прошло меньше дней, чем задано


настройками (при перевыпуске ВК в случае компрометации)

109 Пустое значение параметра ‘targetStatusName’ при вызова API


‘setWalletStatus.do’

110 Данные о мобильном операторе не найдены по заданному номеру


телефона (msisdn)

111 Запрещена оплата своей виртуальной картой

112 Запрещена оплата чужой виртуальной картой

113 Для транзакции истекло разрешенное время отмены

115 Неверная сумма

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 19 из 214
ООО «Рунет Бизнес Системы» :
:
Код Описание

119 Пользователь уже зарегистрирован

124 Код зарезервирован для использования в будущем

126 Не найден получатель

127 Код зарезервирован для использования в будущем

129 Код зарезервирован для использования в будущем

135 Код зарезервирован для использования в будущем

143 Неверный формат банковского идентификтаора

144 Дубликат мнемонического имени связки

145 Клиент банка не найден

146 Код зарезервирован для использования в будущем

147 Код зарезервирован для использования в будущем

149 Код зарезервирован для использования в будущем

150 Неверный банковский номер счета

151 Код зарезервирован для использования в будущем

152 Не найдет договор

153 Неверная связка для источника средств в операции перевода

154 Неверная связка для получателя средств в операции перевода

155 Связки не найдены

157 Истекло время применимости кода подтверждения

158 ЛС недоступен для МК

159 Номер карты отправителя совпадает с номером карты получателя

160 Баланс ЛС для МК не удалось определить

161 Неверная JSON спецификация рекурентной операции

162 Указано пустое расписание для рекуррентной операции

163 Указано неверное расписание для рекуррентной операции

164 Указано пустое описание для рекуррентной операции

166 Неверный идентификатор рекуррентной операции

167 Карта не найдена

168 Связка не найдена

180 Код зарезервирован для использования в будущем

190 Пустой идентификатор операции в партнерской системе

191 Парнерская система передала дубликат идентификатора операции

192 Не удалось проверить баланс ПИ-источника операции

196 Код зарезервирован для использования в будущем

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 20 из 214
ООО «Рунет Бизнес Системы» :
:
Код Описание

214 Код зарезервирован для использования в будущем

215 Код зарезервирован для использования в будущем

222 Пароль заблокирован (не может быть использован)

224 Пароль не существует

225 Отсутствует ЭК для данного номера телефона

226 Передан пустой идентификатор пользователя

227 Платеж поставщику услуг не разрешен

228 Транзакция отменена из-за изменения ЭК

229 Недостаточный уровень идентификации клиента

230 Пользователь уже идентифицирован

231 Нет доступных ПИ-получателей для перевода

232 Идентификатор ПИ-получателя отсутствует или пустой

233 ПИ-получатель не найден по указанному идентификатору

234 ПИ-получатель находится в недопустимом статусе

236 Недопустимый тип ПИ-получателя

237 Номер карты-получателя отсутствует или пустой

238 Номер карты-получателя недопустимый (не числовой или не проходит


проверку Луна)

239 Не определен ПИ-получатель перевода

240 Не найден кошелек-получатель по номеру телефона

241 У кошелька-получателя, соотвутствующего номеру телефона, нет


активного ПИ с типом ЭДС

243 Недопустимый тип ПИ списания для оплачиваемой услуги

244 Пустой или отсутствует параметр mtsBankCustId

245 Клиент банка с указанным mtsBankCustId не существует

267 Недопустимый тип перевода

268 У пользователя уже есть шаблон с указанными именем

278 Оплата указанного сервиса запрещена для частично заблокированного


пользователя

281 Недостаточно средств

282 Превышение лимита

283 Эмитент недоступен

284 Транзакция отклонена эмитентом

285 Статус ПИ не позволяет провести транзакцию

286 Транзакция не разрешена для ПИ

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 21 из 214
ООО «Рунет Бизнес Системы» :
:
Код Описание

287 Неверные настройки сервиса в процессинге

288 Состояния ПИ(-источника) не позволяет провести операцию

289 Состояния ПИ-получателя не позволяет провести операцию

290 Недостаточен уровень идентификации кошелька-получателя

291 Ошибка параллельного исполнения. Когда действие уже выполняется в


другом потоке/инстансе.

293 Для текущего кошелька есть неподтвержденные операции

294 Операция отменена пользователем

295 Операция отменена

296 Телефон получателя уже зарегистрирован (в переводах неклиентам)

297 Недопустимый статус перевода неклиенту (при подтверждении/отмене)

298 Недопустимый статус отправителя (при подтверждении получения


перевода неклиенту)

299 Недопустипый статус ПИ-отправилеля (при подтверждении получения


перевода неклиенту)

300 Поле uuid пустое или отсутствует (в запросе по переводу неклиенту)

301 Нельзя использовать bindingId=’ANONYMOUS_CARD’ при получении


перевода неклиенту

302 ПИ-источник не найден (при получении перевода неликнету)

303 Истек срок проведения перевода неклиенту

304 Сумма перевода меньше минимально допустимой

305 Сумма перевода больше максимально допустимой

306 Значение параметра aggregatorId отсутствует или пусто (для операций


электронной коммерции)
307 Недопустимое значение serviceId

308 Выполнение операции не разрешено

309 Недопустимое состояние кошелька

331 Ошибка проверки безопасности при проверке платежных данных


(ApplePay/GooglePay/SamsungPay)

332 Ошибка в платежных данных (ApplePay/GooglePay/SamsungPay)

333 Операция с такими платежными данными уже обработана


(ApplePay/GooglePay/SamsungPay)

340 Блокировка для данной связки, типа и источника уже существует

341 Блокировка для данной связки, типа и источника не существует

342 Недопустимое значение параметра «источник блокировки»

343 Ошибка при получении баланса ПИ

400 Недопустимый запрос

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 22 из 214
ООО «Рунет Бизнес Системы» :
:
Код Описание

404 Не найден обработчик для вызываемого метода API

911 Код зарезервирован для использования в будущем

912 Пользователь был заблокирован

913 Неверная версия API

914 Ошибка идентификации партнерской системы

915 Код зарезервирован для использования в будущем

916 Пользователь не найден по идентификатору

917 Запрошен неверный тип подтверждения

918 Транзакция не найдена

919 Транзакция находится в несовместимом статусе

920 Транзакция находится в неразрешенном состоянии

921 Указан пустой тип подтверждения

922 Указан пустой единовременный пароль

923 Пустое сообщение PaRes

925 Транзакция с указанным mdOrder соотвутствует другому ЭК

926 Сервис с указанным serviceId или транзакция с указанным mdOrder не


является платежем (является, например, переводом)

1001 Получен отказ от процессинговой системы

1002 Процессинговая система не отвечает

1003 Получен неожиданный код ответа от процессинговой системы

1004 Ошибка связи с процессинговой системой

2.1.9 Коды ответа, связанные с взаимодействием со сторонними системами


Код Описание
ДБО

3000 Любая ошибка от ДБО


Limit checker

5001 Ошибка при проверке лимита ЛС

5002 Проверка лимита ЛС: максимальная сумма платежа

5003 Проверка лимита ЛС: сумма оплаты в сутки

5004 Проверка лимита ЛС: сумма оплаты за неделю

5005 Проверка лимита ЛС: сумма оплаты за месяц

5006 Проверка лимита ЛС: незавершённые операции

5007 Проверка лимита ЛС: минимальная сумма платежа

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 23 из 214
ООО «Рунет Бизнес Системы» :
:
5008 Проверка лимита ЛС: количество платежей в сутки
Платежный агрегатор

20999 Ошибка общего характера

20998 Ошибка общего характера при выполнении проверки платежа

20997 Ошибка общего характера при выполнении проведения платежа

20996 Ошибка при формировании запроса к платежнопу агрегатору

20995 Ошибка при разборе ответа от платежного агрегатора


ЕСПП Foris

10100 Сервис недоступен

10101 Истекло время, отведённое на возврат части аванса

10102 Техническая недоступность сервиса

10200 Некорректный формат входных данных

10201 Неизвестный номер телефона получателя возврата

10202 Невозможно определить биллинг банка.

10203 Невозможно произвести технологический откат возврата аванса, так как


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

10204 Невозможно произвести отказ от возврата аванса, так как не найдена


исходная операция возврата аванса.

10205 Невозможно выдать список учетных операций, так как не все операции
завершены.

10206 Невозможно выдать список учетных операций, так как операции не


найдены.

10210 Биллинг: не найден указанный ЛС банка или ПО.

10211 Биллинг: абонент не является физ. лицом

10212 Биллинг: анонимный абонент


10213 Биллинг: на ПО есть запрещенные блокировки

10214 Биллинг: у абонента есть признак «запрет возврата части аванса»

10215 Биллинг: у получателя возврата отсутствует разрешение на передачу


персональных данных

10216 Биллинг: недостаточно средств для проведения операции.

10217 Биллинг: неправильно указана сумма – зарезервировано для будущего


использования

10218 Биллинг: операция с указанным номером отсутствует в системе.

10219 Биллинг: указанная сумма меньше или равна 0.

10220 Биллинг: операция с указанным номером найдена, но сумма


зарегистрированной операции не совпадает с переданной суммой

10999 Ошибка общего характера

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 24 из 214
ООО «Рунет Бизнес Системы» :
:
Система банка (через MQ)

30000 Ошибка общего характера при взаимодействии с системой банка

30001 Неуспешный ответ от системы банка

30002 Таймаут получения ответа от системы банка

30003 Недопустимый ответ от системы банка


МТС-Банк (через MQ)

40000 Не указан или пустой идентификатор транзакции

40001 Невозможно найти транзакцию по переданному идентификатору

40002 Запрос содержит данные недостаточные для выполнения операции

40003 Недопустимый ответ от системы банка

40004 Неверный формат номера карты в сообщении МТС Банка

40005 Тайм-аут получения ответа от сервиса МТС-банка

40099 Ошибка общего характера


Взаимодействие с модулем автоплатежей

50000 Ошибка общего характера

50001 Сервис вернул ошибку ServiceUnavailable

50002 Параметры АП вне пределов допустимых значений

50003 Превышен лимит на количество АП у пользователя

2.1.10 walletStatus – статус кошелька


Значение Описание

ACTIVE Активен

BLOCKED Заблокирован

PARTIALLY_BLOCKED Частично заблокирован

2.1.11 apCondition – условие автоплатежа


Значение Описание

THRESHOLD Использование автоплатежа по порогу

SCHEDULE Использование автоплатежа по расписанию

2.1.12 Трансляция кодов отказа Tieto


Значение Описание

70 XXX Ошибки общего характера

71 XXX Ошибки по дебетовым операциям

72 XXX Ошибки по кредитным операциям

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 25 из 214
ООО «Рунет Бизнес Системы» :
:
ХХХ – описание значений ошибок приведенs в соотвествующей спецификации Tieto (5.14).

2.2 Комплексные типы данных

2.2.1 amount – тип данных, описывающий возвращаемые значения сумм


Тип используется для представления суммы операции в случае известного значения комиссии. Обычно
используется при возврате результатов расчета комиссий.

Параметр Тип данных Размер Обязательность Описание

base Положительно 9,2 Обязательный Запрошенная клиентом


е число, два сумма операции без учёта
знака после комиссий
запятой

total Положительно 9,2 Обязательный Итоговая сумма


е число, два транзакции, возвращенная
знака после процессингом, включая
запятой сумму комиссии

fee Положительно 9,2 Необязательный Сумма комиссии


е число, два Возвращается, если
знака после комиссия была посчитана
запятой в процессинге

currency Целое 3 Обязательный Валюта заказа


положительное
число

currencyCode Текст 3 Обязательный Буквенный код валюты


заказа

2.2.2 binding – тип данных, описывающий параметры платежного инструмента


Понятие связки (binding) является эквивалентом понятия «платежный инструмент» в системе ПЦ ЭК.
Комплексный тип данных используется для предоставления вовне информации о связках, то есть платежных
инструментах.

Параметр Тип данных Размер Обязательность Описание

bindingId UUID 32 Опциональный Уникальный


идентификатор
Платежного
Обязательный для инструмента (ПИ)
своих ПИ

mnemonic Текст 100 Опциональный Мнемоническое имя


ПИ, заданное
пользователем
Обязательный для
своих ПИ

createdDate Дата/время Формат – Опциональный Дата регистрации


ДД/ММ/ГГГГ Платежного
ЧЧ: ММ:СС инструмента (в ПЦ
ЭК)

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 26 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

updatedDate Дата/время Формат – Опциональный Дата последнего


ДД/ММ/ГГГГ обновления
ЧЧ: ММ:СС Платежного
инструмента
Равна дате создания,
если с момента
создания карта не
была изменена

isDefaultBinding Да/Нет true/false Опциональный Признак, является


ли платежный
инструмент
используемым по
умолчанию

bindingType Текст 100 Опциональный Тип платежного


Возможные инструмента.
значения в п.2.1.1 Обязательный для
своих ПИ

bindingStatus Текст 50 Опциональный Статус Платежного


Возможные инструмента в ПЦ
значения в п. 2.1.2 ЭК

balance Число с двумя 9,2 Опциональный Баланс доступных


знаками после средств на
запятой Платежном
инструменте
(если известен)

currency Целое 3 Опциональный Валюта платежного


положительное инструмента
число

bindingParams{} Набор параметров - Условный Набор


дополнительных
признаков карты
Обязательный, если в
запросе было
запрошено
отображение
дополнительных
параметров карты,
привязанной к
профилю

сolor Текст Формат – (r, g, Условный Цвет карты,


b), где r, g и b присвоенный
имеют значение пользователем
от 0 до 255 Обязательный, если в
запросе было Если карта
запрошено привязана без
отображение указания цвета, она
дополнительных имеет цвет по
параметров карты, умолчанию (серый)
привязанной к

minAmount Положительное 9,2 Опциональный Минимальная


число, два знака сумма перевода.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 27 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

после запятой

maxAmount Положительное 9,2 Опциональный Максимальная


число, два знака сумма перевода.
после запятой

cardId Целое 12 Опциональный Идентификатор


положительное карты для типов
число связки
GENERAL_CARD и
BOUND_CARD

limitsInfo Тип limitsInfo - Опциональный Информация о


лимитах ПИ

Для bindingType=MTS_ACCOUNT, EMONEY_ACCOUNT набор параметров может дополняться следующими


параметрами

phoneNumber Текст 11 Обязательный Номер телефона

userId Целое 21 Опциональный Идентификатор


положительн кошелька
ое число

maskedPhoneNumber Текст 10 Обязательный Маскированный номер


телефона, например,
79166**98

Для bindingType = BOUND_CARD, GENERAL_CARD набор параметров дополняется следующими


параметрами:

maskedPan Текст 16-19 Обязательный Маскированный номер


карты (первые 6 и
последние 4 цифры
номера карты в виде
123456**1234)

expiry Текст Формат – Опциональный Год и месяц действия


YYYYMM карты

expiresInLessThan Число 3 Опциональный Параметр содержит


количество дней до
истечения срока
действия карты

cardType Текст 10 Опциональный Тип карты


Возможные
значения
п. 2.1.4

cardStatus Текст 50 Опциональный Статус карты


Возможные
значения:
0 = ACTIVE
1 = BLOCKED
(заблокирована по

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 28 из 214
ООО «Рунет Бизнес Системы» :
:
требованию МТС,
истёк срок
действия и т.п.)

is3DSecureBinding Текст true/false Опциональный Флаг, показывающий,


вовлечена ли карта в
технологию 3DS

2.2.3 serviceParams – тип данных, описывающий параметры платежа


Комплексный тип данных используется для передачи списка параметров платежа поставщику услуг.

Тип данных Размер Обязательность Описание


Параметр

name Текст 100 Обязательный Идентификатор


параметра,
уникален в рамках
используемого
сервиса

value Текст 1000 Обязательный Значение параметра

2.2.4 providerReceiptParams – тип данных, описывающий параметры для отбражения


на чеке
Комплексный тип данных используется для передачи списка параметров, полученных от поставщика услуги,
для печати на чеке.

Тип данных Размер Обязательность Описание


Параметр

name Текст 100 Обязательный Идентификатор


параметра,
уникален в рамках
используемого
сервиса

value Текст 1000 Обязательный Значение параметра

2.2.5 currencyAmount – сумма с валютой


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

Параметр Тип данных Размер Обязательность Описание

Amount Положительно 9,2 Обязательный Сумма без учёта комиссий


е число, два
знака после
запятой

currency Целое 3 Обязательный Валюта заказа


положительное
число

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 29 из 214
ООО «Рунет Бизнес Системы» :
:
2.2.6 schedule – расписание событий
Комплексный тип данных используется при задании расписания совершения автоплатежей.

Параметр Тип данных Размер Обязательность Описание

time Строка 8 Обязательный Время срабатывания


времени расписания:
ЧЧ:MM:CC (([01][0-9])|(2[0-3]))(:[0-5]
[0-9]){2}

timeZone Строка 6 Обязательный Временная зона,


относительно которой
указано время:
(\+|-)(00|01|02|03|04|05|06|
07|08|09|10|11|12|13|14|15|
16|17|18|19|20|21|22|23):[0-
5][0-9]

type Строка 100 Обязательный Тип расписания,


возможные значения:
DATE – платеж в
указанную дату,
PERIOD – периодический
платеж через
фиксированное количество
дней,
DOW – платеж в
фиксированный день
недели,
DOM – платеж в
фиксированный день
месяца.

date Дата Формат – Опциональный, Дата начала действия


ДД/ММ/ГГГГ обязательно автоплатежа
присутствие,
если type =
DATE

period Целое 3 Опциональный, Период выполнения


положительное обязательно платежей в днях. Значения
число присутствие, от 1 до 180.
если type =
PERIOD

dayOfWeek Целое 1 Опциональный, День недели выполнения


положительное обязательно платежа.
число присутствие, 1 – понедельник,
если type = DOW
2 – вторник,
3 – среда,
4 – четверг,
5 – пятница,
6 – суббота,

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 30 из 214
ООО «Рунет Бизнес Системы» :
:
7 – воскресенье.

dayOfMonth Целое 2 Опциональный, Номер дня выполнения


положительное обязательно платежа в месяце.
число присутствие,
если type = DOM

2.2.7 transferOnDemandData – данные о переводе неклиенту


Комплексный тип данных используется для передачи данных о переводах неклиентам.

Параметр Тип данных Размер Обязательность Описание

uuid UUID 32 Обязательный Уникальный


идентификатор перевода
неклиенту

date Дата/время Формат – Обязательный Дата/время создания


ДД/ММ/ГГГГ перевода неклиенту
ЧЧ: ММ:СС

expiresAt Дата/время Формат – Обязательный Дата/время до которого


ДД/ММ/ГГГГ перевод неклиенту может
ЧЧ: ММ:СС быть принят получателем

status Строковый 32 Обязательный Статус перевода:


CREATED – создан
WAITING_CONFIRMATI
ON – ожидает
подтверждения
FINISHED - исполнен
EXPIRED - просровен
CANCELLED_BY_SENDE
R – отменет отправителем
CANCELLED_BY_RECIPI
ENT – отклонен
получателем

sourcePhoneNum Целое 11 Опциональный Номер мобильного


ber положительное телефона отправителя
число перевода
Отображается
для получателя

targetPhoneNumb Целое 11 Опциональный Номер мобильного


er положительное телефона получателя
число перевода
Отображается
для отправителя

amount Числовой Формат – Опциональный Сумма перевода


ДД/ММ/ГГГГ
ЧЧ: ММ:СС
Отображается
для получателя в
списке входящих
переводов

currency Числовой 3 Опциональный Валюта перевода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 31 из 214
ООО «Рунет Бизнес Системы» :
:
Отображается
для получателя в
списке входящих
переводов

comment Текст 200 Опциональный Пользовательский


комментарий для операции
Отображается
для получателя в
списке входящих
переводов

2.2.8 serviceData – данные об оплачиваемом сервисе


Параметр Тип данных Размер Обязательность Описание

serviceId Текст 10 Обязательный Идентификатор сервиса

serviceName Текст 200 Опциональный Название сервиса

category Текст 50 Опциональный Тип категории сервиса

categoryName Текст 200 Опциональный Название категории сервиса

serviceParams[] Массив - Опциональный Список параметров платежа


записей с
типом
serviceParams

providerReceiptP Массив - Опциональный Список параметров,


arams записей с полученных от поставщика
типом услуги, для печати на чеке
providerReceip
tParams

2.2.9 operation – данные об операции


Комплексный тип данных используется для передачи данных об операциях в ответах финансовых операций
(платеж, перевод и т.д.) и при получении истории.

Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

state Целое 10 Обязательный Состояние заказа (см.


положителье справочник)
число

transactionErrorC Целое Опциональный Код завершения обработки


ode положительное операции (см. справочник
число errorCode)

date Дата, время ДД/ММ/ГГГГ Обязательный Дата и время совершения


чч:мм:сс операции

refNum Текст Опциональный Номер ссылки из


процессинга

refnum Текст Опциональный Номер ссылки из


процессинга

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 32 из 214
ООО «Рунет Бизнес Системы» :
:
Данное поле
дублирует
значение поля
refNum. Поле
добавлено для
обратной
совместимости и
будет удалено в
ближайшее
время!

approvalCode Текст Опциональный Код авторизации

authCode Текст Опциональный Код авторизации

Данное поле
дублирует
значение поля
approvalCode.
Поле добавлено
для обратной
совместимости и
будет удалено в
ближайшее
время!

operationType Текст Обязательный Тип операции:


PAYMENT
TRANSFER
PURCHASE
TOP_UP
TRANSFER_ON_DEMAND
VERIFY_PURCHASE

direction Текст 3 Опциональный Направление операции


относительно кошелька.
OUT – на чужие ПИ.
Указывается
только для IN – с чужих ПИ.
переводов. INNER – между своми ПИ.

amount Набор - Обязательный Денежные параметры


параметров. операции.
Комплексный Для операций
тип amount. VERIFY_PURCHASE
вместо реальной cуммы
операции возвращается
нулевая сумма.

srcBinding Набор - Опциональный Параметры платежного


параметров. инструмента – источника
Комплексный перевода.
тип binding. Может
отсутствовать в В случае, если ПИ
случае принадлежит другому
пополнения кошельку, набор
счета ЭДС возвращаемых данных
(TOP_UP). Для ограничен.
обеспечения

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 33 из 214
ООО «Рунет Бизнес Системы» :
:
обратной
совместимости
данное поле
будет
возращаться
пустым даже для
операций, где по
бизнес-смыслу
нет ПИ
списания, но это
будет убрано в
ближайшее
время.

srcParentBinding Набор Опциональный Параметры родительского


параметров. платежного инструмента
Комплексный для ПИ источника перевода.
тип binding. Присутствует
только для ПИ,
прикрепленным
к другим ПИ
(например,
VIRTUAL_CAR
D)

dstBinding Набор - Опциональный Параметры платежного


параметров. Присутствует в инструмента – получателя
Комплексный случае перевода.
тип binding. переводов и В случае, если ПИ
пополнений. принадлежит другому
кошельку, набор
возвращаемых данных
ограничен.

dstParentBinding Набор Опциональный Параметры родительского


параметров. платежного инструмента
Комплексный для ПИ получателя
тип binding. Присутствует перевода.
только для ПИ,
прикрепленным
к другим ПИ
(например,
VIRTUAL_CAR
D)

transferType Текст 32 Опциональный Тип перевода


Присутствует в
случае
переводов

transferOnDeman Набор Опциональный Данные о переводе не


dData параметров. Присутствует в клиенту
Комплексный случае
тип – переводов не
transferOnDe клиентам
mandData.

service Набор - Опциональный Краткая информация об


параметров. Присутствует в оплаченной услуге
Комплексный случае платежей
тип –

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 34 из 214
ООО «Рунет Бизнес Системы» :
:
serviceData.

comment Текст 200 Опциональный Пользовательский


комментарий для операции

bonusPoints Целое 9 Опциональный Количество бонусных


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

confirmationType Текст 32 Опциональный Способ подтверждения


Возвращается операции:
только для FINISH_3DS
операций, OTP_PAYMENT_PAGE
которые
ожидают OTP_SMS_CALLBACK
подтверждения

otpExpiresAt Дата, время ДД/ММ/ГГГГ Опциональный Дата и время, до которых


чч:мм:сс Возвращается, операция может быть
если подтверждена
confirmationType пользователем.
равен
OTP_PAYMENT
_PAGE или
OTP_SMS_CAL
LBACK.

PaReq Текст URL Опциональный Параметр для проведения


Обязательный, процедуры 3DSecure
если карта Присутствует если
вовлечена в confirmationType=
программу 3DS FINISH_3DS и означает, что
карта вовлечена в 3DSecure

acsUrl Текст 2000 Опциональный URL-адрес банка эмитента


Обязательный, (сервер ACS), на который
если карта клиент должен быть
вовлечена в перенаправлен.
программу 3DS

convertedAmount Комплексный - Опциональный Сконвертированная сумма


тип операции
convertedAmo
unt

masterpassOperati Строковый - Опциональный Идентификатор операции


onId Может MasterPass
присутствовать
только в ответах

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 35 из 214
ООО «Рунет Бизнес Системы» :
:
API
getOperationsHist
ory.do и
getOperationDetai
ls.do

masterPassMarkT Строковый Значения: Опциональный Тип маркировки


ype full/partial Может авторизационного запроса
присутствовать для операций MasterPass
только в ответах
API
getOperationsHist
ory.do и
getOperationDetai
ls.do, если это
операция
MasterPass

is3dsPerformed Логический - Опциональный Флаг, показывающий, что


(true/false) Может тразакция проводилась с
присутствовать использованием 3DS.
только в ответах Значение true будет
API возвращаться, если карта-
getOperationsHist источник вовлечена в 3DS.
ory.do и
getOperationDetai
ls.do

isCvcProvided Логический - Опциональный Флаг, показывающий, что


(true/false) Может при вызове API было
присутствовать передано значение
только в ответах CVV2/CVC2.
API
getOperationsHist
ory.do и
getOperationDetai
ls.do

operationPartnerN Строковый 100 Опциональный Клиентское название


ame Может партнера, через которого
присутствовать была инициирована
только в ответах операция. Если по каким-
API либо причинам партнера
getOperationsHist найти не удалось, будет
ory.do и возвращено значение
getOperationDetai “UNKNOWN”
ls.do

2.2.10 user – данные пользователя (кошелька)


Комплексный тип данных используется для передачи данных пользователе (кошельке).

Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

walletIdentificatio Текст 50 Обязательный Уровень идентификации


nLevel клиента. Возможные

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 36 из 214
ООО «Рунет Бизнес Системы» :
:
значения см.п.2.1.7

status Текст 50 Обязательный Статус кошелька, см. 2.1.10

phone Целое 15 Обязательный Номер мобильного телефона


положительное пользователя в
число международном формате
MSISDN

createdDate Дата и время ДД/ММ/ГГГГ Обязательный Дата и время создания


ЧЧ:ММ:СС кошелька

bankUserId Текст 100 Опциональный. Идентификатор


пользователя в системе
банка (RBO_ID)
Может
присутствовать
для полностью
идентифицирова
нных кошельков
(FULL_IDENTIF
IED)

2.2.11 bindingBlock – данные блокировки связки


Комплексный тип данных используется для передачи данных о блокировке ПИ.

Параметр Тип данных Размер Обязательност Описание


ь

bindingId UUID 32 Обязательный Уникальный


идентификатор ПИ

uuid Текст 64 Опциональный Уникальный


идентификатор
блокировки

source Текст 64 Обязательный Источник блокировки


(USER/SYSTEM)

externalBlockId Текст 64 Опциональный Внешний идентификатор


блокировки

blockType Текст 64 Обязательный Тип блокировки


(FULL/PARTIAL)

reasonCode Текст 64 Опциональный Код причины блокировки


в свободной форме

reason Текст 255 Опциональный Причина блокировки в


свободной форме

startDateTime Дата и время ДД/ММ/ГГГГ Обязательный Время применения


ЧЧ:ММ:СС блокировки

blockEndSource Текст 64 Опциональный Источник разблокировки


(USER/SYSTEM)

blockEndExternalId Текст 64 Опциональный

blockEndReasonCode Текст 64 Опциональный Код причины


разблокировки в
свободной форме

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 37 из 214
ООО «Рунет Бизнес Системы» :
:
blockEndReason Текст 255 Опциональный Причина разблокировки в
свободной форме

blockEndDateTime Дата и время ДД/ММ/ГГГГ Опциональный Время отмены блокировки


ЧЧ:ММ:СС

2.2.12 convertedAmount – данные сконвертированной суммы операции


Комплексный тип данных используется для передачи данных о сконвертированной сумме операции.

Параметр Тип данных Размер Обязательност Описание


ь

amount Положительн - Обязательный Сумма в целевой валюте


ое число с
запятой

currency Строка (3 3 Обязательный Цифровой код целевой


цифры) валюты

rate Положительн - Обязательный Курс сонвертации


ое число с
запятой

unit Положительн - Опциональный Единица конвертации


ое число с
запятой

2.2.13 amountInfo – данные о сумме денег


Комплексный тип данных для передачи суммы денег (сумма + валюта)

Параметр Тип данных Размер Обязательност Описание


ь

amount Положительн - Обязательный Сумма


ое число с
запятой

currency Строка (3 3 Обязательный Цифровой код валюты


цифры)

2.2.14 limitsInfo – данные о лимитах платежного инструмента


Комплексный тип данных используется для передачи данных о лимитах платежного инструмента.

Параметр Тип данных Размер Обязательност Описание


ь

balanceLimit amountInfo - Обязательный Лимит баланса ПИ в


соответствии с уровнем
идентификации
пользователя

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 38 из 214
ООО «Рунет Бизнес Системы» :
:
3 Группа сервисов «Данные о партнерах»

3.1 getPartners – Запросить информацию о партнере


Метод предназначен для предоставления информации о партнере по его идентификатору ( PARTNER.NAME), либо
для получения информации о всех партнерах, если идентификатор партнера не указан.

3.1.1 Запрос
HTTP path /{path}/{version}/{partner}/getPartners.do
где:
{version} Версия API
{partner} Наименование партнера, который выполняет обращение

HTTP method POST или GET

Content-Type application/x-www-form-urlencoded

Параметр Тип Размер Обяз. Описание


partnerName Текст Опциональный Партнер из каталога ПЦ ЭК - PARTNER.NAME

partnerType Текст Опциональный Тип партнера:


- INTERFACE
- SERVICE_PROVIDER
Если не указан, то фильтрация по типу партнера
не выполняется

3.1.2 Ответ
Параметр Тип Размер Обяз. Описание
partners Комплексный Опциональный Информация о партнерах из
тип каталога ПЦ ЭК. Присутствует,
если запрос выполнен успешно
(errorCode = 0)
partner Комплексный Опциональный Информация о партнере
тип Присутствует, если в каталоге
есть хотя бы 1 партнер
соответствующий условиям
запроса
fullName Текст Опциональный Полное наименование партнера -
PROVIDER.FULL_NAME
desc Текст Опциональный Название партнера для
отображения клиенту -
_PROVIDER.CLIENT_NAME
type Текст Опциональный Тип партнера:
- INTERFACE
- SERVICE_PROVIDER

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 39 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип Размер Обяз. Описание
serviceProviderId Число Опциональный Идентификатор сервис-
провайдера. Заполняется только
для партнеров с типом
SERVICE_PROVIDER
errorCode Текст Обязательный 0, если запрос выполнен
успешно,
≠0 – в противном случае: партнер
с указанными в запросе
параметрами не найден в ПЦ ЭК
Если ни одного партнер не
найдено, будет возвращен код
ошибки - 20
(NO_DATA_FOUND).
errorMessage Текст Опциональный Расшифровка кода ответа для
клиента. Указывается, если
запрос не выполнен
(errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание кода
ответа для обслуживающего
персонала. Указывается, если
запрос не выполнен
(errorCode≠0)
errorCause Текст Опциональный Расшифровка кода ответа для
обслуживающего персонала.
Указывается, если запрос не
выполнен (errorCode≠0)

Коды результатов (errorCode)


Значение Описание
0 Успех (запрос выполнен)
20 Партнер не найден
1 Некорректный формат или параметры запроса

3.1.3 Пример. Запрос данных партнера по PARTNER.NAME


http://mts.rbsdev.com/ewallet/3.4/mts/getPartners.do?partnerName=4test

{"partners":[{"name":"4test","fullName":"4test","desc":"Тестовая
витрина","type":"INTERFACE"}],"errorCode":0}

3.1.4 Пример. Запрос данных партнеров по PARTNER.TYPE


http://mts.rbsdev.com/ewallet/3.4/mts/getPartners.do?partnerType=INTERFACE

{"partners":[{"name":"4test","fullName":"4test","desc":"Тестовая
витрина","type":"INTERFACE"},
{"name":"AVP_MTSRetail","fullName":"AVP_MTSRetail","type":"INTERFACE"}],"errorCode":0}

3.1.5 Пример. Ошибка запроса по PARTNER.TYPE


http://mts.rbsdev.com/ewallet/3.4/mts/getPartners.do?partnerType=1234

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 40 из 214
ООО «Рунет Бизнес Системы» :
:
{"errorCode":1,"errorMessage":"Внутренняя ошибка","errorMessageDesc":"Внутренняя
ошибка","errorCause":"Invalid partnerType"}

3.1.6 Пример. Ошибка запроса по PARTNER.NAME


http://mts.rbsdev.com/ewallet/3.4/mts/getPartners.do?partnerName=1234

{"errorCode":20,"errorMessage":"Данные не найдены","errorMessageDesc":"Данные не
найдены","errorCause":"Partner not found by provided partnerName"}

3.2 getPartnerByX509Token - Определить партнера по его сертификату


Метод предназначен для предоставления информации о партнере по его сертификату.

3.2.1 Запрос
HTTP path /{path}/{version}/{partner}/getPartnerByX509Token.do
где:
{version} Версия API
{partner} Наименование сервиса, который выполняет обращение

HTTP method POST или GET

Content-Type application/x-www-form-urlencoded

Параметр Тип Обяз. Описание


token Текст Обязательный Сертификат (формат PEM)

3.2.2 Ответ
HTTP status code 200 OK

Content-Type application/json

Параметр Тип Размер Обяз. Описание


errorCode Число Обязательный Результат выполнения запроса: 0 –
запрос выполнен; ≠0 – в противном
случае
errorMessage Текст Опциональный Расшифровка кода ответа для клиента.
Указывается, если запрос не выполнен
(errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание кода ответа
для обслуживающего персонала.
Указывается, если запрос не выполнен
(errorCode≠0)
errorCause Текст Опциональный Расшифровка кода ответа для
обслуживающего персонала.
Указывается, если запрос не выполнен

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 41 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип Размер Обяз. Описание

(errorCode≠0)
partner Текст Опциональный Информация о партнере. Указывается,
если запрос выполнен (errorCode=0)
name Текст Обязательный Идентификатор партнера
fullName Текст Опциональный Полное наименование партнера
clientName Текст Опциональный Наименование партнера для
отображения пользователям

Коды результатов (errorCode)


Значение Описание
0 Успех (запрос выполнен)
20 Проверка сертификата не пройдена (некорректный сертификат;
или партнер не найден; или сертификат не действителен)
1 Некорректный формат запроса

3.2.3 Пример. Успешный запрос данных партнера по сертификату


http://mts.rbsdev.com/ewallet/3.4/mts/getPartnerByX509Token.do?token={token}

{"partner":{"name":"4test","fullName":"4test","desc":"Тестовая
витрина","type":"INTERFACE"},"errorCode":0}

3.2.4 Пример. Ошибка - пустой токен


http://mts.rbsdev.com/ewallet/3.4/mts/getPartnerByX509Token.do?token=

{"errorCode":1,"errorMessage":"Внутренняя ошибка","errorMessageDesc":"Внутренняя
ошибка","errorCause":"token is blank"}

3.2.5 Пример. Ошибка - партнер не найден по сертификату


http://mts.rbsdev.com/ewallet/3.4/mts/getPartnerByX509Token.do?token=1234

{"errorCode":20,"errorMessage":"Данные не найдены","errorMessageDesc":"Данные не
найдены","errorCause":"Partner not found by provided token"}

3.3 getBindingTypesForProvider – Доступные типы ПИ для платежной операции в


пользу ТСП
Метод предназначен для предоставления информации о доступных для ТСП платежных инструментах, с
которых ТСП может принимать оплату.

3.3.1 Запрос
HTTP path /{path}/{version}/{partner}/getBindingTypesForProvider.do
где:

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 42 из 214
ООО «Рунет Бизнес Системы» :
:
{version} Версия API
{partner} Наименование партнера, который выполняет обращение

HTTP method GET или POST

Content-Type application/x-www-form-urlencoded

Параметр Тип Размер Обяз. Описание


providerId Текст Обязательный Идентификатор ТСП (PROVIDER.EXTERNAL_ID
в каталоге ПЦЭК)
providerSpId Текст Обязательный Идентификатор сервис-провайдера (агрегатора), к
которому относится ТСП
(SERVICE_PROVIDER.ID в каталоге ПЦЭК)

3.3.2 Ответ
HTTP status code 200 OK Запрос обработан сервисом

Content-Type application/json

Content Содержит структуру в формате JSON, поля которой описаны ниже. Указывается в
случае, если запрос был обработан сервисом (200 OK)

Параметр Тип Размер Обяз. Описание


errorCode Текст Обязательный 0, если запрос выполнен
успешно,
≠0 – в противном случае.
errorMessage Текст Опциональный Расшифровка кода ответа для
пользователя. Указывается,
если запрос выполнен
неуспешно (errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание
кода ответа для
обслуживающего персонала.
Указывается, если запрос не
выполнен (errorCode≠0)
errorCause Текст Опциональный Расшифровка кода ответа для
обслуживающего персонала.
Указывается, если запрос
выполнен неуспешно
(errorCode≠0)

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 43 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип Размер Обяз. Описание
bindingTypes[] Текст Опциональный Список типов ПИ, доступных
для платежных операций в
пользу указанного ТСП.
Например: MTS_ACCOUNT
(Привязанный ЛС абонента
МТС), EMONEY_ACCOUNT
(Привязанный счет ЭДС),
BOUND_CARD (Привязанная
карта), GENERAL_CARD
(Привязанная карта МТС
Банка), ANONYMOUS_CARD
(Непривязанная карта).
Полный перечень приведен в
API ПЦЭК для витрин и
приложений, п.2.1.1
(bindingType)

3.3.3 Коды результатов (errorCode)


Значение Описание
0 Успех (запрос выполнен успешно)
45 ТСП не найдено по комбинации переданных параметров
400 Некорректный запрос, если не передан какой-нибудь из обязательных параметров или значение
недопустимо (например, не-число, когда ожидается целочисленное значение)

3.3.4 Пример. Успешный запрос


http://mts.rbsdev.com/ewallet/3.4/mts/getBindingTypesForProvider.do?
providerId=1&providerSpId=-3

{"bindingTypes":
["MTS_ACCOUNT","ANONYMOUS_CARD","BOUND_CARD","GENERAL_CARD","EMONEY_ACCOUNT","EXTERNALLY_
TOKENIZED_CARD"],"errorCode":0}

3.3.5 Пример. Ошибка в параметрах запроса


http://mts.rbsdev.com/ewallet/3.4/mts/getBindingTypesForProvider.do?partnerName=4test

{"errorCode":400,"errorCause":"Parameter 'providerId'(providerExternalId) is blank"}

3.3.6 Пример. Ошибка. Поставщик не найден по параметрам


http://mts.rbsdev.com/ewallet/3.4/mts/getBindingTypesForProvider.do?
providerId=1&providerSpId=1

{"errorCode":45,"errorMessage":"Поставщик услуг не найден по уникальному


номеру","errorMessageDesc":"Поставщик услуг не найден по уникальному
номеру","errorCause":"Provider not found"}

3.4 getUserBindingsForProvider – Доступные ПИ пользователя кошелька для платежной


операции в пользу ТСП
Метод предназначен для предоставления информации о доступных для пользователя кошелька платежных
инструментах, с которых пользователь может оплачивать товары / услуги заданного ТСП.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 44 из 214
ООО «Рунет Бизнес Системы» :
:
3.4.1 Запрос
HTTP path /{path}/{version}/{partner}/getUserBindingsForProvider.do
где:
{version} Версия API
{partner} Наименование партнера, который выполняет обращение

HTTP method GET или POST

Content-Type application/x-www-form-urlencoded

Параметр Тип Размер Обяз. Описание


userId Текст Обязательный Идентификатор пользователя кошелька
providerId Текст Обязательный Идентификатор ТСП (PROVIDER.EXTERNAL_ID
в каталоге ПЦ ЭК)
providerSpId Текст Обязательный Идентификатор сервис-провайдера (агрегатора), к
которому относится ТСП
(SERVICE_PROVIDER.ID в каталоге ПЦ ЭК)

3.4.2 Ответ

HTTP status code 200 OK Запрос обработан сервисом

Content-Type application/json

Content Содержит структуру в формате JSON, поля которой описаны ниже. Указывается в
случае, если запрос был обработан сервисом (200 OK)

Параметр Тип Размер Обяз. Описание


errorCode Текст Обязательный 0, если запрос выполнен
успешно,
≠0 – в противном случае.
errorMessage Текст Опциональный Расшифровка кода ответа для
пользователя. Указывается, если
запрос выполнен неуспешно
(errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание кода
ответа для обслуживающего
персонала. Указывается, если
запрос не выполнен
(errorCode≠0)
errorCause Текст Опциональный Расшифровка кода ответа для
обслуживающего персонала.
Указывается, если запрос
выполнен неуспешно
(errorCode≠0)

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 45 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип Размер Обяз. Описание
bindings[] Текст Опциональный Ранжированный список ПИ
указанного пользователя
кошелька, доступных для
платежных операций в пользу
указанного ТСП. Указывается,
если запрос выполнен успешно
(errorCode=0). Если у
указанного пользователя
кошелька нет ПИ, доступных
для платежных операций в
пользу указанного ТСП, список
пустой (bindings[]). Каждый
элемент списка представляет
собой объект с двумя полями:
index Обязательный Порядковый номер ПИ в
списке. ПИ пронумерованы в
порядке убывания приоритета,
т.е. наиболее приоритетный ПИ
(binding) имеет наименьший
порядковый номер (index)
binding Обязательный Информация о ПИ.
Комплексный тип, полный
перечень его полей приведен в
п.2.2.2 (binding)

3.4.3 Коды результатов (errorCode)


Значение Описание
0 Успех (запрос выполнен успешно)
45 ТСП не найдено по комбинации переданных параметров
400 Некорректный запрос, если не передан какой-нибудь из обязательных параметров или значение
недопустимо (например, не-число, когда ожидается целочисленное значение)
916 Код возвращается, если пользователь не найден по переданному userId

3.4.4 Пример. Успешный запрос


http://mts.rbsdev.com/ewallet/3.4/mts/getUserBindingsForProvider.do?
providerId=1&providerSpId=-3&userId=1
{"bindings":[{"index":1,"binding":
{"bindingId":"855A5025D883492B84BFFC78EBD18D9E","mnemonic":"Phone
79152719306","createdDate":"03/04/2017 12:20:51","updatedDate":"05/04/2017
11:00:18","isDefaultBinding":true,"bindingType":"MTS_ACCOUNT","bindingStatus":0,"currency
":"643","bankStatus":"UNKNOWN","phoneNumber":"79152719306","maskedPhoneNumber":"7915**06"
}},{"index":2,"binding":{"bindingId":"A2C9572567F846F9AED133173B216360","mnemonic":"Мой
кошелек","createdDate":"03/04/2017 12:21:09","updatedDate":"05/04/2017
11:00:18","isDefaultBinding":false,"bindingType":"EMONEY_ACCOUNT","bindingStatus":0,"curr
ency":"643","limitsInfo":{"balanceLimit":
{"amount":"15000,00","currency":"643"}},"bankStatus":"UNKNOWN","phoneNumber":"79152719306
","maskedPhoneNumber":"7915**06"}}],"errorCode":0}

3.4.5 Пример. Ошибка в параметрах запроса


http://mts.rbsdev.com/ewallet/3.4/mts/getUserBindingsForProvider.do?

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 46 из 214
ООО «Рунет Бизнес Системы» :
:
providerId=1&providerSpId=-3
{"errorCode":400,"errorCause":"Parameter 'userId' is blank"}

3.4.6 Пример. Ошибка. Поставщик не найден по параметрам


http://mts.rbsdev.com/ewallet/3.4/mts/getUserBindingsForProvider.do?
providerId=2&providerSpId=-3&userId=1

{"errorCode":45,"errorMessage":"Поставщик услуг не найден по уникальному


номеру","errorMessageDesc":"Поставщик услуг не найден по уникальному
номеру","errorCause":"Provider not found"}

3.4.7 Пример. Ошибка. Пользователь не найден по идентификатору


http://mts.rbsdev.com/ewallet/3.4/mts/getUserBindingsForProvider.do?
providerId=1&providerSpId=-3&userId=-1

{"errorCode":916,"errorMessage":"Пользователь не найден по
идентификатору","errorMessageDesc":"Пользователь не найден по
идентификатору","errorCause":"USER_NOT_FOUND_BY_ID"}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 47 из 214
ООО «Рунет Бизнес Системы» :
:
4 Группа сервисов «Данные о поставщиках»
4.1.1 getServices – Получение базы поставщиков
По запросу getServices ПЦ проверяет требуется ли Витрине обновление базы поставщиков и возвращает ссылку
(URL) на актуальную базу
Витрина должна анализировать значение параметра actual. Если значение параметра false, то Витрина должна
обновить базу поставщиков. Платформа всегда возвращает полный перечень параметров в составе файла
поставщиков.

4.1.2 Запрос
Параметр Тип данных Размер Обязательность Описание

currentVersion Текст 50 Обязательный Текущая версия


локальной базы
поставщиков в
Формат – версия приложении
представляет собой
число вида 1.00, 2.00 При первом
обращении «0.0»

4.1.3 Ответ
Параметр Тип данных Размер Обязательность Описание

actual Да/Нет true/false Обязательный Признак, обнаружена


ли новая версия базы
поставщиков на
сервере
true = локальная
версия совпадает с
версией на сервере
false = локальная
версия отличается от
версии на сервере

downloadUrl Текст 2000 Обязательный Ссылка для


скачивания новой
версии базы
поставщиков

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа
Необязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Пользователя;
Не обязательный
для errorCode=0

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 48 из 214
ООО «Рунет Бизнес Системы» :
:
4.1.4 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getServices.do?currentVersion=0.1
{"updateRequired":false,"downloadUrl":"https://mts.rbsdev.com/ewallet2/3.4/mts/providers.
do","actual":false,"errorCode":0}

Пример файла поставщиков

getServices.rar

4.1.5 Структура файла поставщиков


version Версия файла поставщиков

iconsURL Адрес ресурса хранения иконок категорий и поставщиков

categories[] Данные о категории поставщиков

categoryName Наименование категории поставщиков

categoryTitle Отображаемое имя для категории поставщиков

icon Относительный адрес файла с картинкой для категории

number Количество поставщиков, отображаемых на странице выбора


поставщика без обращения к перечню всех поставщиков

categoryHidden Признак, говорящий о необходимости скрывать категорию из


пользовательского интерфейса

providers[] Данные о поставщике

id Уникальный идентификатор поставщика в Платформе

providerName Наименование поставщика

subline Наименование ЮЛ

icon Относительный адрес файла с картинкой для поставщика

regions[] Перечень кодов регионов, в которых доступно проведение платежей по


поставщику.
Пустой, если в адрес поставщика доступны для всех регионов.

amount[] Данные о максимальных и минимальных лимитах платежа по


поставщику, используемые для контроля ввода данных

min Минимальная сумма платежа без комиссии в коzпейках

max Максимальная сумма платежа без комиссии в копейках

autopaymentDisabled Флаг, разрешено ли для данного платежа создавать авто-платежи

searchInvoices Флаг, что для данного платежа возможен поиск начислений

allowedPayByQrCode Параметр указывает возможность оплаты с помощью QR-кода

creditAllowed Флаг, показывающий, возможно ли применение микрокредитования для


платежа (true/false)

providerMtsCategoryId Номер категории МТС у ТСП

inn ИНН поставщика

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 49 из 214
ООО «Рунет Бизнес Системы» :
:
kpp КПП поставщика

params[] Данные о параметрах, необходимых для выполнения платежа в пользу


поставщика

paramTitle Отображаемое имя параметра для выполнения платежа

paramName Наименование параметра для выполнения платежа

paramType Тип параметра

paramDescription Описание параметра платежа (подсказка для отображения


пользователю). Может быть пустым.

paramHidden Признак, говорящий о необходимости скрывать параметр в UI для


заполнения пользователем:
 true = не отображается
 false или параметр отсутствует = отображается
При значении параметра, равном true, параметр не будет отрисован в
интерфейсе приложением автоматически. Может быть пустым.

maxLength Максимальная длина параметра

defaultValue Значение по умолчанию. Может быть пустым.

paramMask Маска ввода. Может быть пустым.

reference Справочник, на который ссылается параметр. Используется только для


paramType = ComboBox. Используется для формирования списков и
передачи id элементов из соответствующего справочника. Может быть
пустым.

readOnly Признак вывода параметра на витрину в режиме "только для чтения".

required Признак обязательности заполнения параметра клиентом на витрине

aliases[] Псевдонимы для параметров в разных источниках начислений

invoiceProviderCode код источника начислений

alias псевдоним параметра в рамках источника начислений

displayOrder Число, задает порядок отображения параметра на витрине


serverValidation Признак возможности обращения к серверной функции для валидации
параметра:
 true = серверная функция для валидации параметра существует
 false = серверная функция для валидации параметра отсутствует

regExp Правила валидации введенного пользователем значения параметра на


основе регулярных выражений

invoiceSearchParams [] Данные о параметрах, необходимых для поиска начичлений.


Аналогичны блоку params[]

receiptParams[] Данные о параметрах, для отображения на чеке

paramTitle Отображаемое имя параметра

paramName Наименование параметра

paramDescription Описание параметра (подсказка для отображения пользователю). Может


быть пустым.

allowedSrcTypes[] Перечень типов платежных инструментов, которые можно использовать

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 50 из 214
ООО «Рунет Бизнес Системы» :
:
для оплаты данной услуги

eCommercePurchaseCategories [] Данные о категории e-commerce поставщиков


Структура аналогична структуре categories[]

references[] Используемые справочники

regions[] Данные справочника и его наименование (в данном случае справочник


регионов)

id Ключ значения справочника (в данном случае код региона)

value Наименование значения (в данном случае наименование региона)

4.1.6 paramType - Типы параметров в базе поставщиков


Значение Описание Валидация на стороне сервера

StringField Последовательность символов Сервер принимает любую последовательность


символов, удовлетворяющих regexp

NumberField Цифры Сервер принимает любую последовательность


цифр, удовлетворяющих regexp. Используется
для целочисленных и дробных значений.
Разделитель дробной части – «,» (запятая).

EmailField Адрес электронной почты (в Сервер принимает любую последовательность


соответствии с общими символов, удовлетворяющих regexp, и
установленными требованиями к гарантирует, что regexp будет проверять строку
формату адресов электронной почты) на соответствие формату email-адреса

DateField Дата в формате DD/MM/YYYY Сервер принимает строку в формате


DD/MM/YYYY HH:MM:SS
DateMonthField Дата в формате MM/YYYY
Если нет секунд, то они заменяются значением
DateTimeField Время в формате DD/MM/YYYY «00».
HH:MM Если нет минут и часов, то они заменяются
значением «00:00».
Если нет дня, то он заменяется значением «01».

Пример для формата:


DateField (нет часов и минут) – «06/07/2013
00:00:00»
DateMonthField (нет дней) – «01/07/2013
00:00:00»
DateTimeField (нет секунд) – «03/04/2013
06:14:00»

CheckBox Чекбокс Сервер принимает true или false

PhoneField Номер телефона Сервер принимает любую последовательность


символов, удовлетворяющих regexp, и
гарантирует, что regexp будет содержать только
+[0-9] и пробелы

PasswordField Пароль Сервер принимает любую последовательность


символов, удовлетворяющих regexp. Клиент
может скрывать вводимые пользователем

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 51 из 214
ООО «Рунет Бизнес Системы» :
:
символы.

ComboBox Список Сервер принимает id одного элемента из


справочника

4.2 getProviderInfo – Получение информации о ТСП


Данный запрос может использоваться Витриной получения информации о ТСП.

4.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

serviceProviderId Число 19 Обязательный Номер идентификатор


агрегатора, к которому
относится ТСП

providerId Строка 64 Обязательный Уникальный


идентификатор ТСП в
разрезе агрегатора

4.2.2 Ответ
Параметр Тип данных Размер Обязательность Описание

icon Строка - Опциональный Относительный адрес


Обязательный, файла с картинкой для
если errorCode = 0 ТСП

name Строка - Опциональный Наименование ТСП


Обязательный,
если errorCode = 0

subline Строка - Опциональный Наименование ЮЛ ТСП


Обязательный,
если errorCode = 0

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

4.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getWallet.do?
serviceProviderId=-1
&providerId=test
{
"icon": "a",
"name": "TEST",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 52 из 214
ООО «Рунет Бизнес Системы» :
:
"subline": "OOO TEST",
"errorCode": 0
}

4.3 getGroupedPayments – Получение базы поставщиков с учетом иерархической


структуры групп платежей
Данный метод можно использовать вместо метода /providers.do для получения справочника платежей с учетом
иерархической структуры групп платежей. В новой структуре справочника один и тот же платеж может
входить в несколько групп. В группе может не быть платежей, но быть подгруппы, и наоборот. Групп без
платежей и без подгрупп быть не должно.

4.3.1 Структура файла поставщиков


version Версия файла поставщиков

iconsURL Адрес ресурса хранения иконок категорий и поставщиков

paymentGroups[] Список групп платежей

name Наименование группы платежей

icon Относительный адрес файла с картинкой для категории

number Количество платежей в группе

groupHidden Признак, говорящий о необходимости скрывать группу из


пользовательского интерфейса

subGroups[] Список подгрупп, входящих в группу

payments[] Данные о платежах в группе

id Уникальный идентификатор поставщика в Платформе

providerName Наименование поставщика

subline Наименование ЮЛ

icon Относительный адрес файла с картинкой для поставщика

regions[] Перечень кодов регионов, в которых доступно проведение платежей по


поставщику.
Пустой, если в адрес поставщика доступны для всех регионов.

amount[] Данные о максимальных и минимальных лимитах платежа по поставщику,


используемые для контроля ввода данных

min Минимальная сумма платежа без комиссии в копейках

max Максимальная сумма платежа без комиссии в копейках

autopaymentDisabled Флаг, разрешено ли для данного платежа создавать авто-платежи

searchInvoices Флаг, что для данного платежа возможен поиск начислений

allowedPayByQrCode Параметр указывает возможность оплаты с помощью QR-кода

creditAllowed Флаг, показывающий, возможно ли применение микрокредитования для


платежа (true/false)

providerMtsCategoryId Номер категории МТС у ТСП

inn ИНН поставщика

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 53 из 214
ООО «Рунет Бизнес Системы» :
:
kpp КПП поставщика

params[] Данные о параметрах, необходимых для выполнения платежа в пользу


поставщика

paramTitle Отображаемое имя параметра для выполнения платежа

paramName Наименование параметра для выполнения платежа

paramType Тип параметра

paramDescription Описание параметра платежа (подсказка для отображения пользователю).


Может быть пустым.

paramHidden Признак, говорящий о необходимости скрывать параметр в UI для


заполнения пользователем:
 true = не отображается
 false или параметр отсутствует = отображается
При значении параметра, равном true, параметр не будет отрисован в
интерфейсе приложением автоматически. Может быть пустым.

maxLength Максимальная длина параметра

defaultValue Значение по умолчанию. Может быть пустым.

paramMask Маска ввода. Может быть пустым.

reference Справочник, на который ссылается параметр. Используется только для


paramType = ComboBox. Используется для формирования списков и
передачи id элементов из соответствующего справочника. Может быть
пустым.

readOnly Признак вывода параметра на витрину в режиме "только для чтения".

required Признак обязательности заполнения параметра клиентом на витрине

aliases[] Псевдонимы для параметров в разных источниках начислений

invoiceProviderCode код источника начислений

alias псевдоним параметра в рамках источника начислений

displayOrder Число, задает порядок отображения параметра на витрине


serverValidation Признак возможности обращения к серверной функции для валидации
параметра:
 true = серверная функция для валидации параметра существует
 false = серверная функция для валидации параметра отсутствует

regExp Правила валидации введенного пользователем значения параметра на


основе регулярных выражений

invoiceSearchParams [] Данные о параметрах, необходимых для поиска начичлений. Аналогичны


блоку params[]

receiptParams[] Данные о параметрах, для отображения на чеке

paramTitle Отображаемое имя параметра

paramName Наименование параметра

paramDescription Описание параметра (подсказка для отображения пользователю). Может


быть пустым.

allowedSrcTypes[] Перечень типов платежных инструментов, которые можно использовать

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 54 из 214
ООО «Рунет Бизнес Системы» :
:
для оплаты данной услуги

eCommercePurchaseCategories [] Данные о категории e-commerce поставщиков


Структура аналогична структуре categories[] для «обычного» справочника
поставщиков

references[] Используемые справочники

regions[] Данные справочника и его наименование (в данном случае справочник


регионов)

id Ключ значения справочника (в данном случае код региона)

value Наименование значения (в данном случае наименование региона)

4.4 getAllPaymentsExtended – Получение полного списка платежей в системе


Данный метод можно использовать вместо метода /providers.do для получения справочника платежей.
Особенность метода - выводит плоский список всех платежей, имеющихся в системе, без учета их видимости
партнеру, вызывающему метод. Также список не учитывает категории и группы.

4.4.1 Структура данных


Структура данных для единичного платежа в списке - идентична структуре для платежа в выводе метода
providers.do, за исключением дополнительного агрегата "visibleToPartners" в группе params[].

payments[] Данные о платежах в группе

params[] Данные о параметрах, необходимых для выполнения платежа в пользу


поставщика

visibleToPartners[]

names Список партнеров, которым доступен данный платеж

4.4.2 Пример. Структура агрегата visibleToPartners


http://mts.rbsdev.com/ewallet/3.4/mts/getAllPaymentsExtended.do

"visibleToPartners": [
"android",
"likebank",
"USSD_portal",
"w1viber",
"autopayment",
"mobimoney",
"MTSRetail",
"ios",
"mts",
"ussd"
],

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 55 из 214
ООО «Рунет Бизнес Системы» :
:
5 Группа сервисов «Управление кошельками»

5.1 getWallet – Получение клиента


Данный запрос должен использоваться Витриной для проверки наличия профиля (электронного кошелька)
пользователя по номеру телефона и получения его идентификатора.

5.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона пользователя в
число международном формате
MSISDN

5.1.2 Ответ
Параметр Тип данных Размер Обязательность Описание

user* Набор полей из - Данные пользователя


комплексного (кошелька)
типа user.

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

5.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getWallet.do?phone=79169998877
{
"userId": "00000000100000001555",
"walletIdentificationLevel": "SIMPLE_IDENTIFIED",
"status": "ACTIVE",
"phone": "79169998877",
"createdDate": "24/06/2016 15:39:10",
"errorCode": 0
}

5.2 getWalletByUserId – Получение клиента по идентификатору пользователя


Данный запрос может использоваться для получения информации о пользователе (кошельке) по
идентификатору пользователя (кошелька).

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 56 из 214
ООО «Рунет Бизнес Системы» :
:
5.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Целое 32 Обязательный Уникальный


положительное идентификатор
число пользователя (кошелька)

5.2.2 Ответ
Аналогичен ответу для метода getWallet.

5.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getWalletByUserId.do?
userId=00000000100000001555
{
"userId": "00000000100000001555",
"walletIdentificationLevel": "FULL_IDENTIFIED",
"status": "ACTIVE",
"phone": "79169998877",
"createdDate": "24/06/2016 15:39:10",
"bankUserId": "111",
"errorCode": 0
}

5.3 registerWallet – Создание кошелька


Запрос выполняется для регистрации электронного кошелька.

5.3.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона
число пользователя в
международном
формате MSISDN

5.3.2 Ответ
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

errorCode Целое 2 Обязательный Код ответа


положительное Равен 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа
Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Пользователя;
Не обязательный
для errorCode=0

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 57 из 214
ООО «Рунет Бизнес Системы» :
:
5.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/registerWallet.do?phone=79161234567
{
"userId": "CUI178770451",
"walletIdentificationLevel": "ANONYMOUS",
"status": "ACTIVE",
"errorCode": 0
}

5.4 performSimplifiedIdentification – провести упрощенную идентификации


Запрос применяется для проведения упрощенной идентификации клиента - физического лица, владельца
элетронного кошелька. В текущей версии сервиса упрощенная идентификация проводиться через сервис МТС,
который проводит процедуру на основании данных, которые клиент предоставил МТС в рамках договора на
оказание услуг связи.

5.4.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

5.4.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа
Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Пользователя;
Не обязательный
для errorCode=0

5.4.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/performSimplifiedIdentification.do?
userId=00000000100000001593
{"errorCode":0}

5.5 bindMtsBankCustomer – привязка клиента и инструментов МТС-Банка к ЭК


Запрос выполняется для связывания электронного кошелька с клиентом МТС-Банка. Это означает полную
идентификацию клиента и доступность в электронном кошельке всех платежных инструментов МТС-Банка.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 58 из 214
ООО «Рунет Бизнес Системы» :
:
5.5.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mtsBankCustId Текст 32 Обязательный Уникальный


идентификатор
клиента МТС-Банка

skipChangeIdentificationLeve Логический true/false Опциональный Флаг,


l отключающий
увеличение уровня
идентификации
кошелька до
FULL_IDENTIFIED

5.5.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа
Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Пользователя;
Не обязательный
для errorCode=0

5.5.3 Пример (пользователь уже привязан)


https://mts.rbsdev.com/ewallet/3.4/mts/bindMtsBankCustomer.do?
userId=00000000100000001353&mtsBankCustId=1234567890
{"errorCode":309,"errorCause":"Bank user already bound"}

5.5.4 Пример (успешная привязка)


https://mts.rbsdev.com/ewallet/3.4/mts/bindMtsBankCustomer.do?
userId=00000000100000001353&mtsBankCustId=1234567890
{"errorCode": 0}

5.6 unbindMtsBankCustomer – отвязка клиента и инструментов МТС-Банка к ЭК


Запрос выполняется для отвязки электронного кошелька от клиента МТС-Банка. Помимо непосредственно
отвязки также деактивируются и становятся недоступными для проведения операций карты, подтянутые из
МТС-банка для данного клиента.

5.6.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 59 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

идентификатор
пользователя

5.6.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа
Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Пользователя;
Не обязательный
для errorCode=0

5.6.3 Пример (пользователь не привязан)


https://mts.rbsdev.com/ewallet/3.4/mts/unbindMtsBankCustomer.do?
userId=00000000100000001353
{"errorCode":309,"errorCause":" Bank user id (rbo id) is not defined"}

5.6.4 Пример (успешная отвязка)


https://mts.rbsdev.com/ewallet/3.4/mts/unbindMtsBankCustomer.do?
userId=00000000100000001353
{"errorCode": 0}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 60 из 214
ООО «Рунет Бизнес Системы» :
:
6 Группа сервисов «Платежные инструменты»

6.1 getBindings – Получение списка Платежных инструментов


Получение списка Платежных инструментов, подключенных к кошельку
Запрос поддерживает возможность выборки карт по указанному статусу или нескольким статусам. В этом
случае в параметре bindingStatus необходимые статусы должны быть перечислены через запятую.
Существует возможность использовать дополнительные признаки карты, привязанной к профилю. Для начала
использования каждого нового дополнительного признака необходимо согласование формальных требований к
хранению и использованию этого признака между представителем компании-разработчика
витрины/приложения и представителей БПЦ.
Примером дополнительного признака является «Цвет карты» (color). Параметр передается и хранится как код
цвета в формате RGB – (r, g, b), где r, g и b имеют значение от 0 до 255.

6.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

bindingStatus Текст 50 Опционально Если параметр не


указан, выводятся
все карты во всех
статусах
Допускается поиск
по нескольким
статусам
одновременно –
статусы разделяются
запятой
Коды статус
приведены в п. 2.1.2

bindingParams[] Набор параметров - Необязательный Набор


дополнительных
признаков карты

color Текст Формат – (r, g, Необязательный Цвет Платежного


b), где r, g и b инструмента,
имеют значение присвоенный
от 0 до 255 пользователем.
Значения по-
умолчанию не
имеет.

6.1.2 Ответ
Параметр Тип данных Размер Обязательность Описание

bindings[] Набор параметров. - Обязательный Параметры


Комплексный тип платежных
binding. инструментов в
кошельке.
Возвращаются
записи по всем
инструментам в

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 61 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

кошельке.

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

6.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getBindings.do?
userId=00000000100000001353
{"bindings":[{"bindingId":"82B1BD604CDA42EF9FD1A42AC3EF575D","mnemonic":"Phone
79169998877","createdDate":"16/08/2016 18:40:18","updatedDate":"16/08/2016
18:40:18","isDefaultBinding":false,"bindingType":"MTS_ACCOUNT","bindingStatus":0,"curre
ncy":"643","cardType":0,"bankStatus":"UNKNOWN","phoneNumber":"79169998877","maskedPhone
Number":"7916**77"}],"errorCode":0}

6.2 createCardBinding – Инициация регистрации карты

6.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

pan Текст 19 Обязательный Номер карты

expiry Целое 6 Обязательный Год и месяц


положительное Формат – действия карты
число YYYYMM

cardholderName Текст 100 Опциональный Имя держателя


карты

cvc Целое 4 Опциональный СVC-код


положительное Может не содержать
число данных, если оплата
производится
картой Maestro

В остальных
случаях должен
содержать данные

mnemonic Текст 100 Обязательный Мнемоническое имя

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 62 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

карты

isDefaultBinding Да/Нет true/false Опциональный Признак, говорящий


о желании
пользователя
использовать
регистрируемую
карту по умолчанию
при платежах

bindingParams[] Набор параметров - Необязательный Набор


дополнительных
признаков карты

masterpassOperationI Текст 200 Опциональный Идентификатор


d операции в
MasterPass

6.2.2 Ответ
Параметр Тип данных Размер Обязательность Описание

confirmationType Текст 50 Обязательный Возможные значения


FINISH_3DS – карта
вовлечена в
3DSecure, для
привязки нужно
пройти авторизацию
VERIFY_AMOUNT
– карта не вовлечена
в 3DSecure, для
привязки нужно
передать случайную
сумму

mdOrder Текст 50 Опциональный Уникальный номер


Присутствует, операции в ПЦ ЭК
если
confirmationType =
FINISH_3DS

createdBindingId UUID 32 Опциональный Уникальный


Присутствует, идентификатор ПИ
если
confirmationType =
VERIFY_AMOUN
T

paReq Текст - Условный Параметр для


проведения
процедуры 3DSecure
Присутствует,
если карта Если присутствует в
вовлечена в ответе, то карта
программу 3DS вовлечена в 3DSecure

acsUrl Текст 2000 Условный URL-адрес банка


эмитента (сервер
ACS), на который

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 63 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

Присутствует, клиент должен быть


если карта перенаправлен
вовлечена в
программу 3DS

bindings[] Набор параметров. - Условный Параметры


Комплексный тип платежных
binding. инструментов в
Присутствует, кошельке.
если Возвращаются записи
confirmationType = по всем
VERIFY_AMOUN инструментам в
T кошельке.

errorCode Целое положительное 3 Обязательный Код ответа


число 0 если ошибок нет

errorCause Текст 250 Условный Расшифровка кода


ответа
Присутсвует в
случае ошибки

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Присутсвует в Пользователя;
случае ошибки

errorMessageDesc Текст 250 Условный Расшифровка


причины отказа в
проведении операции
Присутсвует, если
errorCode равен 24

6.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/createCardBinding.do?
userId=00000000100000001176&pan=4042663601000000&expiry=201701&cardholderName=Iv
an%20Ivanov&cvc=543&mnemonic=MY%20CARD
Пример ответа ПЦ, если карта вовлечена в 3DSecure
{
"errorCode": 0,
"confirmationType": "FINISH_3DS",
"mdOrder": "712001",
"paReq": "...",
"acsUrl": "https://payments.mtsbank.ru/mdpayacs/pareq"
}

Пример ответа ПЦ, если карта не вовлечена в 3DSecure


{
"createdBindingId": "DE9A8880BC954D1292357B7D14202C62",
"confirmationType": "VERIFY_AMOUNT",
"bindings": [
...
{
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"mnemonic": "VISA*0043",
"createdDate": "27/01/2017 16:22:06",
"updatedDate": "27/01/2017 16:22:06",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 64 из 214
ООО «Рунет Бизнес Системы» :
:
"bindingStatus": 2,
"expiry": "201801",
"maskedPan": "400001******0043",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
},
...
],
"errorCode": 0
}

6.3 confirmCardBinding3ds – Подтверждение регистрации карты после 3DSecure


Запрос confirmCardBinding3ds предназначен для подтверждения регистрации карты в кошельке после 3DSecure
аторизации.

6.3.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Условный Уникальный номер


операции в ПЦ ЭК
Обязательный, если
подтверждение карты
производится по
mdOrder

PaRes Текст - Условный Параметр, который


был получен от ACS
банка эмитента при
Обязательный, если прохождении
карта вовлечена в 3DSecure
3DSecure

6.3.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
исло

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

createdBindingId UUID 32 Опциональный Уникальный


Присутствует для идентификатор ПИ
errorCode=0

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 65 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

confirmationType Текст 50 Опциональный Возможное значение


Присутствует, если VERIFY_AMOUNT
вместо
аутентификации
пользователя была
только попытка
(PARes(A))

bindings[] Набор параметров. - Условный Параметры


Комплексный тип платежных
binding. инструментов в
Присутствует для кошельке.
errorCode=0 Возвращаются
записи по всем
инструментам в
кошельке.

bonusPoints Целое 9 Необязательный Количество


положительное Возвращается только бонусных баллов,
число в случае, если за начисленных за
операцию операцию
начисляются
бонусные баллы

6.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/confirmCardBinding3ds.do?
userId=00000000100000001176&mdOrder=712001&PaRes=...
Пользователь прошел аутентификацию
{
"createdBindingId": "8E267AD4BB934DA4A3098B34BDE71AB4",
"bindings": [
...
{
"bindingId": "8E267AD4BB934DA4A3098B34BDE71AB4",
"mnemonic": "VISA*0001",
"createdDate": "27/01/2017 16:50:46",
"updatedDate": "27/01/2017 16:50:46",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",
"bindingStatus": 0,
"expiry": "201801",
"maskedPan": "400001******0001",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
}
...
],
"errorCode": 0
}

Попытка аутентификации (PARes(A))


{
"createdBindingId": "094254EE8A9144659A7F740979F59C55",
"confirmationType": "VERIFY_AMOUNT",
"bindings": [
...
{
"bindingId": "094254EE8A9144659A7F740979F59C55",
"mnemonic": "VISA*0001",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 66 из 214
ООО «Рунет Бизнес Системы» :
:
"createdDate": "27/01/2017 16:52:16",
"updatedDate": "27/01/2017 16:52:16",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",
"bindingStatus": 2,
"expiry": "201801",
"maskedPan": "400001******0001",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
}
...
],
"errorCode": 0
}

Пользователь не прошел аутентификацию (PARes(N)):


{
"createdBindingId": "094254EE8A9144659A7F740979F59C55",
"confirmationType": "VERIFY_AMOUNT",
"bindings": [
...
{
"bindingId": "094254EE8A9144659A7F740979F59C55",
"mnemonic": "VISA*0001",
"createdDate": "27/01/2017 16:52:16",
"updatedDate": "27/01/2017 16:52:16",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",
"bindingStatus": 2,
"expiry": "201801",
"maskedPan": "400001******0001",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
}
...
],
"errorCode": 0
}

6.4 confirmCardBindingByAmount – Подтверждение регистрации карты по сумме


Сервис confirmCardBindingByAmount предназначен для подтверждения регистрации карты по случайной
сумме. Возможны два сценария использования
1) Первый сценарий. Пользователь подтверждает регистрацию карты сразу после верификационного
платежа. В этом случае внешняя система (сайт) должна передавать в confirmCardBindingByAmount
входной параметр mdOrder
2) Второй сценарий. Если пользователь начал, но сразу не завершил привязку карты (не подтвердил
регистрацию карты в рамках одной сессии на стороне сайта). В этом случае пользователь имеет
возможность, узнав случайную сумму верификационного платежа, через некоторое время войти в
систему, запросить список карт и подтвердить регистрацию карты. Внешняя система (сайт, мобильное
приложение) выполняет запрос getBindings, в ответ на который получает от ПЦ ЭК перечень всех
привязанных к профилю пользователя карт. Карты в статусе «2» (toVerify) могут быть подтверждены
пользователем. Для подтверждения внешняя система должна передавать в
confirmCardBindingByAmount с входным параметром bindingId.
Пользователь имеет возможность совершить 3 попытки ввода параметров верификационного платежа. В
случае, если все 3 попытки будут неуспешными, ПЦ ЭК архивирует карту, и процедура регистрации должна
быть пройдена заново.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 67 из 214
ООО «Рунет Бизнес Системы» :
:
6.4.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Условный Уникальный номер


операции в ПЦ ЭК
Обязательный, если
подтверждение карты
производится по
mdOrder

bindingId UUID 32 Условный Уникальный


идентификатор
Платежного
Обязательный, если инструмента
подтверждение карты
производится по
bindingId

amount Положительное 9,2 Условный Сумма


число с двумя верификационного
знаками после платежа
запятой Передается, если
подтверждение по
суммы (без 3DSecure)

6.4.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
исло

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

createdBindingId UUID 32 Опциональный Уникальный


Присутствует для идентификатор ПИ
errorCode=0

bindings[] Набор параметров. - Условный Параметры


Комплексный тип платежных
binding. инструментов в
Присутствует для кошельке.
errorCode=0 Возвращаются
записи по всем
инструментам в
кошельке.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 68 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

bonusPoints Целое 9 Необязательный Количество


положительное Возвращается только бонусных баллов,
число в случае, если за начисленных за
операцию операцию
начисляются
бонусные баллы

6.4.3 Пример
Подтверждение по mdOrder
https://mts.rbsdev.com/ewallet/3.4/mts/confirmCardBindingByAmount.do?
userId=00000000100000001176&mdOrder=712004&amount=4,30

Подтверждение по bindingId
https://mts.rbsdev.com/ewallet/3.4/mts/confirmCardBindingByAmount.do?
userId=00000000100000001176&bindingId=629911298603407B9E56B67B452799D9&amount=3,8
5
{
"createdBindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindings": [
...
{
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"mnemonic": "VISA*0043",
"createdDate": "27/01/2017 16:22:06",
"updatedDate": "27/01/2017 16:56:58",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",
"bindingStatus": 0,
"expiry": "201801",
"maskedPan": "400001******0043",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
}
...
],
"errorCode": 0
}

6.5 createCardBindingAfterPayment – Создание связки после платежа


Запрос createCardBindingAfterPayment предназначен привязки карты использованной при оплате.

6.5.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Условный Уникальный номер


операции в ПЦ ЭК
Обязательный, если
подтверждение карты
производится по

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 69 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

mdOrder

cvc Целое 4 Опциональный СVC-код


положительное Отсутствует, если
число платеж mdOrder был
проведен с 3DS или
если карта не
содержит cvc
(Например, Maestro).

mnemonic Текст 100 Обязательный Мнемоническое имя


карты

isDefaultBinding Да/Нет true/false Опциональный Признак, говорящий


о желании
пользователя
использовать
регистрируемую
карту по умолчанию
при платежах

bindingParams[] Набор параметров - Необязательный Набор


дополнительных
признаков карты

6.5.2 Ответ
Параметр Тип данных Размер Обязательность Описание

confirmationType Текст 50 Опциональный Возможные


Присутствует, если значения
mdOrder соответстует FINISH_3DS – карта
платежу, вовлечена в
обработанному без 3DSecure, для
3DSecure привязки нужно
В этом случае ПЦ пройти авторизацию
проверит карту на VERIFY_AMOUNT
вовлеченность – карта не вовлечена
повторно. в 3DSecure, для
привязки нужно
передать случайную
сумму

mdOrder Текст 50 Опциональный Уникальный номер


Присутствует, если операции в ПЦ ЭК
confirmationType =
FINISH_3DS

createdBindingId UUID 32 Опциональный Уникальный


Присутствует, если идентификатор ПИ
confirmationType =
VERIFY_AMOUNT

paReq Текст - Условный Параметр для


проведения
процедуры 3DSecure
Присутствует, если
карта вовлечена в Если присутствует в
программу 3DS ответе, то карта

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 70 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

вовлечена в
3DSecure

acsUrl Текст 2000 Условный URL-адрес банка


эмитента (сервер
ACS), на который
Присутствует, если клиент должен быть
карта вовлечена в перенаправлен
программу 3DS

bindings[] Набор параметров. - Условный Параметры


Комплексный тип платежных
binding. инструментов в
Присутствует, если кошельке.
confirmationType = Возвращаются
VERIFY_AMOUNT записи по всем
инструментам в
кошельке.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Условный Расшифровка кода


ответа
Присутсвует в случае
ошибки

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Присутсвует в случае Пользователя;
ошибки

errorMessageDesc Текст 250 Условный Расшифровка


причины отказа в
проведении
Присутсвует, если операции
errorCode равен 24

6.5.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/createCardBindingAfterPayment.do?
userId=00000000100000001176&mdOrder=712006&mnemonic=NEW%20BINDING&cvc=124
{"errorCode":0,"confirmationType":"VERIFY_AMOUNT","mdOrder":"712007","bindingId":"B2585CAB
016A4002897C33F1B88718FE","maskedPan":"400001******0019","cardType":"VISA"}

6.6 createElectronicMoneyAccount – Открытие счета ЭДС


Запрос выполняется для открытие счета электронных денежных средств (ЭДС).

6.6.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 71 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

mnemonic Текст 100 Обязательный Мнемоническое имя


платежного
инструмента

isDefaultBinding Да/Нет true/false Опциональный Признак, говорящий


о желании
пользователя
использовать
платежный
инструмент по
умолчанию при
платежах

6.6.2 Ответ
Параметр Тип данных Размер Обязательность Описание

createdBindingId UUID 32 Обязательный Уникальный


идентификатор
созданного Платежного
инструмента (ПИ)

bindings[] Набор параметров. - Обязательный Параметры платежных


Комплексный тип инструментов в
binding. кошельке.
Возвращаются записи
по всем инструментам в
кошельке.

errorCode Целое 2 Обязательный Код ответа


положительное Равен 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа
Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Пользователя;
Не обязательный
для errorCode=0

bonusPoints Целое 9 Необязательный Количество бонусных


положительное Возвращается баллов, начисленных за
число только в случае, операцию
если за операцию
начисляются
бонусные баллы

6.6.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/createElectronicMoneyAccount.do?
userId=00000000100000001555&isDefaultBinding=true&mnemonic=МТС%20деньги
{
"createdBindingId": "ADAACA549AE74A30AA76D839473F8124",
"bindings": [
{

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 72 из 214
ООО «Рунет Бизнес Системы» :
:
"bindingId": "BB4F631CE9494BB5AC1EE7DD4F2C8598",
"mnemonic": "VISA*0000",
"createdDate": "25/08/2016 11:25:06",
"updatedDate": "25/08/2016 11:25:06",
"isDefaultBinding": true,
"bindingType": "BOUND_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201701",
"maskedPan": "404266******0000",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
},
{
"bindingId": "ADAACA549AE74A30AA76D839473F8124",
"mnemonic": "emoney",
"createdDate": "08/09/2016 11:04:54",
"updatedDate": "08/09/2016 11:04:54",
"isDefaultBinding": false,
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"limitsInfo": {
"balanceLimit": {
"amount": "100000,00",
"currency": "643"
}
}
},
{
"bindingId": "D850362681464AA5A68C8AB96CC7085A",
"mnemonic": "Phone 9104379469",
"createdDate": "01/08/2016 18:00:02",
"updatedDate": "01/08/2016 18:00:02",
"isDefaultBinding": false,
"bindingType": "MTS_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "79104379469",
"maskedPhoneNumber": "7910**69"
}
],
"errorCode": 0
}

6.7 updateBinding – Изменение параметров Платежного инструмента


Данный запрос используется в случае, если пользователю необходимо изменить какие-либо параметры
привязанной к его профилю карты или продукта, например, мнемоническое имя.

6.7.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

bindingId UUID 32 Обязательный Уникальный


идентификатор
Платежного

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 73 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

инструмента

isDefaultBinding Да/Нет true/false Условный Сделать ПИ


инструментом по
умолчанию,
предлагаемым по
умолчанию

mnemonic Текст 100 Условный Изменить


мнемоническое
имя ПИ

bindingParams[] Набор – Условный Набор


параметров дополнительных
параметров карты,
привязанной к
профилю, для
отображения в
списке карт

6.7.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

6.7.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/updateBinding.do?
userId=00000000100000001555&bindingId=5D81DDD8CCA143F18651702B5C172C0F&isDefaultB
inding=true&mnemonic=Запасная%20карта
{"errorCode":0}

6.8 deleteBinding – Удаление Платежного инструмента


Запрос выполняется для удаления Платежного инструмента из кошелька пользователя.

6.8.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 74 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

bindingId UUID 32 Обязательный Уникальный


идентификатор
Платежного
инструмента

6.8.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

6.8.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/deleteBinding.do?
userId=00000000100000001555&bindingId=5D81DDD8CCA143F18651702B5C172C0F
{"errorCode":0}

6.9 getProductBindingWithBalance – Получение информации по привязанному


платежному инструменту – продукту Банка
Запрос выполняется для получения информации по привязанному платежному инструменту – продукту Банка,
включающей баланс, запрашиваемый в системе банка. Ввиду необходимости запрашивать баланс в банке
данный метод может отрабатывать относительно долго. Предполагается следующий сценарий его
использования. Сначала нужно запросить список платежных инструментов, запрос getBindings, потом для
каждого ПИ – продукта вызвать метод getProductBindingWithBalance (на форме отобразить, что AJAX-запрос
выполняется), затем отобразить баланс для соответствующего платежного инструмента.

6.9.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

bindingId UUID 32 Обязательный Уникальный


идентификатор
Платежного
инструмента

6.9.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 75 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

положительное 0 если ошибок нет


число

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

Набор параметров. - Условный Параметры


Комплексный тип Обязательный для указанного
binding. errorCode=0 платежного
инструмента –
продукта Банка

6.9.3 Пример (успешное выполнение запроса)


https://mts.rbsdev.com/ewallet/3.4/mts/ getProductBindingWithBalance.do?
userId=00000000100000001555&bindingId=5D81DDD8CCA143F18651702B5C172C0F
{
"bindingId": "0DD25E1A9BCB4AF89155A16FF04EC542",
"mnemonic": "5337 **** **** 3881",
"createdDate": "02/11/2016 13:57:06",
"updatedDate": "02/11/2016 13:57:06",
"isDefaultBinding": false,
"bindingType": "GENERAL_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"currency": "643",
"expiry": "201901",
"maskedPan": "5337********3881",
"cardType": "MASTERCARD",
"balance": "227,96",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false,
"errorCode": 0
}

6.9.4 Пример (ПИ не найден)


https://mts.rbsdev.com/ewallet/3.4/mts/ getProductBindingWithBalance.do?
userId=00000000100000001555&bindingId=5D81DDD8CCA143F18651702B5C172C0F
{"errorCode":168,"errorCause":"BINDING_NOT_FOUND"}

6.10 updateBankProducts – обновление ПИ-продуктов Банка


Запрос выполняется для обновления списка ПИ-продуктов Банка в базе ПЦ ЭК. Предполагается выполнять этот
запрос после входа клиента в интерфейс, перед выполнением запроса getBindings, чтобы результат getBindings
мог содержать ПИ, которые добавились у клиента, либо не содержал ПИ, которые по каким-то причинам стали
недоступны, например, клиенту была выпущена новая карта или истек срок депозита.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 76 из 214
ООО «Рунет Бизнес Системы» :
:
6.10.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

6.10.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Условный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

bindings[] Набор параметров. - Условный Параметры


Комплексный тип Обязательный для платежных
binding. errorCode=0 инструментов в
кошельке.
Возвращаются
записи по всем
инструментам в
кошельке.

6.10.3 bindingParams в ответе


В наборе параметров bindings[] в ответ на запрос updateBankProducts ПЦ ЭК возвращает набор параметров,
зависящих от типа платежного инструмента bindingType.
bindingType Параметр Тип Описание

GENERAL_CARD MTS_BANK_CARD_TYPE Строка Тип карты в


системах банка

MTS_BANK_CARD_PAN_HASH Строка Хэш номера


банковской карты

MTS_BANK_CARD_ID Строка Идентификатор


карты в системах
банка

BANK_ACCOUNT MTS_BANK_ACCOUNT_NUMBER Строка Номер счета в


банке

MTS_BANK_ACCOUNT_TYPE Строка Тип счета в банке

MTS_BANK_ACCOUNT_STATE Строка Статус счета в


банке

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 77 из 214
ООО «Рунет Бизнес Системы» :
:
6.10.4 Пример (успешное выполнение запроса)
https://mts.rbsdev.com/ewallet/3.4/mts/updateBankProducts.do?
userId=00000000100000001555
{
"bindings": […],
"errorCode": 0
}

6.10.5 Пример (клиент и инструменты МТС-банка не привязаны)


https://mts.rbsdev.com/ewallet/3.4/mts/updateBankProducts.do?
userId=00000000100000001555
{"errorCode":229,"errorCause":"INSUFFICIENT_IDENTIFICATION_LEVEL"}

6.11 createCardBindingWoCheck – Привязка карты без проверки 3DS и


верификационного платежа

6.11.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

pan Текст 19 Обязательный Номер карты

expiry Целое 6 Обязательный Год и месяц


положительное Формат – действия карты
число YYYYMM

cardholderName Текст 100 Опциональный Имя держателя


карты

mnemonic Текст 100 Обязательный Мнемоническое имя


карты

isDefaultBinding Да/Нет true/false Опциональный Признак, говорящий


о желании
пользователя
использовать
регистрируемую
карту по умолчанию
при платежах

bindingParams[] Набор параметров - Необязательный Набор


дополнительных
признаков карты

6.11.2 Ответ
Параметр Тип данных Размер Обязательность Описание

createdBindingId UUID 32 Опциональный Уникальный


Присутствует, идентификатор ПИ
если
confirmationType =
VERIFY_AMOUN
T

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 78 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

bindings[] Набор параметров. - Условный Параметры


Комплексный тип платежных
binding. инструментов в
Присутствует, кошельке.
если Возвращаются записи
confirmationType = по всем
VERIFY_AMOUN инструментам в
T кошельке.

errorCode Целое положительное 3 Обязательный Код ответа


число 0 если ошибок нет

errorCause Текст 250 Условный Расшифровка кода


ответа
Присутсвует в
случае ошибки

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Присутсвует в Пользователя;
случае ошибки

errorMessageDesc Текст 250 Условный Расшифровка


причины отказа в
проведении операции
Присутсвует, если
errorCode равен 24

6.12 getTechnicalAccountBalance – Получение баланса транзитного счета ЭДС

6.12.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

6.12.2 Ответ
Параметр Тип данных Размер Обязательность Описание

balance “сумма” Опциональный Баланс транзитного


Присутствует, счета
errorCode=0

amount Положительное 9,2 Обязательный Сумма в основных


число, два знака единицах валюты
после запятой

currency Целое положительное 3 Обязательный Валюта баланса,


число цифровойкод

errorCode Целое положительное 3 Обязательный Код ответа


число 0 если ошибок нет

errorCause Текст 250 Условный Расшифровка кода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 79 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

ответа
Присутсвует в
случае ошибки

errorMessage Текст 200 Условный Информационное


сообщение об
ошибке для
Присутсвует в Пользователя;
случае ошибки

errorMessageDesc Текст 250 Условный Расшифровка


причины отказа в
проведении операции
Присутствует,
если errorCode
равен 24

6.12.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/ getTechnicalAccountBalance.do?
userId=00000000100000001555
{
"balance": {
"amount": "10415,88",
"currency": "643"
},
"errorCode": 0
}

6.13 getMtsAccountBalance.do - Получение информации о балансе лицевого счета,


доступного для электронной коммерции
Запрос выполняется для получения информации о балансе лицевого счета, доступного для электронной
коммерции. Предварительно, для авторизованного на витрине клиента витрина должна получить список
доступных клиенту ПИ (getBindings), а затем, если в списке есть лицевой счет, направить запрос
getMtsAccountBalance, затем затем отобразить баланс для ПИ лицевой счет.

6.13.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

6.13.2 Ответ
Параметр Тип данных Размер Обязательность Описание

balance “сумма” Опциональный Баланс транзитного


Присутствует, счета
errorCode=0

amount Положительное 9,2 Обязательный Сумма в основных


число, два знака единицах валюты
после запятой

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 80 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

currency Целое 3 Обязательный Валюта баланса,


положительное цифровойкод
число

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorDesc Текст 250 Опциональный Расшифровка кода


ответа
Не обязательный для
errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об
ошибке для
Не обязательный для Пользователя;
errorCode=0

errorMessageDesc Текст 250 Опциональный Расшифровка


причины отказа в
проведении
Обязательный, если операции
errorCode равен 24

6.13.3 Пример (успешное выполнение запроса)


https://mts.rbsdev.com/ewallet/3.4/mts/getMtsAccountBalance.do?userId=00000000100000001555
{
"balance": {
"amount": "100,23",
"currency": "643"
},
"errorCode": 0
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 81 из 214
ООО «Рунет Бизнес Системы» :
:
7 Группа сервисов «Платежи»

7.1 getPaymentTerms – Запрос расчета комиссии и лимитов на платеж


Данным запросом Витрина передает в ПЦ ЭК информацию о платеже и получает в ответ информацию о
размере комиссий и лимитах в зависимости от платежного инструмента, выбранного для оплаты. Сервис
сначала выполняет валидацию поступивших параметров. В случае успешной валидации в ответе возвращается
список результатов проверки возможности проведения операции для каждого ПИ, прикрепленного к кошельку,
при этом для каждого ПИ возвращается уникальное значение mdOrder, которое можно использовать как
входящий параметр запроса payment и не указывать прочие параметры операции. Время жизни mdOrder на ПЦ
ЭК ограничено (20 минут).

7.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

bindingId UUID 32 Опциональный Уникальный


идентификатор
Платежного
Обязательный в случае инструмента
использования для операции
Платежного инструмента,
привязанного к профилю
клиента

pan Текст 19 Опциональный Номер карты

Обязательный в случае
оплаты непривязанной
картой

expiry Целое 6 Опциональный Год и месяц


положительное Формат – действия карты
число YYYYMM Может быть указан в
случае оплаты
непривязанной картой

cardholderName Текст 100 Опциональный Имя держателя


карты
Обязательный в случае
оплаты непривязанной
картой

cvc Целое 4 Опциональный СVC-код


положительное
число
Может быть указан в случае
оплаты непривязанной
картой

serviceId Текст 10 Обязательный Уникальный


идентификатор
услуги
поставщика

amount Положительное 9,2 Обязательный Сумма заказа

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 82 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

число, два знака


после запятой

currency Целое 3 Обязательный Валюта заказа


положительное
число

serviceParams[] Набор параметров - Опциональный Атрибуты


оплачиваемой
услуги/товара
поставщика.
Если указаны, то
будут проверены

comment Текст 200 Опциональный Пользовательский


комментарий для
операции

masterpassOperati Текст 200 Опциональный Идентификатор


onId операции в
MasterPass

7.1.2 Ответ
Параметр Тип данных Размер Обязательность Описание

service{} Набор - Обязательный Параметры сервиса, по


параметров которому производится
расчет деталей платежа

bindings[] Набор - Обязательный Параметры продукта


параметров

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

errorMessageDesc Текст 250 Опциональный Расшифровка причины


отказа в проведении
операции
Обязательный, если
errorCode равен 24

7.1.3 service[] - Структура блока


Параметр Тип данных Размер Обязательность Описание

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 83 из 214
ООО «Рунет Бизнес Системы» :
:
id Текст 10 Обязательный Уникальный
идентификатор услуги
поставщика в ПЦ ЭК

providerName Текст 250 Опциональный Фирменное наименование


поставщика

subline Текст 250 Обязательный Наименование ЮЛ

icon Текст 2000 Обязательный Относительный адрес


файла с картинкой для
поставщика

amount{} Набор параметров - Обязательный Данные о максимальных и


минимальных лимитах
платежа по поставщику,
используемые для
контроля ввода данных

min Целое Обязательный Минимальная сумма


неотрицательное платежа без комиссии в
число копейках

max Целое Обязательный Максимальная сумма


неотрицательное платежа без комиссии в
число копейках

params[] Набор параметров - Обязательный Данные о параметрах,


необходимых для
выполнения платежа в
пользу поставщика

paramTitle Текст 250 Обязательный Отображаемое имя


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

paramName Текст 250 Обязательный Наименование параметра


для выполнения платежа

paramType Текст 250 Обязательный Тип параметра

paramMask Текст 250 Опциональный Маска ввода. Может быть


пустым.

paramDescript Текст 250 Обязательный Описание параметра


ion платежа (подсказка для
отображения
пользователю). Может
быть пустым.

paramHidden Да/Нет true/false Обязательный Признак, говорящий о


необходимости скрывать
параметр в UI для
заполнения пользователем:
 true = не
отображается
 false или параметр
отсутствует =
отображается
При значении параметра,
равном true, параметр не
будет отрисован в
интерфейсе приложением

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 84 из 214
ООО «Рунет Бизнес Системы» :
:
автоматически. Может
быть пустым.

regExp Текст 250 Обязательный Правила валидации


введенного пользователем
значения параметра на
основе регулярных
выражений

maxLength Целое 1-999 Обязательный Максимальная длина


положительное параметра
число

serverValidati Да/Нет true/false Обязательный Признак возможности


on обращения к серверной
функции для валидации
параметра:
true = серверная функция
для валидации параметра
существует
false = серверная функция
для валидации параметра
отсутствует

defaultValue Текст 250 Обязательный Значение по умолчанию.


Может быть пустым.

reference Текст 250 Опциональный Справочник, на который


ссылается параметр.
Используется только для
paramType = ComboBox.
Используется для
формирования списков и
передачи id элементов из
соответствующего
справочника. Может быть
пустым.

receiptParams[] Набор параметров - Опциональный Данные о параметрах, для


отбражения на чеке

paramTitle Текст 250 Обязательный Отображаемое имя


параметра

paramName Текст 250 Обязательный Наименование параметра

paramDescript Текст 250 Обязательный Описание параметра


ion (подсказка для
отображения
пользователю). Может
быть пустым.

7.1.4 bindings[] - Структура блока


Параметр Тип данных Размер Обязательность Описание

bindingId UUID 32 Обязательный Уникальный


идентификатор
Платежного инструмента

mnemonic Текст Обязательный Мнемоническое имя

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 85 из 214
ООО «Рунет Бизнес Системы» :
:
Платежного инструмента

isPaymentAllowe Да/Нет Обязательный Флаг, показывающий,


d возможно ли проведение
платежа с помощью
данного платежного
инструмента

mdOrder Текст Опциональный Уникальный номер


операции в ПЦ ЭК,
присутствует только если
платеж с помощью
данного ПИ разрешен

actionCode Число Обязательный Код ответа для проверки


возможности проведения
платежа по данному ПИ. В
случае успеха равен 0, в
противном случае отличен
от нуля.

amount[] Набор - Обязательный Денежные параметры


параметров. операции
Комплексный
тип amount.

cvcRequired Да/Нет true/false Опциональный Признак обязательности


ввода кода CVV2/CVC2
для конкретного биндинга
по конкретной операции
Возвращается, только если
ПИ является банковской
картой.

maskedPan Текст Опциональный Маскированный номер


карта.
Возвращается, только если
ПИ является банковской
картой.

expiry Число Формат – Опциональный Срок действия карты.


YYYYMM Возвращается, только если
ПИ является банковской
картой.

cardType Текст Опциональный Тип платежной карты:


VISA/MASTERCARD/MA
ESTRO.
Возвращается, только если
ПИ является банковской
картой.

account Текст Опциональный Номер счета ПИ,


например, номер ЛС МТС.
Возвращается, только если
ПИ не является
банковской картой.

additionalInfo{} Набор Опциональный


параметров

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 86 из 214
ООО «Рунет Бизнес Системы» :
:
userSelected Да/Нет true/false Обязательный Платежное средство,
которое клиент указал в
качестве
предпочтительного при
запросе расчета комиссии
и лимитов

convertedAmount Комплексный - Опциональный Сконвертированная сумма


тип операции
convertedAmo
unt

7.1.5 Примеры
Неуспешный ответ (ошибка валидации входных данных)
https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentTerms.do?userId=
CUI178770451&amount=100000,01&currency=643&serviceId=test_p&bindingId=USER_1_MT
S_ACCT_BINDING
{
"errorCode": 56,
"errorCause": "AMOUNT_GREATER_THAN_MAX_ALLOWED_AMOUNT_FOR_SERVICE"
}

Успешный ответ по всем ПИ


https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentTerms.do?
userId=CUI178770451&amount=100.10&currency=643&serviceId=12345&serviceParams={%
22p1%22:%221234%22}& pan=4000010000000001&expiry=202512
{
"errorCode": 0,
"bindings": [{
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"maskedPan": "400001******0001",
"expiry": "202512",
"cardType": "VISA",
"isPaymentAllowed": true,
"mdOrder": "1472812837310002",
"userSelected": true,
"actionCode": "0",
"cvcRequired": true,
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
},
"convertedAmount": {
"amount": "400,00",
"currency": "051",
"rate": "8,0",
"unit": "1,0"
}
},
{
"bindingId": "USER_1_MTS_ACCT_BINDING",
"mnemonic": "Phone 79161234570",
"isPaymentAllowed": true,
"account": "79161234570",
"mdOrder": "1472812837310001",
"userSelected": false,
"actionCode": "0",
"amount": {

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 87 из 214
ООО «Рунет Бизнес Системы» :
:
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
}
}],
"service": {
"id": "test",
"subline": "OOO TEST",
"icon": "a",
"amount": {
"min": 100,
"max": 10000000
},
"params": [{
"paramTitle": "p1",
"paramName": "p1",
"paramType": "StringField",
"paramDescription": "parameter p1",
"paramHidden": false,
"regExp": "\\w{1,5}",
"maxLength": 5,
"defaultValue": "p1 default",
"serverValidation": false
}],
"regions": [],
"payeeHidden": true,
"providerName": "test"
}
}

Неуспешный ответ по одному из ПИ


https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentTerms.do?
userId=USER_W_SINGLE_MTS_ACCT_BINDING&amount=111,20&currency=643&serviceId=test&service
Params={%22p1%22:%2213456%22}&pan=4000010000000001&expiry=202512
{
"errorCode": 0,
"bindings": [{
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"maskedPan": "400001******0001",
"expiry": "202512",
"cardType": "VISA",
"isPaymentAllowed": true,
"mdOrder": "1472813223204002",
"userSelected": true,
"actionCode": "0",
"cvcRequired": true,
"amount": {
"total": "122,65",
"base": "111,20",
"fee": "11,45",
"currency": 643,
"currencyCode": "RUB"
}
},
{
"bindingId": "USER_1_MTS_ACCT_BINDING",
"mnemonic": "Phone 79161234570",
"isPaymentAllowed": false,
"account": "79161234570",
"userSelected": false,
"actionCode": "1001",
"amount": {
"total": "111,20",
"base": "111,20",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 88 из 214
ООО «Рунет Бизнес Системы» :
:
"currency": 643,
"currencyCode": "RUB"
}
}],
"service": {
"id": "test",
"subline": "OOO TEST",
"icon": "a",
"amount": {
"min": 100,
"max": 10000000
},
"params": [{
"paramTitle": "p1",
"paramName": "p1",
"paramType": "StringField",
"paramDescription": "parameter p1",
"paramHidden": false,
"regExp": "\\w{1,5}",
"maxLength": 5,
"defaultValue": "p1 default",
"serverValidation": false
}],
"regions": [],
"payeeHidden": true,
"providerName": "test"
}
}
Неуспешный ответ по всем ПИ
https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentTerms.do?
userId=USER_W_SINGLE_MTS_ACCT_BINDING&amount=111,00&currency=643&serviceId=test
&bindingId=USER_1_MTS_ACCT_BINDING&serviceParams={%22p1%22:%2213456%22}
{
"errorCode": 91,
"bindings": [{
"bindingId": "USER_1_MTS_ACCT_BINDING",
"mnemonic": "Phone 79161234570",
"isPaymentAllowed": false,
"account": "79161234570",
"userSelected": true,
"actionCode": "1001",
"amount": {
"total": "111,00",
"base": "111,00",
"currency": 643,
"currencyCode": "RUB"
}
}],
"service": {
"id": "test",
"subline": "OOO TEST",
"icon": "a",
"amount": {
"min": 100,
"max": 10000000
},
"params": [{
"paramTitle": "p1",
"paramName": "p1",
"paramType": "StringField",
"paramDescription": "parameter p1",
"paramHidden": false,
"regExp": "\\w{1,5}",
"maxLength": 5,
"defaultValue": "p1 default",
"serverValidation": false
}],

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 89 из 214
ООО «Рунет Бизнес Системы» :
:
"regions": [],
"payeeHidden": true,
"providerName": "test"
}
}

7.2 payment – Произвести платеж или перевод


Данный запрос выполняется Витриной после запроса getPaymentTerms и подтверждения пользователем
параметров операции.

7.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Обязательный при
наличии (из ответа
getPaymentTerms)

bindingId UUID 32 Опциональный Уникальный


идентификатор
Платежного
Обязательный, если инструмента
платеж выполняется без
использования метода
getPaymentTerms

pan Текст 19 Опциональный Номер карты

Обязательный в случае
оплаты непривязанной
картой и если платеж
выполняется без
использования метода
getPaymentTerms

expiry Целое 6 Опциональный Год и месяц действия


положительное Формат – карты
число YYYYMM Обязательный в случае
оплаты непривязанной
картой и если платеж
выполняется без
использования метода
getPaymentTerms, либо
если expiry не
передавался в запросе
getPaymentTerms

cardholderName Текст 100 Опциональный Имя держателя карты

Обязательный в случае
оплаты непривязанной
картой и если платеж
выполняется без

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 90 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

использования метода
getPaymentTerms

cvc Целое 4 Опциональный СVC-код


положительное
число
Обязательный в случае
оплаты непривязанной
картой и если платеж
выполняется без
использования метода
getPaymentTerms, либо
если cvc не передавался в
запросе getPaymentTerms

serviceId Текст Опциональный Уникальный


идентификатор
поставщика
Обязательный, если
платеж выполняется без
использования метода
getPaymentTerms

serviceParams[] Набор - Опциональный Атрибуты


параметров конкретного
поставщика.
Обязательный, если
платеж выполняется без
использования метода
getPaymentTerms, либо
если serviceParams не
передавался в запросе
getPaymentTerms

comment Текст 200 Опциональный Пользовательский


комментарий для
операции

amount Положительное 9,2 Опциональный Сумма заказа


число, два знака
после запятой
Обязательный, если
платеж выполняется без
использования метода
getPaymentTerms

currency Целое 3 Опциональный Валюта заказа


положительное
число
Обязательный, если
платеж выполняется без
использования метода
getPaymentTerms

masterpassOperationI Текст 200 Опциональный Идентификатор


d операции в MasterPass

is3dsRequired Логический true/false Опциональный Флаг необходимости


проведения 3ds вне
зависимости от
настроек способа
подтверждения

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 91 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

операции для
партнёра

7.2.2 Ответ
Параметр Тип данных Разме Обязательность Описание
р

errorCode Целое положительное 3 Обязательный Код ответа


число 0 если ошибок нет

errorDesc Текст 250 Опциональный Расшифровка кода ответа

Не обязательный для
errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный для
errorCode=0

errorMessageDes Текст 250 Опциональный Расшифровка причины


c отказа в проведении
операции
Обязательный, если
errorCode равен 24

operation* Набор полей из - Данные об операции


комплексного типа
operation.

7.2.3 Пример (карта вовлечена в 3ds)


Карта вовлечена в 3DS
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001
{
"acsUrl": "https://payments.mtsbank.ru/mdpayacs/pareq",
"mdOrder": "408603201",
"state": 5,
"date": "25/07/2017 14:52:25",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "B31238AA38CE4D20AF92690991E29772",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_3DS_CARD",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 92 из 214
ООО «Рунет Бизнес Системы» :
:
"comment": "Комментарий к платежу",
"confirmationType": "FINISH_3DS",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0,
"PaReq": "..."
}

7.2.4 Пример (карта не вовлечена в 3ds)


Карта не вовлечена в 3DS
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001
{
"errorCode": 0,
"mdOrder": "408604101",
"state": 2,
"refNum": "720614000000",
"approvalCode": "ABC123",
"date": "25/07/2017 14:58:47",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"bonusPoints": 10,
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 93 из 214
ООО «Рунет Бизнес Системы» :
:
7.2.5 Пример (Л/С требуется подтверждение вводом пароля на платежной странице)
Требуется подтверждение вводом пароля на платежной странице
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001
{
"mdOrder": "408604301",
"state": 5,
"date": "25/07/2017 15:02:27",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 15:12:27",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0
}

7.2.6 Пример (Л/С требуется подтверждение по SMS)


Требуется подтверждение по SMS
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001
{
"mdOrder": "408604901",
"state": 5,
"date": "25/07/2017 15:05:39",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "11,11",
"base": "11,11",
"currency": 643,

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 94 из 214
ООО «Рунет Бизнес Системы» :
:
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"confirmationType": "OTP_SMS_CALLBACK",
"otpExpiresAt": "25/07/2017 15:15:39",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0
}

7.2.7 Пример (Л/С подтверждение не требуется)


Подтверждение не требуется
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001
{
"errorCode": 0,
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"mdOrder": "223001",
"bindingId": "USER_1_MTS_ACCT_BINDING",
"date": "06/09/2016 16:43:11",
"state": 2,
"refnum": "625016000010",
"approvalCode": "123ABC",
"serviceParams": {
"p1": "13456"
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
"currencyCode": "RUB"
},
"isTemplateAllowed": true}
{
"errorCode": 0,
"mdOrder": "408605501",
"state": 2,
"refNum": "720615000001",
"approvalCode": "ABC123",
"date": "25/07/2017 15:08:51",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 95 из 214
ООО «Рунет Бизнес Системы» :
:
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"bonusPoints": 6,
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
}

7.2.8 Пример (Л/С подтверждение не требуется, отклонено процессингом)


Подтверждение не требуется, отклонено процессингом
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001
{
"errorCode": 24,
"errorDesc": "1001",
"errorMessage": "error.code.24.1001",
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"mdOrder": "223001",
"bindingId": "USER_1_MTS_ACCT_BINDING",
"date": "06/09/2016 16:43:17",
"state": 6,
"refnum": "625016000093",
"serviceParams": {
"p1": "13456"
},
"amount": {
"total": "1111,22",
"base": "1111,22",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"isTemplateAllowed": true
}
{
"errorCode": 1001,
"errorDesc": "1001",
"errorMessage": "error.code.1001",
"mdOrder": "408606101",
"state": 6,
"refNum": "720615000002",
"date": "25/07/2017 15:12:21",
"operationType": "PAYMENT",
"srcBinding": {

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 96 из 214
ООО «Рунет Бизнес Системы» :
:
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}

7.2.9 Ошибка валидации входных данных


Ошибка валидации входных данных (указано невалидное значение expiry)
https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&mdOrder=223001&expiry=2016ee
{"errorCode":32,"errorCause":"INVALID_EXPIRY"}

7.2.10 Пример без вызова getPaymentTerms


https://mts.rbsdev.com/ewallet/3.4/mts/payment.do?
userId=CUI178770451&amount=100.10&currency=643&serviceId=12345&serviceParams={%
22p1%22:%2213456%22}&bindingId=838EDF827F914BEC89C206F87548B886
{
"errorCode": 0,
"category": "test",
"categoryName": "test",
"serviceId": "12345",
"serviceName": "test",
"mdOrder": "223003",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"date": "30/06/2016 18:50:19",
"state": 2,
"refnum": "618218000003",
"approvalCode": "123ABC",
"serviceParams": {
"p1": "13456"
},
"amount": {
"total": "100,10",
"base": "100,10",
"currency": 643,
"currencyCode": "RUB"
},
"isTemplateAllowed": true
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 97 из 214
ООО «Рунет Бизнес Системы» :
:
{
"errorCode": 0,
"mdOrder": "408606801",
"state": 2,
"refNum": "720615000003",
"approvalCode": "ABC123",
"date": "25/07/2017 15:32:32",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
"currencyCode": "RUB"
},
"bonusPoints": 6,
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
}

7.3 finish3ds – Завершить операцию с 3DSecure


Данный запрос должен выполняться в случае применения технологии 3DSecure. Пользователь возвращается с
ACS банка эмитента на сайт витрины. Витрина для завершения операции (платежа или перевода) должна
вызвать метод finish3ds и передать параметры PaRes и MD, полученный от ACS

7.3.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК,
полученный в ответе
на payment

PaRes Текст - Обязательный Параметр, который


был получен от ACS
банка эмитента
после прохождения
3DSecure

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 98 из 214
ООО «Рунет Бизнес Системы» :
:
7.3.2 Ответ
Структура ответ идентична ответу на метод payment или transfer (в зависимости от подтверждаемой
транзакции)

7.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/finish3ds.do?
userId=00000000100000001555&mdOrder=d1ec7181-846d-42eb-a588-9990f6ace623
PaRes=eJzVWFmvo0iyfu9f0ep5tLrYsd1yHSmTzdgGzGrgjX0Hm8Usv37wObXdutWjufdlNJYsJ0FEZCwZX4TzYKRt
FLF6FAxt9HaQoq7zkuj3LPz8R7TzQo+gsO2Wxrw9hRIxvo8IL45wP6LokP7j7XAFWtS9M1dd8omk9/h+
+6nLkjoK17fPqO2ypn7DPqGf8APy9XHdpA1Sr+7fDl7wgKL8RuE0tcUOyJfHQxW1IvuG4ujXzwH5IB2Q77LX4bXqVq
OnLHyTWDB+/3KztKiYnAekYoDPB+TFcQi9PnrDUYxCcYz+HUP/wrZ/keuu7/TD/aUOVM2w6l7fo+uLH0mHNT5tVAfz
qmF3QL49HaLp3tTRS+iAfFsfkO/W3b36Df3hg1HkquBFPRj226HPqv9lFU4ckHf6oeu9fujenAPyZXUIvOfzLReJEy
wKT8XuOwYCAOCMMkdzXby8fWc5REG2hnA1av19lwJl0rRZn1ZvxAfPd8IBeZmCvKfz7aCvCVw3a6Pfp6qsu89/pH1/
/wtBxnH8NBKfmjZBXqlB0D2yMoRrvv/xx4dUFIp13PyfxBivbuos8Mps8fr1eEhRnzbh799s+5UaQ3tpwhCNY/5cVf
0ZYGT954uCEhi16kR+rfQHz/6dXX42tu28P7vUw14b/KTo7aBFcfQ6EdHvpiZ+/uMfv6oHNkuirv//bP112x81fNVn
eeUQvdE7CQ8s9DwkEKSL2wG7xLsix5pd8Pmr3AfnAflm6xdHPrL2Q3Q+GFuDOz1u5zM/ispzf+36gDLnRKI77qTmie
F149BSqZ2YzXSRK5//LS43ridB10vJJ1/1t9GyWGjcAmc3Hh9jgz1KQdzvdhk/DlZZBc/fMKokWDcaSPrKNVGHasn+
0tv60wmOAm/yiL6Zbs5SKpbhTTFz7H4b8cDmZFzemMat5Kh9vhmUEzFv7Fj8/NsPWfni6TmaPzyzKXTPer33sWKits
/i9XisdS+JIkvkDANW2AOjCEEiqkIdc83RZk/QPz9F+Wh0Ju7lQIZJ8UiLTNiPKASqyQOWgWnOXSRQCAAzOZhKjGVJ
09EAPkxkC4LG4DksDQitDAo5DSo1sfD97Asa4d20UtLJ8QIc1lLVCzdbsmPLqGufWMc+FSIfPoNqKkK8LFwdGu5Nxo
LKYn1cK0UuLP0MzJKejKfkXZ7lpr1qFmpimFJi4lYe2qdSxfcv2VNAyJhri4lJWJnIyVCCpM0a3CIZ3CQt3CizYJKw
5kUjfqKNNvs//TNRc+IMcP3qH8PLvFrxg4dbg6QFI69+8WekYFDJz5CVudWeOazK3DW4VIK7d12rdsdELca48UsoWL
OK87PLfPMzf/kpiUIsAVRg9Iegiz7Bqtwr7gCQgvyKfaaeYaKyykguYz/g1zK5HemIskRlDUES171nM3g8kaRQTrSy
4h18PnfPW1IuU1cH/nZ4QLdnjEzd9rlZuw/RNYoxCx7C1hNFb58COctEZGYxJKRoMkgxuczFiUrkB9aF4o5rzlN9uQ
JCcjjkLmZEz5ZOkm/6IEjQhTj2Ry0pt7wfoxKZlvd5W6oiC1QAG/KISuJxWv2rXnE86hKXuOSYuEOaOF6RONKYOGBi
FnD6iLNjgNIyJA0dhfE9vmdu0v7+vBjcIDHje5yZSSp/irHtE6fOPYZ3VzB/PitH90YmUs5lEgO+5sk1+RMnchgr8n
LpENbsmvLzXbbaP0MGsqojqirBwZhtlmN6vhP3agmOLe1+sf+oSRzIAZDWxK06Q3bkIDKq3Fpvx4QF7QcP4E4syBKw
m9f+/dPZfEB2EUfJcKaVPksGQF88t1/VJFAYsKq+HUvP7j2Vb6bM32w5AidVe00UHtFx7pL+Fcq6w5CPwkRZxVToG4
epHMPuu7jjOgA1+Yy0znkMnluujVnUscic3G2ZsJc3RnmFIkkF/fYh9Y4RYuxYpddpHiwKlve+b5+WgQW3/KIydbOO
PI9gM16R5F5v6OOJpQxyy1eNWW9PIPcd+hzrJgjOF9naVNMRS5mECjnxVADNpKL7zrtdC5gpGmdEvI46l7zRcBe7Yj
Ya9ZE5We1VYqPwZEl29DD0c0EZFEx0YR+ckkUZ1DIZ59zaYOnuyDeS2WD7XRYAJy5OFCMPVgBtIcOE042RKT2mlnwv
TwxKgejGaNsqmJwhXWyTySVeoHBpm3xee8nPCPpLSF2WFVLb6CukakCh0+JB2yA8PwElSiAnuD0ljevZOZ0bV0yfgb
ymjYcq+O86+gaI+BGdpBzgUi6O67hJSgv0VtosGz/SeG8tdyCp3ch8QKTAjSfLXLhQgt2Hvalk/gt7p0sOuo+YdMbJ
/Pu28rOt2grNIitOYg6SD3nJECyoawyU1fmn1sKfnj6hJirKjUmyxuKX8CtCdgSv92fQrPlV2XvPVB3tiThu7HWDRo
u1VnT3itLG2Tfhvam2LgbXUURVAYf0EmUqPWEcpbBNjQ3uiUW+N9A7IChxliVGFth+E+XpvO2P4Yi1dMTayNl2jj7J
l1HloAQ7am2h6kfksnGHSKdCJr5IRIV7ywTtvrVsNpQjP077XR/ctMsZVwb6mbNLKC5DPdw0ly40VqWbALvoloLDKe
MV1Dg34+mKSNvHTTOQU1f5tCEk6LOqVGGvcvfKqhRXjCZrGpyZaOttwvkW1j+JgvQE1NSlO24/EDsiH9FGbLcd/9Ao
WiDnc7To1sVcVE+ESBhFTLG/mbiB2tVaiZzDQrWJgkanMY2sc0phq2WshHlqS5BI62gv5Gq+Zgy8t82QG9W1eBwI4t
0L5kb21f419ArUI/JKBEg4QYLoB8wm6g1C9cEbwWSxCjJMIpbeeZ6wdN3gJWH4F/CZsopKLaaNj3C2nijzKDwi8usK
oSdtUVX/FpVLHbGmbIVBX2N1eurx6xkbBGurQQEIQ5GEYPDHsYYpi/Ohn8KjYfn3y9WZoB9KYI6YXbR4K/y0tgLAE3
V8Ib2WmGTyGVs99DLznpA3OzLgBih6HQnNxqX4BSXxkNXBLY79MCZKcmlN6rI05Z6Y7Wk94o9E7AxCFTedJhFJggjh
2OxQ1lTxWIvjTgiBecQZZHfZIeNxw+2P3T2X2MIu3Sa9iiI69ec0FK+3xVcgvXaGS4lfi1A4VqeAtOwpVkYOl09Ana
rGu2qsIyQKbz2LxennySomO7LBVe53pqYReXx7Oi0UjjhLAZIE/b8Nn1zCrvCJZ98m0r/prr+cSBP2PzmRiqMIvk6k
5d9NpLqP79EfJtG14zvzCqHUCpeTzL8mURF7pxlfaFaztgXnP9kWGolxvraF+O/agm7LS3iz5pWOOdmrPax5XGPyU5
tbqxKwK3xewSvPasOsawhkL4JJnBtnkS+77RBJxiLitTMCvwmOY6E+wh3sxPnku2GBY9zmOT/2XGpjsthkIL1u179f
M5I2nU3TYZvHrT93d/fila0l0InjhxDPcb3dLVBTa8k9n8uBHZ0ngtN0XWswmgXnRvDjbA27CwYYRw1QEjBFtEG3so
gAd6fYqt5EfsNxgqlQOIps6QYLOI1Siv1Ry9D8xO44msx3IdcTtLQOwSfvrGZsrqflbIwkgM68uJg1lSiSsW08+s0k
c4rSNAzaBoJcM3dRt6VbjcuVe8TUFZV7PBfdnbrwBLJsJCJzWi9M94PrDWUkP077y/XcIh7Ps36Ewid6vfhPW6n5+6
hMz5PC3sx8hcmRA8BT4NZgIJ1//HN5TaQMu7b5FTZXyPzVZAphDsJ3XpXk+EQ1RwO0tUakGrYRc2yYpP7RXGGF59tu
TLzgXV4cdVgvDKzPAkwfOkyW/656TFIObNdu394DiD52bJGMzDUwiOJXWPOlVRDlaXCsMJsxjLuYMYwvQ+aTydXwCz
a0LpA7N92EziYbLJHdGKaSQy7YozF11nL/HpH3rFTWRNRX2RTuGeEypb5B586Ad1oLnQWLYvmiD55x6u+ne8MoBYbU
I33b1CfuNrO2GTDIbD263s3CQBFoIMVnk+QYaoEyd3EZIcbmWsLLTTI+i4A1n6SDRz1SI/JDPMNlHgVdKfomNyoPLY
5+ASL6ntMZTRn3kUu4+zxaJYU2UiWfnzYrS0vdAoHW90O3UY5s3tRKWVXzrVInOzQxaRnD83LNj/FYbtYxA64WtsMx
5wK5m7ZXvDWNCoE9od9u2JncWbEsp5aH3ILecIUT01qEm5c02P+6VSDf7zGQb3cb32893q9H3+9vXxd6P97r/hNAOz
NG

7.4 confirmTransactionByOtp.do – Подтверждение операции одноразовым паролем


Сервис confirmTransactionByOtp.do предназначен для подтверждения операции с помощью одноразового
пароля, который пользователь должен ввести на платежной странице.
Параметр confirmationType в ответе на запрос payment.do – запрос проведения платежа, или в ответ на запрос
transfer.do – запрос перевода средств, сигнализирует о способе подтверждения. Если confirmationType =
"OTP_PAYMENT_PAGE", то для совершения операции Витрина должна запросить у пользователя

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 99 из 214
ООО «Рунет Бизнес Системы» :
:
одноразовый код. Витрина должна передать одноразовый код, который ввел пользователь, в ПЦ с помощью
этого сервиса.

7.4.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Обязательный Уникальный номер


операции на ПЦ

otp Текст 10 Обязательный Одноразовый


пароль

7.4.2 Ответ
Структура ответ идентична ответу на метод payment или transfer (в зависимости от подтверждаемой
транзакции)

7.4.3 Пример (введен неправильный пароль)


https://mts.rbsdev.com/ewallet/3.4/mts/confirmTransactionByOtp.do?
userId=<userId>&mdOrder=<mdOrder>&otp=<one-time password>
{"errorCode":106,"errorCause":"CONFIRMATION_ATTEMPT_FAILED"}

7.4.4 Пример (введен неправильный пароль, закончились попытки подтверждения)


https://mts.rbsdev.com/ewallet/3.4/mts/confirmTransactionByOtp.do?
userId=<userId>&mdOrder=<mdOrder>&otp=<one-time password>
{"errorCode":107,"errorCause":"ALL_CONFIRMATION_ATTEMPTS_FAILED"}

7.4.5 Пример (вышло время подтверждения транзакции)


https://mts.rbsdev.com/ewallet/3.4/mts/confirmTransactionByOtp.do?
userId=<userId>&mdOrder=<mdOrder>&otp=<one-time password>
{"errorCode":157,"errorCause":"CONFIRMATION_CODE_EXPIRED"}

7.4.6 Пример (транзакция в статусе отличном от «ожидает подтверждения»)


https://mts.rbsdev.com/ewallet/3.4/mts/confirmTransactionByOtp.do?
userId=<userId>&mdOrder=<mdOrder>&otp=<one-time password>
{"errorCode":919,"errorCause":"TRANSACTION_IN_INCOMPATIBLE_STATUS"}

7.4.7 Пример (успешное подтверждение)


https://mts.rbsdev.com/ewallet/3.4/mts/confirmTransactionByOtp.do?
userId=<userId>&mdOrder=<mdOrder>&otp=<one-time password>
{
"errorCode": 0,
"mdOrder": "408801901",
"state": 2,
"refNum": "720616000002",
"approvalCode": "ABC123",
"date": "25/07/2017 16:09:52",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 100 из 214
ООО «Рунет Бизнес Системы» :
:
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"bonusPoints": 10,
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
}

7.4.8 Пример (успешное подтверждение, транзакция отклонена в процессинге)


https://mts.rbsdev.com/ewallet/3.4/mts/confirmTransactionByOtp.do?
userId=<userId>&mdOrder=<mdOrder>&otp=<one-time password>
{
"errorCode": 1001,
"errorDesc": "1001",
"errorMessage": "error.code.1001",
"mdOrder": "408802501",
"state": 6,
"refNum": "720616000003",
"date": "25/07/2017 16:12:00",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 101 из 214
ООО «Рунет Бизнес Системы» :
:
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}

7.5 reSendOtp.do – Повторная отправка одноразового пароля


Сервис reSendOtp.do предназначен для повторной отправки одноразового пароля.

7.5.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Обязательный Уникальный номер


операции на ПЦ

7.5.2 Ответ
Ответ для данного метода идентичен ответу на метод payment или transfer в зависимости от проводимой
операции.

7.5.3 Пример (успешная переотправка)


https://mts.rbsdev.com/ewallet/3.4/mts/reSendOtp.do?
userId=<userId>&mdOrder=<mdOrder>
{
"mdOrder": "408803101",
"state": 5,
"date": "25/07/2017 16:13:36",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 16:24:49",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 102 из 214
ООО «Рунет Бизнес Системы» :
:
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0
}

7.5.4 Пример (транзакция просрочена)


https://mts.rbsdev.com/ewallet/3.4/mts/reSendOtp.do?
userId=<userId>&mdOrder=<mdOrder>
{
"errorCode": 157,
"errorDesc": "157",
"errorMessage": "error.code.157",
"mdOrder": "408803701",
"state": 6,
"date": "25/07/2017 16:15:48",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}

7.6 getPaymentStatus – Запрос состояния выполнения операции


Запрос выполняется Витриной после выполнения запросов payment для получения данных о результате
выполнения платежа/перевода.

7.6.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Обязательный Уникальный номер


операции на ПЦ

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 103 из 214
ООО «Рунет Бизнес Системы» :
:
7.6.2 Ответ
Структура ответ идентична ответу на метод payment или transfer (в зависимости от типа операции)

7.6.3 Пример (пользователь не совпадает с пользователем транзакции)


https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentStatus.do?
userId=00000000100000001555&mdOrder=408804901
{"errorCode":39,"errorCause":"INVALID_ORDER_ID"}

7.6.4 Пример (статус для успешно проведенной транзакции)


https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentStatus.do?
userId=00000000100000001555&mdOrder=408804901
{
"errorCode": 0,
"mdOrder": "408804901",
"state": 2,
"refNum": "720616000005",
"approvalCode": "ABC123",
"date": "25/07/2017 16:40:39",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"bonusPoints": 10,
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
}

7.6.5 Пример (транзакция отклонена в процессинге)


https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentStatus.do?
userId=00000000100000001555&mdOrder=408802501
{
"errorCode": 1001,
"errorDesc": "1001",
"errorMessage": "error.code.1001",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 104 из 214
ООО «Рунет Бизнес Системы» :
:
"mdOrder": "408802501",
"state": 6,
"refNum": "720616000003",
"date": "25/07/2017 16:12:00",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}

7.6.6 Пример (транзакция ожидает подтверждения)


https://mts.rbsdev.com/ewallet/3.4/mts/getPaymentStatus.do?
userId=00000000100000001555&mdOrder=d1ec7181-846d-42eb-a588-9990f6ace623
{
"errorCode": 0,
"mdOrder": "408805501",
"state": 5,
"date": "25/07/2017 16:50:02",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 17:00:02",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 105 из 214
ООО «Рунет Бизнес Системы» :
:
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}

7.7 Поддержка технологии 3DSecure


Витрины и приложения, подключенные к ПЦ ЭК по настоящему протоколу, должны поддерживать технологию
3DSecure. В случае получения в ответах сервисов «createCardBinding – Инициация регистрации карты" (п. 6.2)
или payment – Произвести платеж или перевод (п. 7.2) параметров PaReq и acsUrl необходимо переадресовать
браузер клиента на ACS банка эмитента карты – acsUrl, передав в параметрах PaReq и в TermUrl адрес
страницы, на которую должен вернуться пользователь.
Пользователь вернется и ACS передаст через браузер клиента параметр PaRes, который необходимо передать в
ПЦ ЭК для совершения авторизации: сервисы «finish3ds – Завершить операцию с 3DSecure» или «»

<form name="downloadForm" action="https://payments.mtsbank.ru/mdpayacs/pareq"


method="POST">
<input type="hidden" name="PaReq"
value="eJxVUttuwjAM/ZWK9zUXSouQiVRg0xDiogJDeyytBdVoKWm6wt8v6WVseUh8fBLbxw7szhJxtsWolChgiU
URntBK4nFvOGCOO+gJ2PgB3gR8oyySayaYTW0OpIP6jYzOYaYEhNFtMl8Jx/U8PgDSQkhRzmeC0r5ejFnNeukwkIa
HLExRHA4He7nbTvzVwg72ZOoHM242IDUN0bXMlHwI1+kD6QCU8iLOSuUjQqqqslNVHMPsy5YlEEMBeda4KY1V6FD3
JBYft8ubZDk/rf3FsXp8lmyr1jzGhL6OgZgbEIcKBafMpUPqWHQ4ov2Ro/XXfghTU4MI9hOLUWpTqmU3LshNJr8Bm
jPUXxfojkvMok5LhwDv+TVDfUMn+bUhxiLSQtrjqWL6bvoeKd1Bl3OPe54poXGYUInuD/Moq2MZAMQ8Ie1QSTtxbf
37CT9sWKvz">
<input type="hidden" name="TermUrl"
value="https://localhost:443/ewallet/3.4/mts/finish3ds.do?mdOrder=623004">
</form>
<script>
window.onload = submitForm;
function submitForm() { downloadForm.submit(); }
</script>

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 106 из 214
ООО «Рунет Бизнес Системы» :
:
8 Группа сервисов «Переводы между ПИ»
Переводы предоставляют возможность передавать средства между платежными инструментами в рамках
одного или нескольких электронных кошельков. Методы, используемые для переводов, могут различаться в
зависимости от источника и получателя перевода. В следующей таблице приведены соглашения по
использованию методов перевода для различных комбинаций платежных инструментов.
отправитель\получ лицев чужой счет ЭДС чужой счет ЭДС привязанная карта непривязанная карта
атель ой лицев
счет ой
счет

лицевой счет - - transferBindingToBi transferBindingToEMo transferBindingToBi transferBindingToCard,


nding, ney, nding, getBToCardTransferTer
getBToBTransferTer getBToBTransferTerm getBToBTransferTer ms
ms s ms

счет ЭДС - - - transferBindingToEMo transferBindingToBi transferBindingToCard,


ney, nding, getBToCardTransferTer
getBToEMTransferTer getBToBTransferTer ms
ms ms

привязанная карта - - transferBindingToBi transferBindingToEMo transferBindingToBi transferBindingToCard,


nding, ney, nding, getBToCardTransferTer
getBToBTransferTer getBToEMTransferTer getBToBTransferTer ms
ms ms ms

непривязанная - - transferCardToBindi transferCardToEMone transferCardToBindi transferCardToCard,


карта ng, y, ng, getCardToCardTransfer
getCardToBTransfer getCardToEMTransfer getCardToBTransfer Terms
Terms Terms Terms

В общем случае клиент может выбрать, работать ли ему с привязанными платежными инструментами или
использовать не связанные с ЭК инструменты.

Любой перевод может состоять как из одного (самого перевода), так и из двух этапов (запроса допустимости
перевода и перевода). Если в процессе запроса допустимости совершения перевода система определила, что
платежный инструмент является привязанным, то перевод должен отправляться как перевод между
привязанными платежными инструментами. Речь идет именно о собственных платежных инструментах клиента
в ЭК, то есть это актуально для привязанных карт.

1.1 getTransferTargets – Получение списка Платежных инструментов, доступных для


использования в качестве получателя платежа / перевода
Запрос предназначен для получения списка ПИ, доступных для использования в качестве ПИ-получателя
перевода с ПИ-источника, чей идентификатор указан в запросе.

1.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

bindingId UUID 32 Обязательный Уникальный идентификатор


продукта клиента, используемого в
качестве платёжного средства.

1.1.2 Ответ
Параметр Тип данных Размер Обязательность Описание

bindings[] Набор параметров. - Обязательный Параметры платежных


Комплексный тип инструментов в кошельке.
binding

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 107 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный для
errorCode=0

errorMessag Текст 200 Опциональный Информационное сообщение об


e ошибке для Пользователя;
Не обязательный для
errorCode=0

1.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getTransferTargets.do?
userId=00000000100000001353&bindingId=DA4FB6BF67D0413CA6D967851A602AFF
{
"bindings": [{
"bindingId": "82B1BD604CDA42EF9FD1A42AC3EF575D",
"mnemonic": "Phone 79169998877",
"createdDate": "16/08/2016 18:40:18",
"updatedDate": "16/08/2016 18:40:18",
"isDefaultBinding": false,
"bindingType": "MTS_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"cardType": 0,
"bankStatus": "UNKNOWN",
"phoneNumber": "79169998877",
"maskedPhoneNumber": "7916**77"
}],
"errorCode": 0
}

1.2 getBToBTransferTerms - Запрос проверки допустимости выбранного перевода и


расчета комиссий в случае перевода между привязанными к ЭК платежными
инструментами
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).

1.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

srcBindingId UUID 32 Обязательный Уникальный идентификатор


Платежного инструмента,
источника перевода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 108 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

dstBindingId UUID 32 Обязательный Уникальный идентификатор


Платежного инструмента,
получателя перевода

amount Положительное 9,2 Обязательный Сумма перевода (без учета


число, два знака комиссии).
после запятой

currency Целое положительное 3 Обязательный Валюта перевода


число

comment Текст 200 Опциональный Пользовательский


комментарий для операции

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

1.2.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

amount Набор параметров. - Опциональный Денежные параметры


Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один
элемент.

srcBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – источника
binding. перевода.

dstBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – получателя
binding. перевода.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 109 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

значение значение

maxAmount Положительное 9,2 Опциональный Максимальная сумма


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

1.2.3 Пример (перевод с привязанной карты на счет ЭДС)


https://mts.rbsdev.com/ewallet/3.4/mts/getBToBTransferTerms.do?
userId=00000000100000001353&srcBindingId=DA4FB6BF67D0413CA6D967851A602AFF
&dstBindingId=492A3035BBCC4C988F93A481A2C8846B
&amount=200.00
&currency=643
{
"errorCode": 0,
"mdOrder": "927002",
"srcBinding": {
"bindingId": "B31238AA38CE4D20AF92690991E29772",
"mnemonic": "TEST_3DS_CARD",
"createdDate": "01/09/2016 15:34:23",
"updatedDate": "01/09/2016 16:04:33",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201701",
"maskedPan": "404266******0000",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
},
"dstBinding": {
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"mnemonic": "EMONEY_ACCOUNT",
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"isDefaultBinding": true,
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "79166249598",
"maskedPhoneNumber": "7916**98"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
}
}

1.2.4 Пример (перевод с привязанной карты на привязанную карту)


https://mts.rbsdev.com/ewallet/3.4/mts/getBToBTransferTerms.do?
userId=00000000100000001353&srcBindingId=DA4FB6BF67D0413CA6D967851A602AFF
&dstBindingId=492A3035BBCC4C988F93A481A2C8846B

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 110 из 214
ООО «Рунет Бизнес Системы» :
:
&amount=100.00
&currency=643
{
"errorCode": 0,
"mdOrder": "942003",
"srcBinding": {
"bindingId": "B31238AA38CE4D20AF92690991E29772",
"mnemonic": "TEST_3DS_CARD",
"createdDate": "01/09/2016 15:34:23",
"updatedDate": "01/09/2016 16:04:33",
"isDefaultBinding": false,
"bindingType": "BOUND_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201701",
"maskedPan": "404266******0000",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
},
"dstBinding": {
"bindingId": "4002613001454185829422FFF7B91D65",
"mnemonic": "TEST_NON_3DS_CARD",
"createdDate": "01/09/2016 15:38:48",
"updatedDate": "01/09/2016 16:04:33",
"isDefaultBinding": true,
"bindingType": "BOUND_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201701",
"maskedPan": "400001******0019",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
}
}

1.2.5 Пример (перевод с ЛС МТС на счет ЭДС)


https://mts.rbsdev.com/ewallet/3.4/mts/getBToBTransferTerms.do?
userId=00000000100000001353&srcBindingId=DA4FB6BF67D0413CA6D967851A602AFF
&dstBindingId=492A3035BBCC4C988F93A481A2C8846B
&amount=100.00
&currency=643
{
"errorCode": 0,
"mdOrder": "943003",
"srcBinding": {
"bindingId": "838EDF827F914BEC89C206F87548B886",
"mnemonic": "Phone 9161234570",
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "24/06/2016 15:39:10",
"isDefaultBinding": false,
"bindingType": "MTS_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "9161234570",
"maskedPhoneNumber": "9161**70"

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 111 из 214
ООО «Рунет Бизнес Системы» :
:
},
"dstBinding": {
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"mnemonic": "EMONEY_ACCOUNT",
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"isDefaultBinding": true,
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "79166249598",
"maskedPhoneNumber": "7916**98"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
}
}

1.3 getCardToBTransferTerms - Запрос проверки допустимости выбранного перевода и


расчета комиссий в случае перевода с непривязанной карты на привязанный к
ЭК платежный инструмент
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).

1.3.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

pan Текст 19 Обязательный Номер карты, с которой


осуществляется перевод

expiry Целое положительное 6 Обязательный Год и месяц действия карты,


число Формат – с которой осуществляется
YYYYM перевод
M

cardholderName Текст 100 Опциональный Имя держателя карты, с


которой осуществляется
перевод

dstBindingId UUID 32 Обязательный Уникальный идентификатор


Платежного инструмента,
получателя перевода

amount Положительное 9,2 Обязательный Сумма перевода (без учета


число, два знака комиссии).
после запятой

currency Целое положительное 3 Обязательный Валюта перевода


число

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 112 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

comment Текст 200 Опциональный Пользовательский


комментарий для операции

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

1.3.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

amount Набор параметров. - Опциональный Денежные параметры


Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один
элемент.

srcBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – источника
binding. перевода.

dstBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – получателя
binding. перевода.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

maxAmount Положительное 9,2 Опциональный Максимальная сумма


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

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 113 из 214
ООО «Рунет Бизнес Системы» :
:
1.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getCardToBTransferTerms.do?userId=00000000100000001353
&pan=4042663601000000&expiry=201701&cardholderName=Ivan%20Ivanov
&dstBindingId=492A3035BBCC4C988F93A481A2C8846B
&amount=200.00
&currency=643
{
"errorCode": 0,
"mdOrder": "1042001",
"srcBinding": {
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"createdDate": "27/09/2016 11:27:47",
"updatedDate": "27/09/2016 11:27:47",
"isDefaultBinding": false,
"bindingType": "ANONYMOUS_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"maskedPan": "400001******0035",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false
},
"dstBinding": {
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"mnemonic": "EMONEY_ACCOUNT",
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"isDefaultBinding": true,
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "79166249598",
"maskedPhoneNumber": "7916**98"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
}
}

1.4 getCardToEMTransferTerms - Запрос проверки допустимости выбранного перевода


и расчета комиссий в случае перевода с непривязанной карты на чужой счет
ЭДС
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).

1.4.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 114 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

пользователя

pan Текст 19 Обязательный Номер карты, с которой


осуществляется перевод

expiry Целое положительное 6 Обязательный Год и месяц действия карты,


число Формат – с которой осуществляется
YYYYM перевод
M

cardholderName Текст 100 Опциональный Имя держателя карты, с


которой осуществляется
перевод

srcPhone Целое положительное 15 Опциональный Номер мобильного телефона


число отправителя, используемый
при отправке SMS-
уведомлений получателю, в
случае переводов с
анонимной карты.

phone Целое положительное 15 Опциональный Номер мобильного телефона


число Может быть заменен пользователя в
на dstBindingId международном формате
MSISDN. Номер
мобильного телефона
используется для адресации
счета ЭДС, получателя
перевода

dstBindingId UUID 32 Опциональный Уникальный идентификатор


Может заменять Платежного инструмента,
параметр phone. получателя перевода,
принадлежащий другому
ЭК.

amount Положительное 9,2 Обязательный Сумма перевода (без учета


число, два знака комиссии).
после запятой

currency Целое положительное 3 Обязательный Валюта перевода


число

comment Текст 200 Опциональный Пользовательский


комментарий для операции

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

1.4.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

amount Набор параметров. - Опциональный Денежные параметры


Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 115 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

элемент.

srcBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – источника
binding. перевода.

dstBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – получателя
binding. перевода.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

maxAmount Положительное 9,2 Опциональный Максимальная сумма


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

1.4.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getCardToEMTransferTerms.do?
userId=CUI178770451&phone=9160000002&amount=22.22&currency=643&pan=4000010000000035&expiry=201801
{
"errorCode": 0,
"mdOrder": "1202001",
"srcBinding": {
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"createdDate": "07/10/2016 23:51:29",
"updatedDate": "07/10/2016 23:51:29",
"isDefaultBinding": false,
"bindingType": "ANONYMOUS_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201801",
"maskedPan": "400001******0035",
"cardType": "VISA",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 116 из 214
ООО «Рунет Бизнес Системы» :
:
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false
},
"dstBinding": {
"bindingId": "E065993D6081441AA4D1C0BFD4FBE583",
"mnemonic": "EMONEY_ACCOUNT",
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"isDefaultBinding": true,
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02"
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
"currencyCode": "RUB"
}
}

1.5 getBToEMTransferTerms - Запрос проверки допустимости выбранного перевода и


расчета комиссий в случае перевода с привязанного к ЭК платежного
инструмента на чужой счет ЭДС
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).

1.5.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

srcBindingId UUID 32 Обязательный Уникальный идентификатор


Платежного инструмента,
источника перевода

phone Целое положительное 15 Опциональный Номер мобильного телефона


число Может быть заменен пользователя в
на dstBindingId международном формате
MSISDN. Номер
мобильного телефона
используется для адресации
счета ЭДС, получателя
перевода

dstBindingId UUID 32 Опциональный Уникальный идентификатор


Может заменять Платежного инструмента,
параметр phone. получателя перевода,
принадлежащий другому
ЭК.

amount Положительное 9,2 Обязательный Сумма перевода (без учета

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 117 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

число, два знака комиссии).


после запятой

currency Целое положительное 3 Обязательный Валюта перевода


число

comment Текст 200 Опциональный Пользовательский


комментарий для операции

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

1.5.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

amount Набор параметров. - Опциональный Денежные параметры


Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один
элемент.

srcBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – источника
binding. перевода.

dstBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – получателя
binding. перевода.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

maxAmount Положительное 9,2 Опциональный Максимальная сумма


число, два знака Присутствует, если перевода.
после запятой сумма перевода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 118 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

выходит за
минимальное или
максимальное
значение значение

1.5.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getBToEMTransferTerms.do?userId=00000000100000001353
&srcBindingId =492A3035BBCC4C988F93A481A2C8846B
&phone=79161234567
&amount=200.00
&currency=643
{
"errorCode": 0,
"mdOrder": "1146002",
"srcBinding": {
"bindingId": "838EDF827F914BEC89C206F87548B886",
"mnemonic": "Phone 9161234570",
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "24/06/2016 15:39:10",
"isDefaultBinding": false,
"bindingType": "MTS_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "9161234570",
"maskedPhoneNumber": "9161**70"
},
"dstBinding": {
"bindingId": "E065993D6081441AA4D1C0BFD4FBE583",
"mnemonic": "EMONEY_ACCOUNT",
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"isDefaultBinding": true,
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02"
},
"amount": {
"total": "23,40",
"base": "21,22",
"fee": "2,18",
"currency": 643,
"currencyCode": "RUB"
}
}

1.6 getBToCardTransferTerms - Запрос проверки допустимости выбранного перевода и


расчета комиссий в случае перевода с привязанного к ЭК платежного
инструмента на непривязанную карту
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 119 из 214
ООО «Рунет Бизнес Системы» :
:
1.6.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

srcBindingId UUID 32 Обязательный Уникальный идентификатор


Платежного инструмента,
источника перевода

targetPan Текст 19 Обязательный Номер карты, на которую


осуществляется перевод.
Передается только номер
карты получателя, этого
достаточно для переводов
внутри страны.

amount Положительное 9,2 Обязательный Сумма перевода (без учета


число, два знака комиссии).
после запятой

currency Целое положительное 3 Обязательный Валюта перевода


число

comment Текст 200 Опциональный Пользовательский


комментарий для операции

dstPhone Числовой 10 Опциональный Номер телефона получателя


перевода

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

1.6.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

amount Набор параметров. - Опциональный Денежные параметры


Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один
элемент.

srcBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – источника
binding. перевода.

dstBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – получателя
binding. перевода.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 120 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

maxAmount Положительное 9,2 Опциональный Максимальная сумма


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

1.6.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getBToCardTransferTerms.do?userId=00000000100000001353
&srcBindingId=492A3035BBCC4C988F93A481A2C8846B
&targetPan=4042663601000000
&amount=200.00
&currency=643
{
"errorCode": 0,
"mdOrder": "1144002",
"srcBinding": {
"bindingId": "838EDF827F914BEC89C206F87548B886",
"mnemonic": "Phone 9161234570",
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "24/06/2016 15:39:10",
"isDefaultBinding": false,
"bindingType": "MTS_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"bankStatus": "UNKNOWN",
"phoneNumber": "9161234570",
"maskedPhoneNumber": "9161**70"
},
"dstBinding": {
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"createdDate": "04/10/2016 15:26:22",
"updatedDate": "04/10/2016 15:26:22",
"isDefaultBinding": false,
"bindingType": "ANONYMOUS_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"maskedPan": "400001******0035",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false
},

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 121 из 214
ООО «Рунет Бизнес Системы» :
:
"amount": {
"total": "11,03",
"base": "10,00",
"fee": "1,03",
"currency": 643,
"currencyCode": "RUB"
}
}

1.7 getCardToCardTransferTerms - Запрос проверки допустимости выбранного


перевода и расчета комиссий в случае перевода между непривязанными
картами
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).

1.7.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

pan Текст 19 Обязательный Номер карты, с которой


осуществляется перевод

expiry Целое положительное 6 Обязательный Год и месяц действия карты,


число Формат – с которой осуществляется
YYYYM перевод
M

cardholderName Текст 100 Опциональный Имя держателя карты, с


которой осуществляется
перевод

targetPan Текст 19 Обязательный Номер карты, на которую


осуществляется перевод.
Передается только номер
карты получателя, этого
достаточно для переводов
внутри страны

amount Положительное 9,2 Обязательный Сумма перевода (без учета


число, два знака комиссии).
после запятой

currency Целое положительное 3 Обязательный Валюта перевода


число

comment Текст 200 Опциональный Пользовательский


комментарий для операции

srcPhone Числовой 10 Опциональный Номер телефона


отправителя

dstPhone Числовой 10 Опциональный Номер телефона получателя


перевода

masterpassOperatio Текст 200 Опциональный Идентификатор операции в

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 122 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

nId MasterPass

tokenizedTargetPan Текст 19 Необязательный Зашифрованный номер


карты, на которую
осуществляется перевод.
Если этот параметр передан,
то ПЦ ЭК пытается
расшифровать номер и
использовать его. Если
расшфровка не удалась,
возникает ошибка.

1.7.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

amount Набор параметров. - Опциональный Денежные параметры


Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один
элемент.

srcBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – источника
binding. перевода.

dstBinding Набор параметров. - Обязательный Параметры платежного


Комплексный тип инструмента – получателя
binding. перевода.

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный
для errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный
для errorCode=0

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

maxAmount Положительное 9,2 Опциональный Максимальная сумма


число, два знака Присутствует, если перевода.
после запятой сумма перевода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 123 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

выходит за
минимальное или
максимальное
значение значение

1.7.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getCardToCardTransferTerms.do?
userId=CUI178770451&amount=22.22&currency=643&pan=4000010000000035&expiry=201801&targetPan=4000010
000000043
{
"errorCode": 0,
"mdOrder": "1203001",
"srcBinding": {
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"createdDate": "08/10/2016 00:13:15",
"updatedDate": "08/10/2016 00:13:15",
"isDefaultBinding": false,
"bindingType": "ANONYMOUS_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201801",
"maskedPan": "400001******0035",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false
},
"dstBinding": {
"bindingId": "ANONYMOUS_CARD",
"mnemonic": "Карта другого банка",
"createdDate": "08/10/2016 00:13:15",
"updatedDate": "08/10/2016 00:13:15",
"isDefaultBinding": false,
"bindingType": "ANONYMOUS_CARD",
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"maskedPan": "400001******0043",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": false,
"maxAmount": "50000,00",
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
"currencyCode": "RUB"
}
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 124 из 214
ООО «Рунет Бизнес Системы» :
:
1.8 transferBindingToBinding - Операция перевода между привязанными к ЭК
платежными инструментами
Операция инициирует перевод между платежными инструментами внутри одного ЭК. Для определения
параметров перевода может указываться только идентификатор mdOrder, полученный ранее при проверке
допустимости перевода.

1.8.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Указывается, если
ранее происходила
проверка
допустимости
перевода

srcBindingId UUID 32 Опциональный Уникальный идентификатор


Платежного инструмента,
источника перевода
Обязательный, если
не указан mdOrder

cvc Целое положительное 4 Опциональный СVC-код карты, с которой


число осуществляется перевод
Если тип платежного
инструмента, с
которого совершается
перевод – карта, то
указание данного
параметра
обязательно (кроме
привязанных
кошельку карт и карт
МТС Банка).

dstBindingId UUID 32 Опциональный Уникальный идентификатор


Платежного инструмента,
получателя перевода
Обязательный, если
не указан mdOrder

amount Положительное 9,2 Опциональный Сумма перевода (без учета


число, два знака комиссии).
после запятой
Обязательный, если
не указан mdOrder

currency Целое положительное 3 Опциональный Валюта перевода


число
Обязательный, если
не указан mdOrder

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

is3dsRequired Логический true/false Опциональный Флаг необходимости

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 125 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

проведения 3ds вне


зависимости от настроек
способа подтверждения
операции для партнёра

1.1.1 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 3 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода ответа

Не обязательный для
errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный для
errorCode=0

errorMessageDesc Текст 250 Опциональный Расшифровка причины


отказа в проведении
операции
Обязательный, если
errorCode равен 24

minAmount Положительное 9,2 Опциональный Минимальная сумма


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

maxAmount Положительное 9,2 Опциональный Максимальная сумма


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

operation* Набор полей из - Данные об операции


комплексного типа
operation.

1.8.2 Пример (операция с карточной связки на счет ЭДС без подтверждения)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToBinding.do?
userId=00000000100000001353&mdOrder=223001&cvc=123
{
"errorCode": 0,
"mdOrder": "408806401",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 126 из 214
ООО «Рунет Бизнес Системы» :
:
"state": 2,
"refNum": "720618000009",
"approvalCode": "ABC123",
"date": "25/07/2017 18:20:13",
"operationType": "TRANSFER",
"direction": "INNER",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_NON_3DS_CARD",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_BINDING",
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с привязанной карты на счет ЭДС",
"bonusPoints": 6
}

1.8.3 Пример (операция с карточной связки на карточную связку без подтверждения)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToBinding.do?
userId=00000000100000001353&mdOrder=223001&cvc=123
{
"errorCode": 0,
"mdOrder": "408806501",
"state": 2,
"refNum": "720618000010",
"approvalCode": "ABC123",
"date": "25/07/2017 18:23:23",
"operationType": "TRANSFER",
"direction": "INNER",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_NON_3DS_CARD",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "B31238AA38CE4D20AF92690991E29772",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_3DS_CARD",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 127 из 214
ООО «Рунет Бизнес Системы» :
:
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"transferType": "BINDING_TO_BINDING",
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с привязанной карты на привязанную карту",
"bonusPoints": 6
}

1.8.4 Пример (операция с ЛС МТС на счет ЭДС с подтверждением)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToBinding.do?
userId=00000000100000001353&mdOrder=223001
{
"mdOrder": "408806601",
"state": 5,
"date": "25/07/2017 18:25:29",
"operationType": "TRANSFER",
"direction": "INNER",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с ЛС на счет ЭДС",
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 18:35:29",
"errorCode": 0
}

1.8.5 Пример (операция с карточной связки на счет ЭДС с подтверждением по 3DS)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToBinding.do?
userId=00000000100000001353&mdOrder=223001&cvc=123
{
"acsUrl": "http://localhost",
"mdOrder": "408806701",
"state": 5,
"date": "25/07/2017 18:44:40",
"operationType": "TRANSFER",
"direction": "INNER",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 128 из 214
ООО «Рунет Бизнес Системы» :
:
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "B31238AA38CE4D20AF92690991E29772",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_3DS_CARD",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с привязанной 3DS-карты на счет ЭДС",
"confirmationType": "FINISH_3DS",
"errorCode": 0,
"PaReq": "…"
}

1.9 transferCardToBinding - Операция перевода с непривязанной карты на


привязанный к ЭК платежный инструмент
Операция инициирует перевод средств из внешнего источника на один из платежных инструментов ЭК. Для
определения параметров перевода может указываться только идентификатор mdOrder, полученный ранее при
проверке допустимости перевода. Так как источником средств является непривязанная карта, то операция
может потребовать различного рода подтверждения.
Если ПИ-источник – непривязанная карта, чтобы узнать, какие ПИ доступны для получения перевода,
рекомендуется вызывать метод getTransferTargets (раздел 1.1), указав на вход ПИ "ANONYMOUS_CARD". В
ответе будет выдан список доступных ПИ.

1.9.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Указывается, если
ранее происходила
проверка
допустимости
перевода

pan Текст 19 Опциональный Номер карты, с которой


осуществляется перевод
Обязательный, если

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 129 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

не указан mdOrder

expiry Целое положительное 6 Опциональный Год и месяц действия карты,


число Формат – с которой осуществляется
YYYYM перевод
Обязательный, если
M не указан mdOrder

cardholderName Текст 100 Опциональный Имя держателя карты, с


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

cvc Целое положительное 4 Обязательный СVC-код карты, с которой


число Даже в том случае, осуществляется перевод
если указан mdOrder

dstBindingId UUID 32 Опциональный Уникальный идентификатор


Платежного инструмента,
получателя перевода
Обязательный, если
не указан mdOrder

amount Положительное 9,2 Опциональный Сумма перевода (без учета


число, два знака комиссии).
после запятой
Обязательный, если
не указан mdOrder

currency Целое положительное 3 Опциональный Валюта перевода


число
Обязательный, если
не указан mdOrder

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass
is3dsRequired Логический true/false Опциональный Флаг необходимости
проведения 3ds вне
зависимости от настроек
способа подтверждения
операции для партнёра

1.1.2 Ответ
Ответ аналогичен ответу при переводах между ПИ, привязанными к ЭК.

1.9.2 Пример (требуется подтверждение по 3DS)


https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToBinding.do?
userId=00000000100000001353&mdOrder=223001&cvc=543
{
"acsUrl": "http://localhost",
"mdOrder": "408806901",
"state": 5,
"date": "25/07/2017 18:54:43",
"operationType": "TRANSFER",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 130 из 214
ООО «Рунет Бизнес Системы» :
:
"direction": "INNER",
"srcBinding": {
"bindingType": "ANONYMOUS_CARD",
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "CARD_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с непривязанной 3DS-карты на счет ЭДС",
"confirmationType": "FINISH_3DS",
"errorCode": 0,
"PaReq": "…"
}

1.9.3 Пример (подтверждения по 3DS не требуется)


https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToBinding.do?
userId=00000000100000001353&mdOrder=223001&cvc=543
{
"errorCode": 0,
"mdOrder": "408807001",
"state": 2,
"refNum": "720618000011",
"approvalCode": "ABC123",
"date": "25/07/2017 18:58:39",
"operationType": "TRANSFER",
"direction": "INNER",
"srcBinding": {
"bindingType": "ANONYMOUS_CARD",
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "CARD_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с непривязанной карты на счет ЭДС",
"bonusPoints": 18
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 131 из 214
ООО «Рунет Бизнес Системы» :
:
1.10 transferCardToEMoney - Операция перевода с непривязанной карты на чужой
счет ЭДС
Операция инициирует перевод средств из внешнего источника на ЭДС чужого ЭК. Для определения
параметров перевода может указываться только идентификатор mdOrder, полученный ранее при проверке
допустимости перевода. Так как источником средств является непривязанная карта, то операция может
потребовать различного рода подтверждения.

1.10.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Указывается, если
ранее происходила
проверка
допустимости
перевода

pan Текст 19 Опциональный Номер карты, с которой


осуществляется перевод
Обязательный, если
не указан mdOrder

expiry Целое положительное 6 Опциональный Год и месяц действия карты,


число Формат – с которой осуществляется
YYYYM перевод
Обязательный, если
M не указан mdOrder

cardholderName Текст 100 Опциональный Имя держателя карты, с


которой осуществляется
перевод
Если не указан
mdOrder, то остается
опциональным

cvc Целое положительное 4 Обязательный СVC-код карты, с которой


число осуществляется перевод
Остается
обязательным даже
при указании mdOrder

phone Целое положительное 15 Опциональный Номер мобильного телефона


число Обязательный, если пользователя в
не указан mdOrder, но международном формате
может быть заменен MSISDN. Номер
на dstBindingId мобильного телефона
используется для адресации
счета ЭДС, получателя
перевода

dstBindingId UUID 32 Опциональный Уникальный идентификатор


Может заменять Платежного инструмента,
параметр phone. получателя перевода,
принадлежащий другому
ЭК.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 132 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

amount Положительное 9,2 Опциональный Сумма перевода (без учета


число, два знака комиссии).
после запятой
Обязательный, если
не указан mdOrder

currency Целое положительное 3 Опциональный Валюта перевода


число
Обязательный, если
не указан mdOrder

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

is3dsRequired Логический true/false Опциональный Флаг необходимости


проведения 3ds вне
зависимости от настроек
способа подтверждения
операции для партнёра

1.1.3 Ответ
Ответ аналогичен ответу при переводах между ПИ, привязанными к ЭК.

1.10.2 Пример (карта не вовлечена в 3ds)


https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToEMoney.do?
userId=00000000100000001353&mdOrder=223001&cvc=543
{
"errorCode": 0,
"mdOrder": "408807301",
"state": 2,
"refNum": "720619000014",
"approvalCode": "ABC123",
"date": "25/07/2017 19:06:36",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"bindingType": "ANONYMOUS_CARD",
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02",
"userId": "CUI842613919"
},
"transferType": "CARD_TO_EMONEY",
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с непривязанной карты на чужой счет ЭДС",
"bonusPoints": 18
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 133 из 214
ООО «Рунет Бизнес Системы» :
:
1.11 transferBindingToEMoney - Операция перевода с привязанного к ЭК платежного
инструмента на чужой счет ЭДС
Операция инициирует перевод с платежного инструмента ЭК на счет ЭДС, принадлежащий другому ЭК. Для
определения параметров перевода может указываться только идентификатор mdOrder, полученный ранее при
проверке допустимости перевода.

1.11.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Указывается, если
ранее происходила
проверка
допустимости
перевода

srcBindingId UUID 32 Опциональный Уникальный идентификатор


Платежного инструмента,
источника перевода
Обязательный, если
не указан mdOrder

cvc Целое положительное 4 Опциональный СVC-код карты, с которой


число осуществляется перевод
Если тип платежного
инструмента, с
которого совершается
перевод – карта, то
указание данного
параметра
обязательно.

phone Целое положительное 15 Опциональный Номер мобильного телефона


число Обязательный, если пользователя в
не указан mdOrder, но международном формате
может быть заменен MSISDN. Номер
на dstBindingId мобильного телефона
используется для адресации
счета ЭДС, получателя
перевода

dstBindingId UUID 32 Опциональный Уникальный идентификатор


Может заменять Платежного инструмента,
параметр phone. получателя перевода,
принадлежащий другому
ЭК.

amount Положительное 9,2 Опциональный Сумма перевода (без учета


число, два знака комиссии).
после запятой
Обязательный, если
не указан mdOrder

currency Целое положительное 3 Опциональный Валюта перевода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 134 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

число

Обязательный, если
не указан mdOrder

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

is3dsRequired Логический true/false Опциональный Флаг необходимости


проведения 3ds вне
зависимости от настроек
способа подтверждения
операции для партнёра

1.1.4 Ответ
Ответ аналогичен ответу при переводах между ПИ, привязанными к ЭК.

1.11.2 Пример (требуется подтверждение с помощью одноразового пароля)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToEMoney.do?
userId=00000000100000001353&mdOrder=223001
{
"mdOrder": "408807501",
"state": 5,
"date": "25/07/2017 19:09:39",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"dstBinding": {
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02",
"userId": "CUI842613919",
"bindingType": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_EMONEY",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с ЛС на чужой счет ЭДС",
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 19:19:39",
"errorCode": 0
}

1.1.1 Пример (подтверждение не требуется)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToEMoney.do?
userId=00000000100000001353&mdOrder=223001
{

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 135 из 214
ООО «Рунет Бизнес Системы» :
:
"errorCode": 0,
"mdOrder": "408807601",
"state": 2,
"refNum": "720619000015",
"approvalCode": "ABC123",
"date": "25/07/2017 19:11:07",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"dstBinding": {
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02",
"userId": "CUI842613919",
"bindingType": "EMONEY_ACCOUNT"

},
"transferType": "BINDING_TO_EMONEY",
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с ЛС на чужой счет ЭДС",
"bonusPoints": 6
}

1.12 transferBindingToCard - Операция перевода с привязанного к ЭК платежного


инструмента на непривязанную карту
Операция инициирует перевод с платежного инструмента ЭК на произвольную карту. Для определения
параметров перевода может указываться только идентификатор mdOrder, полученный ранее при проверке
допустимости перевода.

1.12.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Указывается, если
ранее происходила
проверка
допустимости
перевода

srcBindingId UUID 32 Опциональный Уникальный идентификатор


Платежного инструмента,
источника перевода
Обязательный, если
не указан mdOrder

cvc Целое положительное 4 Опциональный СVC-код карты, с которой

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 136 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

число осуществляется перевод


Если тип платежного
инструмента, с
которого совершается
перевод – карта, то
указание данного
параметра
обязательно.

targetPan Текст 19 Опциональный Номер карты, на которую


осуществляется перевод.
Передается только номер
Обязательный, если карты получателя, этого
не указан mdOrder достаточно для переводов
внутри страны

amount Положительное 9,2 Опциональный Сумма перевода (без учета


число, два знака комиссии).
после запятой
Обязательный, если
не указан mdOrder

currency Целое положительное 3 Опциональный Валюта перевода


число
Обязательный, если
не указан mdOrder

dstPhone Числовой 10 Опциональный Номер телефона получателя


перевода

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

is3dsRequired Логический true/false Опциональный Флаг необходимости


проведения 3ds вне
зависимости от настроек
способа подтверждения
операции для партнёра

1.1.5 Ответ
Ответ аналогичен ответу при переводах между ПИ, привязанными к ЭК.

1.12.2 Пример (требуется подтверждение с помощью одноразового пароля)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToCard.do?userId=00000000100000001353&mdOrder=223001
{
"mdOrder": "408900101",
"state": 5,
"date": "25/07/2017 20:06:49",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"bindingType": "MTS_ACCOUNT",
"mnemonic": "Phone 9161234570"
},
"dstBinding": {

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 137 из 214
ООО «Рунет Бизнес Системы» :
:
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"transferType": "BINDING_TO_CARD",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с ЛС на непривязанную карту",
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 20:16:50",
"errorCode": 0
}

1.1.1 Пример (требуется подтверждение по 3DS)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToCard.do?
userId=00000000100000001353&mdOrder=223001&cvc=123
{
"acsUrl": "http://localhost",
"mdOrder": "408900201",
"state": 5,
"date": "25/07/2017 20:09:30",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "B31238AA38CE4D20AF92690991E29772",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_3DS_CARD",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"dstBinding": {
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"transferType": "BINDING_TO_CARD",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с привязанной 3DS-карты на непривязанную карту",
"confirmationType": "FINISH_3DS",
"errorCode": 0,
"PaReq": "…"
}

1.1.2 Пример (подтверждение не требуется)


https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToCard.do?userId=00000000100000001353&mdOrder=223001?
&cvc=123
{
"errorCode": 0,
"mdOrder": "408900301",
"state": 2,
"refNum": "720620000000",
"approvalCode": "ABC123",
"date": "25/07/2017 20:11:45",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 138 из 214
ООО «Рунет Бизнес Системы» :
:
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_NON_3DS_CARD",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"transferType": "BINDING_TO_CARD",
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с привязанной карты на непривязанную карту",
"bonusPoints": 18
}

1.13 transferCardToCard – Операция перевода между непривязанными картами

Операция инициирует перевод средств из внешнего источника на другой внешний источник. Фактически ЭК не
задействован в качестве финансовой составляющей для операции. Для определения параметров перевода может
указываться только идентификатор mdOrder, полученный ранее при проверке допустимости перевода. Так как
источником средств является непривязанная карта, то операция может потребовать различного рода
подтверждения.

1.13.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный идентификатор


пользователя

mdOrder Текст 50 Опциональный Уникальный номер


операции в ПЦ
Указывается, если
ранее происходила
проверка
допустимости
перевода

pan Текст 19 Опциональный Номер карты, с которой


осуществляется перевод
Обязательный, если
не указан mdOrder

expiry Целое положительное 6 Опциональный Год и месяц действия карты,


число Формат – с которой осуществляется
YYYYM перевод
Обязательный, если
M не указан mdOrder

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 139 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

cardholderName Текст 100 Опциональный Имя держателя карты, с


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

cvc Целое положительное 4 Обязательный СVC-код карты, с которой


число осуществляется перевод
Остается
обязательным даже
если указан mdOrder

targetPan Текст 19 Опциональный Номер карты, на которую


осуществляется перевод.
Передается только номер
Обязательный, если карты получателя, этого
не указан mdOrder достаточно для переводов
внутри страны

amount Положительное 9,2 Опциональный Сумма перевода (без учета


число, два знака комиссии).
после запятой
Обязательный, если
не указан mdOrder

currency Целое положительное 3 Опциональный Валюта перевода


число
Обязательный, если
не указан mdOrder

srcPhone Числовой 10 Опциональный Номер телефона


отправителя

dstPhone Числовой 10 Опциональный Номер телефона получателя


перевода

masterpassOperatio Текст 200 Опциональный Идентификатор операции в


nId MasterPass

is3dsRequired Логический true/false Опциональный Флаг необходимости


проведения 3ds вне
зависимости от настроек
способа подтверждения
операции для партнёра

tokenizedTargetPan Текст 19 Необязательный Зашифрованный номер


карты, на которую
осуществляется перевод.
Если этот параметр передан,
то ПЦ ЭК пытается
расшифровать номер и
использовать его. Если
расшфровка не удалась,
возникает ошибка.

1.1.6 Ответ
Ответ аналогичен ответу при переводах между ПИ, привязанными к ЭК.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 140 из 214
ООО «Рунет Бизнес Системы» :
:
1.13.2 Пример (карта не вовлечена в 3ds)
https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToCard.do?userId=CUI178770451&mdOrder=1203001&cvc=123
{
"errorCode": 0,
"mdOrder": "408900701",
"state": 2,
"refNum": "720620000003",
"approvalCode": "ABC123",
"date": "25/07/2017 20:16:54",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"bindingType": "ANONYMOUS_CARD",
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"maskedPan": "404266******3309",
"cardType": "VISA"
},
"transferType": "CARD_TO_CARD",
"amount": {
"total": "10,00",
"base": "10,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
}
}

1.14 finish3dsTransfer - подтверждение перевода c помощью помощью 3ds


Метод принимает на вход параметры, аналогичные finish3ds. Ответ метода аналогичен ответу transfer*To* с
учетом используемых ПИ.

1.15 confirmTransferByOtp - подтверждение перевода c помощью одноразового


пароля
Метод принимает на вход параметры, аналогичные confirmTransactionByOtp. Ответ метода аналогичен ответу
transfer*To* с учетом используемых ПИ.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 141 из 214
ООО «Рунет Бизнес Системы» :
:
9 Пополнение ЭДС
Данный набор API используется для пополнения счета ЭДС.
Поддерживается следующий список транзакций:
 Проверка возможности внесения средств;
 Внесение средств;
 Отмена внесения средств.
При выполнении операции пополнения ЭДС подразумевается, что кошелек создается в случае его отсутствия.
Создание происходит за счет внутренних алгоритмов, на внешнюю систему не накладывается обязательств по
явному вызову процедуры создания кошелька. При создании кошелька не подразумевается использование
никаких механизмов подтверждения операции конечным пользователем.
Механизм пополнения на текущий момент подразумевает наличие только одного счета ЭДС в электронном
кошельке, поэтому идентификатором для обращения к ЭДС выступает номер телефона.

9.1 emoneyTopUpCheck – проверка возможности внесения средств


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

9.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона Клиента в
число международном
формате MSISDN
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии
поддерживаются
7XXXNNNNNNN

amount Положительное 9,2 Обязательный Сумма заказа


число, два знака
после запятой

currency Целое 3 Обязательный Валюта заказа


положительное 643 – рубли
число

9.1.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 142 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

ответа. Техническая
информация для
инженеров
Присутствует, если эксплуатации
errorCode отличен от 0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Клиента
Присутствует, если
errorCode отличен от 0

9.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/emoneyTopUpCheck.do?
phone=79161234567&amount=200.00&currency=643
{"mdOrder":"1234567890","errorCode":0}

9.2 emoneyTopUp - внесение средств


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

9.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона Клиента в
число международном
формате MSISDN
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии
поддерживаются
7XXXNNNNNNN

partnerMdOrder Текст 50 Обязательный Уникальный номер


операции в системе
партнера,
подключенной к ПЦ
ЭК

amount Положительное 9,2 Обязательный Сумма заказа. В


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

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 143 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

Зачисление
производится именно
по этой сумме.

currency Целое 3 Обязательный Валюта заказа


положительное 643 – рубли
число

description Текст 250 Опциональный Описание операции

localDate Дата/время Формат – Время совершения


ДД/ММ/ГГГ операции на стороне
Г ЧЧ:ММ:СС вызывающей системы.

9.2.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

state Целое 10 Обязательный Состояние транзакции.


положителье 1-транзакция успешно
число выполнена;
3-транзакция отменена;
6-транзакция
отклонена;
7-транзакция в
процессе обработки.

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа. Техническая
информация для
Присутствует, если инженеров
errorCode отличен от 0 эксплуатации

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Клиента
Присутствует, если
errorCode отличен от 0

9.2.3 Пример
https:// mts.rbsdev.com/ewallet/3.4/mts/emoneyTopUpCompletion.do?
phone=79161234567&partnerMdOrder=223001&amount=200.00&currency=643
{"mdOrder":"1234567890","state":1,"errorCode":0}

9.3 emoneyTopUpReversal – отмена пополнения


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

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 144 из 214
ООО «Рунет Бизнес Системы» :
:
платежа. Отмена допустима только для операции пополнения. Отмена должна содержать ссылку на
оригинальное пополнение (partnerMdOrder).
В случае, если по каким-то причинам, вызывающей системой не был получен ответ на сообщение отмены
операции, вызывающая система может повторно отправить копию сообщения в ПЦ. Если в ПЦ
зарегистрировано такое сообщение, то ПЦ будет обрабатывать эту копию как запрос статуса, то есть вернет
состояние транзакции, которая была сформирована изначальным сообщением. Если сообщение не
зарегистрировано, то ПЦ инициирует новую транзакцию.

9.3.1 Запрос
Параметр Тип данных Размер Обязательность Описание

partnerMdOrder Текст 50 Обязательный Уникальный номер


оригинальной операции
в системе партнера,
подключенной к ПЦ ЭК

9.3.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

state Целое 10 Обязательный Состояние транзакции.


положителье 1-транзакция успешно
число выполнена;
3-транзакция отменена;
6-транзакция
отклонена;
7-транзакция в
процессе обработки.

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа. Техническая
информация для
Присутствует, если инженеров
errorCode отличен от 0 эксплуатации

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Клиента
Присутствует, если
errorCode отличен от 0

9.3.3 Пример
https:// mts.rbsdev.com/ewallet/3.4/mts/emoneyTopUpReversal.do?
partnerMdOrder=223001
{"mdOrder":"1234567890","state":3,"errorCode":0}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 145 из 214
ООО «Рунет Бизнес Системы» :
:
9.4 emoneyTopUpStatus – проверка статуса пополнения
Запрос статуса операции может использоваться для проверки конечного состояния по транзакции в случае
разбора проблемных ситуаций, запрос статуса должен содержать ссылку на оригинальное пополнение
(partnerMdOrder).

9.4.1 Запрос
Параметр Тип данных Размер Обязательность Описание

partnerMdOrder Текст 50 Обязательный Уникальный номер


оригинальной операции
в системе партнера,
подключенной к ПЦ ЭК

9.4.2 Ответ
Параметр Тип данных Размер Обязательность Описание

mdOrder Текст 50 Обязательный Уникальный номер


операции в ПЦ ЭК

state Целое 10 Обязательный Состояние транзакции.


положителье 1-транзакция успешно
число выполнена;
3-транзакция отменена;
6-транзакция
отклонена;
7-транзакция в
процессе обработки.

errorCode Целое 2 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа. Техническая
информация для
Присутствует, если инженеров
errorCode отличен от 0 эксплуатации

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Клиента
Присутствует, если
errorCode отличен от 0

9.4.3 Пример
https:// mts.rbsdev.com/ewallet/3.4/mts/emoneyTopUpStatus.do?
partnerMdOrder=223001
{"mdOrder":"1234567890","state":3,"errorCode":0}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 146 из 214
ООО «Рунет Бизнес Системы» :
:
10 Интерфейс подключения ТСП
Данный набор API используется в двух случаях, в случае подключения ТСП или в случае подключения другого
источника транзакций, который использует типы транзакций «классические» для ритейла.
Поддерживается следующий список транзакций:
 Покупка
 Предавторизация
 Завершение предавторизации
 Возврат
 Отмена (для всех поддерживаемых типов операций)
 Статус (для всех поддерживаемых типов операций)
 Сверка итогов
Базовым параметром идентификации клиента при совершении транзакции является номер телефона, при этом
также допустимо указание типа задействованного платежного инструмента. По некоторым операциям
поддерживается только определенный тип инструмента. Важным моментом является то, что не
подразумевается использование getWallet(). При отсутствии кошелька или соответствующего платежного
инструмента в нем вызывающая система получает отказ. Если платежный инструмент не указан, то может
применяться платежный инструмент ЭК по умолчанию.
Клиент может подтверждать свою идентификацию посредством различных механизмов:
 Идентификация клиента по СМС с ожиданием ответа по СМС на номер телефона, используемый
также в качестве идентификатора ЭК. Использование идентификации такого рода определяется на
уровне конкретной подключаемой внешней системы. Используемый адрес для подтверждения
операции привязывается к записи о партнерской системе в ПЦ. При использовании такой схемы
реальная авторизация операции выполняется после подтверждения от клиента.
 Одноразовый пароль, который отправляется клиенту по СМС в момент совершения операции. При
этом от клиента ожидается не ответ по СМС, а ввод полученного пароля на терминальном устройстве.
Использование идентификации такого рода определяется на уровне конкретной подключаемой
внешней системы. При использовании такой схемы реальная авторизация операции выполняется после
получения пароля.

ТСП или концентратор ТСП или другая внешняя система подключается к ПЦ МТС по той же схеме, что и
другие внешние системы, используя определенный URL и клиентский сертификат.
Поддерживаемый тип аутентификации клиента настраивается на уровне подключаемой системы, но может
быть переопределен параметром confirmationType в запросе на совершение операции.
Взаимодействие состоит из циклов между сверками итогов. Сверка итогов выполняется всегда по инициативе
внешней системы. ПЦ МТС не инициирует сверку итогов самостоятельно. Если необходимость в сверке итогов
отсутствует, то подключаемая система может не посылать сверку, в этом случае будет существовать только
один цикл, в рамках которого ПЦ будет держать счетчики.

10.1 purchase - покупка

10.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона Клиента в
число международном
формате MSISDN
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 147 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

поддерживаются
7XXXNNNNNNN

partnerMdOrder Текст 50 Опциональный Уникальный номер


операции в системе
партнера, подключенной
к ПЦ ЭК

amount Положительное 9,2 Обязательный Сумма заказа


число, два знака
после запятой

currency Целое 3 Обязательный Валюта заказа


положительное 643 – рубли
число

merchantName Текст 40 Опциональный Название торговой


точки. Латинскими
буквами. Рекомендуется
не более 22 символов.

confirmationType Текст 50 Опциональный Возможные значения:


OTP_PAYMENT_PAGE
Если присутствует, то – Витрина должна
значение имеет запросить у
приоритет над пользователя
значением, одноразовый код,
определенным для OTP_SMS_CALLBACK
партнерской системы. – операция ожидает
подтверждения
пользователя через смс

serviceId Текст 10 Опциональный Идентифицирует тип


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

10.1.2 Ответ
Ответ аналогичен ответу для API payment.

10.1.3 Пример
https://mts.rbsdev.com/mtspayment/purchase.do?
phone=79161234567&partnerMdOrder=12345& amount=12345.00&currency=643
{
"errorCode": 0,
"mdOrder": "408900801",
"state": 5,
"date": "26/07/2017 12:34:58",
"operationType": "PURCHASE",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 148 из 214
ООО «Рунет Бизнес Системы» :
:
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
},
"confirmationType": "OTP_SMS_CALLBACK",
"otpExpiresAt": "26/07/2017 12:44:58",
"service": {
"category": "purchase",
"categoryName": "purchase",
"serviceId": "purchase",
"serviceName": "purchase",
"serviceParams": {}
}
}

10.2 refund – возврат

10.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного телефона Клиента в


положительное международном формате MSISDN
число Является идентификатором кошелька
Клиента в сервисе МТС Деньги
В текущей версии поддерживаются
7XXXNNNNNNN

partnerRefundOperatio Текст Опциональный Партнерский идентификатор операции


nId возврата

partnerMdOrder Текст 50 Опциональный Уникальный номер операции в системе


партнера, подключенной к ПЦ ЭК

originalMdOrder Текст 50 Опциональный Уникальный номер оригинальной


операции в ПЦ ЭК. В данном случае
идентификатор оригинальной операции
покупки. Если идентификатор не указан,
то операция рассматривается как
обычная кредитовая операция.

amount Положительное 9,2 Обязательный Сумма заказа.


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

currency Целое 3 Обязательный Валюта заказа


положительное 643 – рубли
число

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 149 из 214
ООО «Рунет Бизнес Системы» :
:
10.2.2 Ответ

Параметр Тип данных Разме Обязательность Описание


р

errorCode Целое положительное 3 Обязательный Код ответа


число 0 если ошибок нет

errorDesc Текст 250 Опциональный Расшифровка кода ответа

Не обязательный для
errorCode=0

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке для
Пользователя;
Не обязательный для
errorCode=0

errorMessageDes Текст 250 Опциональный Расшифровка причины


c отказа в проведении
операции
Обязательный, если
errorCode равен 24

refundStatus Текст Обязательный Статус проведенного


возврата:
CREATED - создан;
IN_PROGRESS - в процессе;
SUCCESS - успешный,
DECLINED - отказано.
ERROR - ошибка.

operation* Набор полей из - Данные об операции


комплексного типа
operation.

В поле approvalCode (блок operation) возвращается значение для выполненной операции возврата, а не для
оригинальной операции.

10.2.3 Пример
https://mts.rbsdev.com/mtspayment/refund.do?
phone=79161234567&partnerMdOrder=12345&originalMdOrder=234567&amount=12345.00&c
urrency=643
{
"errorCode": 0,
"refundStatus":"SUCCESS",
"mdOrder": "408901201",
"state": 4,
"refNum": "720715000007",
"approvalCode": "ABC123",
"date": "26/07/2017 15:15:52",
"operationType": "PURCHASE",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 150 из 214
ООО «Рунет Бизнес Системы» :
:
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"service": {
"category": "purchase",
"categoryName": "purchase",
"serviceId": "purchase",
"serviceName": "purchase",
"serviceParams": {}
}
}

10.3 reversal - отмена (для всех поддерживаемых типов операций)


Частичные отмены не поддерживаются, отмена происходит по полной сумме. Отмена завершения
предавторизации пополнения отменяет и саму предавторизацию пополнения. Это же касается и
предавторизации внесения средств. Отмена может не содержать явную ссылку на оригинальную операцию
(mdOrder), в этом случае выполняется поиск оригинала по partnerMdOrder, который должен быть указан.
Последнее используется для отмен по таймауту.

10.3.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона Клиента в
число международном
формате MSISDN
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии
поддерживаются
7XXXNNNNNNN

mdOrder Текст 50 Опциональный Уникальный номер


оригинальной операции
в ПЦ
Указывается, если
значение было получено
из оригинальной
операции

partnerMdOrder Текст 50 Опциональный Уникальный номер


Указывается, если ответ оригингальной
на оригинальную операции в системе
операциию не был партнера,
получен подключенной к ПЦ ЭК

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 151 из 214
ООО «Рунет Бизнес Системы» :
:
10.3.2 Ответ
Ответ аналогичен ответу для API payment.

10.3.3 Пример
https://mts.rbsdev.com/mtspayment/reversal.do?
phone=79161234567&mdOrder=12345&partnerMdOrder=234567
{
"errorCode": 0,
"mdOrder": "408901301",
"state": 3,
"refNum": "720715000008",
"approvalCode": "ABC123",
"date": "26/07/2017 15:28:19",
"operationType": "PURCHASE",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"service": {
"category": "purchase",
"categoryName": "purchase",
"serviceId": "purchase",
"serviceName": "purchase",
"serviceParams": {}
}
}

10.4 getStatus - статус (для всех поддерживаемых типов операций)


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

10.4.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона Клиента в
число международном
формате MSISDN
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии
поддерживаются

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 152 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

7XXXNNNNNNN

partnerMdOrder Текст 50 Опциональный Уникальный номер


Указывается, если ответ оригинальной операции
на оригинальную в системе партнера,
операциию не был подключенной к ПЦ ЭК
получен

mdOrder Текст 50 Опциональный Уникальный номер


оригинальной операции
в ПЦ
Указывается, если
значение было получено
из оригинальной
операции

10.4.2 Ответ
Ответ аналогичен ответу для API payment.

10.4.3 Пример
https://mts.rbsdev.com/mtspayment/getStatus.do?
phone=79161234567&partnerMdOrder=234567
{
"errorCode": 0,
"mdOrder": "408901401",
"state": 2,
"refNum": "720715000009",
"approvalCode": "ABC123",
"date": "26/07/2017 15:36:47",
"operationType": "PURCHASE",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"service": {
"category": "purchase",
"categoryName": "purchase",
"serviceId": "purchase",
"serviceName": "purchase",
"serviceParams": {}
}
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 153 из 214
ООО «Рунет Бизнес Системы» :
:
10.5 confirmOTP – передача одноразового пароля, введенного клиентом
Передача одноразового пароля выполняется в случае использования схемы передачи одноразового пароля для
ввода на терминале по СМС клиенту. В случае использования такой схемы авторизация операции выполняется
при получении именно этого сообщения. Сообщение с данными операции трактуется как подготовительное.

10.5.1 Запрос
Параметр Тип данных Размер Обязательность Описание

phone Целое 15 Обязательный Номер мобильного


положительное телефона Клиента в
число международном
формате MSISDN
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии
поддерживаются
7XXXNNNNNNN

mdOrder Текст 50 Обязательный Уникальный номер


оригинальной операции
в ПЦ
Значение получается из
оригинальной операции

password Текст 50 Обязательный Код подтверждения


идентификации клиента

10.5.2 Ответ
Ответ аналогичен ответу для API payment.

10.5.3 Пример
https://mts.rbsdev.com/mtspayment/confirmOtp.do?
phone=79161234567&mdOrder=1234567890&password=123456
{
"errorCode": 0,
"mdOrder": "408900901",
"state": 2,
"refNum": "720713000004",
"approvalCode": "ABC123",
"date": "26/07/2017 13:47:40",
"operationType": "PURCHASE",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 154 из 214
ООО «Рунет Бизнес Системы» :
:
"currencyCode": "RUB"
},
"service": {
"category": "purchase",
"categoryName": "purchase",
"serviceId": "purchase",
"serviceName": "purchase",
"serviceParams": {}
}
}

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 155 из 214
ООО «Рунет Бизнес Системы» :
:
11 Получение истории операций

11.1 getOperationsHistory – запрос истории операций

11.1.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

bindindId UUID 32 Необязательный Уникальный


идентификатор
платежного
инструмента, операции
по которому требуется
показать

dateFrom Дата/время Формат – Необязательный Дата начала периода, за


ДД/ММ/ГГГ который требуется
Г ЧЧ: найти операции
ММ:СС Может быть
использован при поиске
операций

dateTo Дата/время Формат – Необязательный Дата начала периода, за


ДД/ММ/ГГГ который требуется
Г ЧЧ: найти операции
ММ:СС Может быть
использован при поиске
операций

services[] JSON-массив 500 Необязательный Перечень сервисов


(поставщиков),
транзакции в пользу
Может быть которых необходимо
использован, если получить
требуется получение
подмножества операций
только по выбранным Разделитель – запятая,
сервисам например:
services=[“test”,”test_p”]

direction JSON-массив из 100 Необязательный Пример:


значений direction=["IN","OUT"]
“IN”/”OUT”
Может быть
использован, если
трубуется полуние
операций,
входящих/исходящих
относительно кошелька.
По умолчанию
отображаются все.

sortColumn Текст 100 Необязательный Колонка, которая


выбрана для
сортировки
Может быть
использован, если По умолчанию

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 156 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

пользователем сортировка
применена сортировка производится по дате
значений в столбце создания заказа.
Допустимые значения:
DATE, SERVICE_ID,
AMOUNT

sortDirection Текст 4 Необязательный Направление


сортировки: ACS/DESC
Может быть По умолчанию
использован, если сортировка
пользователем производится в порядке
применена сортировка возрастания
значений в столбце

page Целое 0-999 Обязательный Номер страницы


положительное Для отображения
число первой страницы
необходимо задать page
=0

pageSize Целое 1-999 Обязательный Количество элементов


положительное на странице
число

requiredState Текст 100 Необязательный Операции с какими


статусами должны
быть возвращены.
Может быть
использован, если Допустимые значения:
трубуется фильтрация SUCCESSFUL,
успешных/неуспешных UNSUCCESSFUL, ALL
операций. По
умолчанию
отображаются все.

1.1.1 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 10 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа. Техническая
информация для
Присутствует, если инженеров
errorCode отличен от 0 эксплуатации

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Клиента
Присутствует, если
errorCode отличен от 0

operations[] Массив - Обязательный Список операций,


объектов типа отвечающих критерию
operation. поиска.

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 157 из 214
ООО «Рунет Бизнес Системы» :
:
11.1.2 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getOperationsHistory.do?
userId=CUI178770451&page=0&pageSize=10&sortColumn=DATE&sortDirection=DESC&directi
on=["IN","OUT"]
{
"operations": [{--перевод с чужого ПИ
"mdOrder": "408807101",
"state": 2,
"transactionErrorCode": "0",
"refNum": "720619000012",
"approvalCode": "ABC123",
"date": "25/07/2017 19:03:44",
"operationType": "TRANSFER",
"direction": "IN",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02",
"userId": "CUI842613919",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE583",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "CARD_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с непривязанной карты на чужой счет ЭДС",
"bonusPoints": 18
},
{--платеж
"mdOrder": "408604101",
"state": 2,
"transactionErrorCode": "0",
"refNum": "720614000000",
"approvalCode": "ABC123",
"date": "25/07/2017 14:58:47",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"bonusPoints": 10,
"service": {
"category": "test",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 158 из 214
ООО «Рунет Бизнес Системы» :
:
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
},
{--перевод на чужой ПИ
"mdOrder": "408807101",
"state": 2,
"transactionErrorCode": "0",
"refNum": "720619000012",
"approvalCode": "ABC123",
"date": "25/07/2017 19:03:44",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"bindingType": "ANONYMOUS_CARD",
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02",
"userId": "CUI842613919"
},
"transferType": "CARD_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с непривязанной карты на чужой счет ЭДС",
"bonusPoints": 18
},
{--перевод между своими ПИ
"mdOrder": "408806401",
"state": 2,
"transactionErrorCode": "0",
"refNum": "720618000009",
"approvalCode": "ABC123",
"date": "25/07/2017 18:20:13",
"operationType": "TRANSFER",
"direction": "INNER",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"bindingType": "BOUND_CARD",
"mnemonic": "TEST_NON_3DS_CARD",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 159 из 214
ООО «Рунет Бизнес Системы» :
:
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_BINDING",
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Перевод с привязанной карты на счет ЭДС",
"bonusPoints": 6
},
{--пополнение счета ЭДС (TOP UP)
"mdOrder": "0C355ED6F9994C3D88B41BEF4006C51E",
"state": 1,
"transactionErrorCode": "0",
"refNum": "720915000002",
"approvalCode": "ABC123",
"date": "28/07/2017 15:35:53",
"operationType": "TOP_UP",
"dstBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"bindingType": "EMONEY_ACCOUNT",
"mnemonic": "EMONEY_ACCOUNT"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
"currencyCode": "RUB"
}
}],
"errorCode": 0
}

11.2 getOperationDetails – деталей по операции

11.2.1 Запрос
Параметр Тип данных Размер Обязательность Описание

userId Числовой 32 Обязательный Уникальный


идентификатор
пользователя

mdOrder Текст 50 Обязательный Уникальный номер


операции на ПЦ

1.1.2 Ответ
Параметр Тип данных Размер Обязательность Описание

errorCode Целое 10 Обязательный Код ответа


положительное 0 если ошибок нет
число

errorCause Текст 250 Опциональный Расшифровка кода


ответа. Техническая
информация для

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 160 из 214
ООО «Рунет Бизнес Системы» :
:
Параметр Тип данных Размер Обязательность Описание

Присутствует, если инженеров


errorCode отличен от 0 эксплуатации

errorMessage Текст 200 Опциональный Информационное


сообщение об ошибке
для Клиента
Присутствует, если
errorCode отличен от 0

operation* Набор полей из - Обязательный Данные об операции


комплексного
типа operation.

11.2.2 Пример (платеж)


https://mts.rbsdev.com/ewallet/3.4/mts/getOperationDetails.do?
userId=CUI178770451&mdOrder=1163005
{
"mdOrder": "408604101",
"state": 2,
"transactionErrorCode": "0",
"refNum": "720614000000",
"approvalCode": "ABC123",
"date": "25/07/2017 14:58:47",
"operationType": "PAYMENT",
"srcBinding": {
"phoneNumber": "79161234570",
"maskedPhoneNumber": "7916**70",
"userId": "CUI178770451",
"bindingId": "DE9A8880BC954D1292357B7D14202C62",
"bindingType": "BOUND_CARD",
"mnemonic": "VISA*0043",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
"currencyCode": "RUB"
},
"comment": "Комментарий к платежу",
"bonusPoints": 10,
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
},
"errorCode": 0
}

11.2.3 Пример (перевод на чужой ПИ)


https://mts.rbsdev.com/ewallet/3.4/mts/getOperationDetails.do?

Имя файла: 521156780.docx Дата последней версии:


Разработчик Версия стр. 161 из 214
ООО «Рунет Бизнес Системы» :
:
userId=CUI178770451&mdOrder=1146003
{
"mdOrder": "408807101",
"state": 2,
"transactionErrorCode": "0",
"refNum": "720619000012",
"approvalCode": "ABC123",
"date": "25/07/2017 19:03:44",
"operationType": "TRANSFER",
"direction": "OUT",
"srcBinding": {
"bindingType": "ANONYMOUS_CARD",
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"maskedPhoneNumber": "7916**02",
"userId": "CUI842613919"<