МТС ПЦ ЭК Протокол Подключения Агрегаторов и ТСП

«УТВЕРЖДАЮ» «УТВЕРЖДАЮ»
Руководитель отдела ….. Технический директор

ПАО «МТС» ООО «РБС»
__________________ / _____________/ __________________ /_____________./
ПРОЦЕССИНГОВЫЙ ЦЕНТР СЕРВИСА «ЭЛЕКТРОННЫЙ

КОШЕЛЕК МТС ДЕНЬГИ»
Протокол подключения витрин и приложений
Описание протокола
Москва 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 (т.к. не поддерживается модулем АвП)

:
2. Исправлен пример указания списка идентификаторов автоплатежей в примере
вызова сервиса deleteAutopaymentsBatch
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

:
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 Аносов Д.А.
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. Н.

:
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

:
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.

:
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

:
Содержание
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

:
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

:
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

:
:
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 из тела запроса.
Параметр может отсутствовать для запросов, совершаемых
их неавторизованной зоны.

:
Параметр в заголовке Обязательность Описание
Х-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.

:
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 Продукт партнера (на будущее)

:
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 Нет Операция отменена клиентом. Используется,

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

:
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 Неверный номер карты

:
31 Пустая дата истечения срока действия карты
32 Неверная дата истечения срока действия карты
33 Пустое значение CVC2
34 Неверное значение CVC2
35 У карты истек срок действия
36 Неверное имя держателя карты
37 Ошибка проверки вовлечения в сервис 3DSecure
38 Пустой номер заказа
39 Неверный номер заказа
40 Пустая сумма
41 Неверная сумма
42 Код зарезервирован для использования в будущем
43 Все попытки подтверждения связки неуспешные (при подтверждении

прикрепляемой карты с помощью транзакции на случайную сумму)
44 Пустой номер поставщика услуг
45 Поставщик услуг не найден по уникальному номеру
46 Параметры поставщика услуг пустые
47 Параметры поставщика услуг неверные
51 Нельзя установить статус связки (платежного инструмента)
53 Неверное отчество
54 Мошенничество
55 Сумма меньше минимально разрешенной для сервиса
56 Сумма больше максимально разрешенной для сервиса
76 Неверный статус связки (платежного инструмента)
77 Пустая валюта
78 Недопустимая валюта, ошибка формата указания валюты или

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

:
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 Неверная сумма

:
119 Пользователь уже зарегистрирован
126 Не найден получатель
143 Неверный формат банковского идентификтаора
144 Дубликат мнемонического имени связки
145 Клиент банка не найден
150 Неверный банковский номер счета
152 Не найдет договор
153 Неверная связка для источника средств в операции перевода
154 Неверная связка для получателя средств в операции перевода
155 Связки не найдены
157 Истекло время применимости кода подтверждения
158 ЛС недоступен для МК
159 Номер карты отправителя совпадает с номером карты получателя
160 Баланс ЛС для МК не удалось определить
161 Неверная JSON спецификация рекурентной операции
162 Указано пустое расписание для рекуррентной операции
163 Указано неверное расписание для рекуррентной операции
164 Указано пустое описание для рекуррентной операции
166 Неверный идентификатор рекуррентной операции
167 Карта не найдена
168 Связка не найдена
190 Пустой идентификатор операции в партнерской системе
191 Парнерская система передала дубликат идентификатора операции
192 Не удалось проверить баланс ПИ-источника операции

:
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 Транзакция не разрешена для ПИ

:
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 Недопустимый запрос

:
404 Не найден обработчик для вызываемого метода API
912 Пользователь был заблокирован
913 Неверная версия API
914 Ошибка идентификации партнерской системы
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 Проверка лимита ЛС: минимальная сумма платежа

:
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 Биллинг: операция с указанным номером найдена, но сумма

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

:
Система банка (через MQ)
30000 Ошибка общего характера при взаимодействии с системой банка
30001 Неуспешный ответ от системы банка
30002 Таймаут получения ответа от системы банка
30003 Недопустимый ответ от системы банка

МТС-Банк (через MQ)
40000 Не указан или пустой идентификатор транзакции
40001 Невозможно найти транзакцию по переданному идентификатору
40002 Запрос содержит данные недостаточные для выполнения операции
40003 Недопустимый ответ от системы банка
40004 Неверный формат номера карты в сообщении МТС Банка
40005 Тайм-аут получения ответа от сервиса МТС-банка

Взаимодействие с модулем автоплатежей
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 Ошибки по кредитным операциям

:
ХХХ – описание значений ошибок приведен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 Дата/время Формат – Опциональный Дата регистрации

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

:
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 Опциональный Минимальная

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

:
после запятой
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
(заблокирована по

:
требованию МТС,
истёк срок
действия и т.п.)
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 Обязательный Сумма без учёта комиссий

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

число

:
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 – суббота,

:
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 Опциональный Валюта перевода

:
переводов
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 Текст Опциональный Номер ссылки из

процессинга

:
Данное поле
дублирует
значение поля
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). Для ограничен.
обеспечения

:
обратной
совместимости
данное поле
будет
возращаться
пустым даже для
операций, где по
бизнес-смыслу
нет ПИ
списания, но это
будет убрано в
ближайшее
время.
srcParentBinding Набор Опциональный Параметры родительского

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

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

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

Присутствует в
случае
переводов
transferOnDeman Набор Опциональный Данные о переводе не

dData параметров. Присутствует в клиенту
Комплексный случае
тип – переводов не
transferOnDe клиентам
mandData.
service Набор - Опциональный Краткая информация об

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

:
serviceData.

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
присутствовать
только в ответах

:
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 клиента. Возможные

:
значения см.п.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 Опциональный Код причины

разблокировки в

:
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 - Обязательный Лимит баланса ПИ в

соответствии с уровнем
идентификации

:
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

:
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

:
{"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
где:
{partner} Наименование сервиса, который выполняет обращение
HTTP method POST или GET
Параметр Тип Обяз. Описание

token Текст Обязательный Сертификат (формат PEM)
3.2.2 Ответ
HTTP status code 200 OK
Content-Type application/json

errorCode Число Обязательный Результат выполнения запроса: 0 –
запрос выполнен; ≠0 – в противном
случае
errorMessage Текст Опциональный Расшифровка кода ответа для клиента.
Указывается, если запрос не выполнен
(errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание кода ответа
для обслуживающего персонала.
(errorCode≠0)

:
(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
где:

:
HTTP method GET или POST

providerId Текст Обязательный Идентификатор ТСП (PROVIDER.EXTERNAL_ID
в каталоге ПЦЭК)
providerSpId Текст Обязательный Идентификатор сервис-провайдера (агрегатора), к
которому относится ТСП
(SERVICE_PROVIDER.ID в каталоге ПЦЭК)
3.3.2 Ответ
HTTP status code 200 OK Запрос обработан сервисом
Content Содержит структуру в формате JSON, поля которой описаны ниже. Указывается в
случае, если запрос был обработан сервисом (200 OK)

успешно,
≠0 – в противном случае.
пользователя. Указывается,
если запрос выполнен
неуспешно (errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание
кода ответа для
Указывается, если запрос не
выполнен (errorCode≠0)
Указывается, если запрос
выполнен неуспешно
(errorCode≠0)

:
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 – Доступные ПИ пользователя кошелька для платежной

операции в пользу ТСП
Метод предназначен для предоставления информации о доступных для пользователя кошелька платежных
инструментах, с которых пользователь может оплачивать товары / услуги заданного ТСП.

:
3.4.1 Запрос
HTTP path /{path}/{version}/{partner}/getUserBindingsForProvider.do
где:
HTTP method GET или POST

userId Текст Обязательный Идентификатор пользователя кошелька
providerId Текст Обязательный Идентификатор ТСП (PROVIDER.EXTERNAL_ID
в каталоге ПЦ ЭК)
providerSpId Текст Обязательный Идентификатор сервис-провайдера (агрегатора), к
которому относится ТСП
(SERVICE_PROVIDER.ID в каталоге ПЦ ЭК)
3.4.2 Ответ
HTTP status code 200 OK Запрос обработан сервисом
Content Содержит структуру в формате JSON, поля которой описаны ниже. Указывается в
случае, если запрос был обработан сервисом (200 OK)

успешно,
≠0 – в противном случае.
пользователя. Указывается, если
запрос выполнен неуспешно
(errorCode≠0)
errorMessageDesc Текст Опциональный Дополнительное описание кода
ответа для обслуживающего
персонала. Указывается, если
(errorCode≠0)
Указывается, если запрос
выполнен неуспешно
(errorCode≠0)

:
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 Пример. Ошибка в параметрах запроса


:
providerId=1&providerSpId=-3
{"errorCode":400,"errorCause":"Parameter 'userId' is blank"}
3.4.6 Пример. Ошибка. Поставщик не найден по параметрам

providerId=2&providerSpId=-3&userId=1
{"errorCode":45,"errorMessage":"Поставщик услуг не найден по уникальному

номеру","errorMessageDesc":"Поставщик услуг не найден по уникальному
номеру","errorCause":"Provider not found"}
3.4.7 Пример. Ошибка. Пользователь не найден по идентификатору

providerId=1&providerSpId=-3&userId=-1
{"errorCode":916,"errorMessage":"Пользователь не найден по
идентификатору","errorMessageDesc":"Пользователь не найден по
идентификатору","errorCause":"USER_NOT_FOUND_BY_ID"}

:
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

:
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 ИНН поставщика

:
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[] Перечень типов платежных инструментов, которые можно использовать

:
для оплаты данной услуги
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. Клиент
может скрывать вводимые пользователем

:
символы.
ComboBox Список Сервер принимает id одного элемента из

справочника
4.2 getProviderInfo – Получение информации о ТСП

Данный запрос может использоваться Витриной получения информации о ТСП.
4.2.1 Запрос
serviceProviderId Число 19 Обязательный Номер идентификатор

агрегатора, к которому
относится ТСП
providerId Строка 64 Обязательный Уникальный

идентификатор ТСП в
разрезе агрегатора
4.2.2 Ответ
icon Строка - Опциональный Относительный адрес

Обязательный, файла с картинкой для
если errorCode = 0 ТСП
name Строка - Опциональный Наименование ТСП

Обязательный,
если errorCode = 0
subline Строка - Опциональный Наименование ЮЛ ТСП

Обязательный,
если errorCode = 0

число
errorCause Текст 250 Опциональный Расшифровка кода ответа
для errorCode=0

сообщение об ошибке для
Пользователя;
для errorCode=0
4.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getWallet.do?
serviceProviderId=-1
&providerId=test
{
"icon": "a",
"name": "TEST",

:
"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 ИНН поставщика

:
kpp КПП поставщика

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[] Перечень типов платежных инструментов, которые можно использовать

:
для оплаты данной услуги
eCommercePurchaseCategories [] Данные о категории e-commerce поставщиков

Структура аналогична структуре categories[] для «обычного» справочника
поставщиков
references[] Используемые справочники
regions[] Данные справочника и его наименование (в данном случае справочник

регионов)
id Ключ значения справочника (в данном случае код региона)
value Наименование значения (в данном случае наименование региона)
4.4 getAllPaymentsExtended – Получение полного списка платежей в системе

Данный метод можно использовать вместо метода /providers.do для получения справочника платежей.
Особенность метода - выводит плоский список всех платежей, имеющихся в системе, без учета их видимости
партнеру, вызывающему метод. Также список не учитывает категории и группы.
4.4.1 Структура данных

Структура данных для единичного платежа в списке - идентична структуре для платежа в выводе метода
providers.do, за исключением дополнительного агрегата "visibleToPartners" в группе params[].
payments[] Данные о платежах в группе

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"
],

:
5 Группа сервисов «Управление кошельками»
5.1 getWallet – Получение клиента

Данный запрос должен использоваться Витриной для проверки наличия профиля (электронного кошелька)
пользователя по номеру телефона и получения его идентификатора.
5.1.1 Запрос
phone Целое 15 Обязательный Номер мобильного

положительное телефона пользователя в
число международном формате
MSISDN
5.1.2 Ответ
user* Набор полей из - Данные пользователя

комплексного (кошелька)
типа user.

число
для errorCode=0

для 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 – Получение клиента по идентификатору пользователя

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

:
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 Запрос

положительное телефона
число пользователя в
международном
формате MSISDN
5.3.2 Ответ
userId Числовой 32 Обязательный Уникальный


положительное Равен 0 если ошибок нет
число

ответа
для errorCode=0

для errorCode=0

:
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 Запрос

5.4.2 Ответ

число

ответа
для errorCode=0

для errorCode=0
5.4.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/performSimplifiedIdentification.do?
userId=00000000100000001593
{"errorCode":0}
5.5 bindMtsBankCustomer – привязка клиента и инструментов МТС-Банка к ЭК

Запрос выполняется для связывания электронного кошелька с клиентом МТС-Банка. Это означает полную
идентификацию клиента и доступность в электронном кошельке всех платежных инструментов МТС-Банка.

:
5.5.1 Запрос

mtsBankCustId Текст 32 Обязательный Уникальный

клиента МТС-Банка
skipChangeIdentificationLeve Логический true/false Опциональный Флаг,

l отключающий
увеличение уровня
идентификации
кошелька до
FULL_IDENTIFIED
5.5.2 Ответ

число

ответа
для errorCode=0

для 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 Запрос

:
5.6.2 Ответ

число

ответа
для errorCode=0

для 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}

:
6 Группа сервисов «Платежные инструменты»
6.1 getBindings – Получение списка Платежных инструментов

Получение списка Платежных инструментов, подключенных к кошельку
Запрос поддерживает возможность выборки карт по указанному статусу или нескольким статусам. В этом
случае в параметре bindingStatus необходимые статусы должны быть перечислены через запятую.
Существует возможность использовать дополнительные признаки карты, привязанной к профилю. Для начала
использования каждого нового дополнительного признака необходимо согласование формальных требований к
хранению и использованию этого признака между представителем компании-разработчика
витрины/приложения и представителей БПЦ.
Примером дополнительного признака является «Цвет карты» (color). Параметр передается и хранится как код
цвета в формате RGB – (r, g, b), где r, g и b имеют значение от 0 до 255.
6.1.1 Запрос

bindingStatus Текст 50 Опционально Если параметр не

указан, выводятся
все карты во всех
статусах
Допускается поиск
по нескольким
статусам
одновременно –
статусы разделяются
запятой
Коды статус
приведены в п. 2.1.2
bindingParams[] Набор параметров - Необязательный Набор

color Текст Формат – (r, g, Необязательный Цвет Платежного

b), где r, g и b инструмента,
имеют значение присвоенный
от 0 до 255 пользователем.
Значения по-
умолчанию не
имеет.
6.1.2 Ответ
bindings[] Набор параметров. - Обязательный Параметры

Комплексный тип платежных
binding. инструментов в
кошельке.
Возвращаются
записи по всем
инструментам в

:
кошельке.

число
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 Запрос

pan Текст 19 Обязательный Номер карты
expiry Целое 6 Обязательный Год и месяц

положительное Формат – действия карты
число YYYYMM
cardholderName Текст 100 Опциональный Имя держателя

карты
cvc Целое 4 Опциональный СVC-код

положительное Может не содержать
число данных, если оплата
производится
картой Maestro
В остальных
случаях должен
содержать данные
mnemonic Текст 100 Обязательный Мнемоническое имя

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

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

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), на который

:
Присутствует, клиент должен быть

если карта перенаправлен
bindings[] Набор параметров. - Условный Параметры

Присутствует, кошельке.
если Возвращаются записи
confirmationType = по всем
VERIFY_AMOUN инструментам в
T кошельке.
errorCode Целое положительное 3 Обязательный Код ответа

число 0 если ошибок нет

ответа
Присутсвует в
случае ошибки

ошибке для
Присутсвует в Пользователя;
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",

:
"bindingStatus": 2,
"expiry": "201801",
"maskedPan": "400001******0043",
"cardType": "VISA",
"bankStatus": "UNKNOWN",
"is3DSecureBinding": true
},
...
],
"errorCode": 0
}
6.3 confirmCardBinding3ds – Подтверждение регистрации карты после 3DSecure

Запрос confirmCardBinding3ds предназначен для подтверждения регистрации карты в кошельке после 3DSecure
аторизации.
6.3.1 Запрос

mdOrder Текст 50 Условный Уникальный номер

Обязательный, если
подтверждение карты
производится по
mdOrder
PaRes Текст - Условный Параметр, который

был получен от ACS
банка эмитента при
Обязательный, если прохождении
карта вовлечена в 3DSecure
3DSecure
6.3.2 Ответ

исло

ответа
errorCode=0

ошибке для
errorCode=0

Присутствует для идентификатор ПИ
errorCode=0

:
confirmationType Текст 50 Опциональный Возможное значение

Присутствует, если VERIFY_AMOUNT
вместо
аутентификации
пользователя была
только попытка
(PARes(A))

Присутствует для кошельке.
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",
"createdDate": "27/01/2017 16:50:46",
"updatedDate": "27/01/2017 16:50:46",
"bindingStatus": 0,
"expiry": "201801",
"maskedPan": "400001******0001",
"cardType": "VISA",
}
...
],
"errorCode": 0
}
Попытка аутентификации (PARes(A))

{
"createdBindingId": "094254EE8A9144659A7F740979F59C55",
"bindings": [
...
{
"bindingId": "094254EE8A9144659A7F740979F59C55",

:
"createdDate": "27/01/2017 16:52:16",
"updatedDate": "27/01/2017 16:52:16",
"bindingStatus": 2,
"expiry": "201801",
"maskedPan": "400001******0001",
"cardType": "VISA",
}
...
],
"errorCode": 0
}
Пользователь не прошел аутентификацию (PARes(N)):

{
"createdBindingId": "094254EE8A9144659A7F740979F59C55",
"bindings": [
...
{
"bindingId": "094254EE8A9144659A7F740979F59C55",
"createdDate": "27/01/2017 16:52:16",
"updatedDate": "27/01/2017 16:52:16",
"bindingStatus": 2,
"expiry": "201801",
"maskedPan": "400001******0001",
"cardType": "VISA",
}
...
],
"errorCode": 0
}
6.4 confirmCardBindingByAmount – Подтверждение регистрации карты по сумме

Сервис confirmCardBindingByAmount предназначен для подтверждения регистрации карты по случайной
сумме. Возможны два сценария использования
1) Первый сценарий. Пользователь подтверждает регистрацию карты сразу после верификационного
платежа. В этом случае внешняя система (сайт) должна передавать в confirmCardBindingByAmount
входной параметр mdOrder
2) Второй сценарий. Если пользователь начал, но сразу не завершил привязку карты (не подтвердил
регистрацию карты в рамках одной сессии на стороне сайта). В этом случае пользователь имеет
возможность, узнав случайную сумму верификационного платежа, через некоторое время войти в
систему, запросить список карт и подтвердить регистрацию карты. Внешняя система (сайт, мобильное
приложение) выполняет запрос getBindings, в ответ на который получает от ПЦ ЭК перечень всех
привязанных к профилю пользователя карт. Карты в статусе «2» (toVerify) могут быть подтверждены
пользователем. Для подтверждения внешняя система должна передавать в
confirmCardBindingByAmount с входным параметром bindingId.
Пользователь имеет возможность совершить 3 попытки ввода параметров верификационного платежа. В
случае, если все 3 попытки будут неуспешными, ПЦ ЭК архивирует карту, и процедура регистрации должна
быть пройдена заново.

:
6.4.1 Запрос


mdOrder
bindingId UUID 32 Условный Уникальный

Обязательный, если инструмента
bindingId
amount Положительное 9,2 Условный Сумма

число с двумя верификационного
знаками после платежа
запятой Передается, если
подтверждение по
суммы (без 3DSecure)
6.4.2 Ответ

исло

ответа
errorCode=0

ошибке для
errorCode=0

Присутствует для идентификатор ПИ
errorCode=0

Присутствует для кошельке.
errorCode=0 Возвращаются
кошельке.

:
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": [
...
{
"createdDate": "27/01/2017 16:22:06",
"updatedDate": "27/01/2017 16:56:58",
"bindingStatus": 0,
"expiry": "201801",
"maskedPan": "400001******0043",
"cardType": "VISA",
}
...
],
"errorCode": 0
}
6.5 createCardBindingAfterPayment – Создание связки после платежа

Запрос createCardBindingAfterPayment предназначен привязки карты использованной при оплате.
6.5.1 Запрос



:
mdOrder

положительное Отсутствует, если
число платеж mdOrder был
проведен с 3DS или
если карта не
содержит cvc
(Например, Maestro).

карты

о желании

6.5.2 Ответ
confirmationType Текст 50 Опциональный Возможные

Присутствует, если значения
mdOrder соответстует FINISH_3DS – карта
платежу, вовлечена в
обработанному без 3DSecure, для
3DSecure привязки нужно
В этом случае ПЦ пройти авторизацию
проверит карту на VERIFY_AMOUNT
вовлеченность – карта не вовлечена
повторно. в 3DSecure, для
передать случайную
сумму

Присутствует, если операции в ПЦ ЭК
confirmationType =
FINISH_3DS

Присутствует, если идентификатор ПИ
confirmationType =
VERIFY_AMOUNT
paReq Текст - Условный Параметр для

проведения
процедуры 3DSecure
Присутствует, если
карта вовлечена в Если присутствует в
программу 3DS ответе, то карта

:
3DSecure
acsUrl Текст 2000 Условный URL-адрес банка

эмитента (сервер
ACS), на который
Присутствует, если клиент должен быть
карта вовлечена в перенаправлен

Присутствует, если кошельке.
confirmationType = Возвращаются
VERIFY_AMOUNT записи по всем
кошельке.

число

ответа
Присутсвует в случае
ошибки

ошибке для
Присутсвует в случае Пользователя;
ошибки

проведении
Присутсвует, если операции
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 Запрос


:

платежного

о желании
платежный
инструмент по
умолчанию при
платежах
6.6.2 Ответ
createdBindingId UUID 32 Обязательный Уникальный

созданного Платежного
инструмента (ПИ)
bindings[] Набор параметров. - Обязательный Параметры платежных

Комплексный тип инструментов в
binding. кошельке.
Возвращаются записи
по всем инструментам в
кошельке.

положительное Равен 0 если ошибок нет
число

ответа
для errorCode=0

для 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": [
{

:
"bindingId": "BB4F631CE9494BB5AC1EE7DD4F2C8598",
"createdDate": "25/08/2016 11:25:06",
"updatedDate": "25/08/2016 11:25:06",
"isDefaultBinding": true,
"bindingStatus": 0,
"issuerGroup": "EXTERNAL",
"expiry": "201701",
"maskedPan": "404266******0000",
"cardType": "VISA",
},
{
"bindingId": "ADAACA549AE74A30AA76D839473F8124",
"mnemonic": "emoney",
"createdDate": "08/09/2016 11:04:54",
"updatedDate": "08/09/2016 11:04:54",
"bindingType": "EMONEY_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"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",
"bindingType": "MTS_ACCOUNT",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "79104379469",
"maskedPhoneNumber": "7910**69"
}
],
"errorCode": 0
}
6.7 updateBinding – Изменение параметров Платежного инструмента

Данный запрос используется в случае, если пользователю необходимо изменить какие-либо параметры
привязанной к его профилю карты или продукта, например, мнемоническое имя.
6.7.1 Запрос



:
isDefaultBinding Да/Нет true/false Условный Сделать ПИ

инструментом по
умолчанию,
предлагаемым по
умолчанию
mnemonic Текст 100 Условный Изменить

мнемоническое
имя ПИ
bindingParams[] Набор – Условный Набор

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

число

ответа
errorCode=0

ошибке для
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 Запрос


:

6.8.2 Ответ

число

ответа
errorCode=0

ошибке для
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 Запрос


6.9.2 Ответ

:

число

ответа
errorCode=0

ошибке для
errorCode=0
Набор параметров. - Условный Параметры

Комплексный тип Обязательный для указанного
binding. errorCode=0 платежного
инструмента –
продукта Банка
6.9.3 Пример (успешное выполнение запроса)

https://mts.rbsdev.com/ewallet/3.4/mts/ getProductBindingWithBalance.do?
{
"bindingId": "0DD25E1A9BCB4AF89155A16FF04EC542",
"mnemonic": "5337 **** **** 3881",
"createdDate": "02/11/2016 13:57:06",
"updatedDate": "02/11/2016 13:57:06",
"bindingType": "GENERAL_CARD",
"bindingStatus": 0,
"currency": "643",
"expiry": "201901",
"maskedPan": "5337********3881",
"cardType": "MASTERCARD",
"balance": "227,96",
"is3DSecureBinding": false,
"errorCode": 0
}
6.9.4 Пример (ПИ не найден)

https://mts.rbsdev.com/ewallet/3.4/mts/ getProductBindingWithBalance.do?
{"errorCode":168,"errorCause":"BINDING_NOT_FOUND"}
6.10 updateBankProducts – обновление ПИ-продуктов Банка

Запрос выполняется для обновления списка ПИ-продуктов Банка в базе ПЦ ЭК. Предполагается выполнять этот
запрос после входа клиента в интерфейс, перед выполнением запроса getBindings, чтобы результат getBindings
мог содержать ПИ, которые добавились у клиента, либо не содержал ПИ, которые по каким-то причинам стали
недоступны, например, клиенту была выпущена новая карта или истек срок депозита.

:
6.10.1 Запрос

6.10.2 Ответ

число

ответа
errorCode=0

ошибке для
errorCode=0

Комплексный тип Обязательный для платежных
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 Строка Статус счета в

банке

:
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 Запрос

pan Текст 19 Обязательный Номер карты
expiry Целое 6 Обязательный Год и месяц

число YYYYMM

карты

карты

о желании

6.11.2 Ответ

Присутствует, идентификатор ПИ
если
confirmationType =
VERIFY_AMOUN
T

:

Присутствует, кошельке.
если Возвращаются записи
confirmationType = по всем
VERIFY_AMOUN инструментам в
T кошельке.


ответа

ошибке для

Присутсвует, если
6.12 getTechnicalAccountBalance – Получение баланса транзитного счета ЭДС
6.12.1 Запрос

6.12.2 Ответ
balance “сумма” Опциональный Баланс транзитного

Присутствует, счета
errorCode=0
amount Положительное 9,2 Обязательный Сумма в основных

число, два знака единицах валюты
currency Целое положительное 3 Обязательный Валюта баланса,

число цифровойкод


:
ответа

ошибке для

если 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 Запрос

6.13.2 Ответ
balance “сумма” Опциональный Баланс транзитного

Присутствует, счета
errorCode=0
amount Положительное 9,2 Обязательный Сумма в основных

число, два знака единицах валюты

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

положительное цифровойкод
число

число
errorDesc Текст 250 Опциональный Расшифровка кода

ответа
errorCode=0

ошибке для
errorCode=0
errorMessageDesc Текст 250 Опциональный Расшифровка

проведении
Обязательный, если операции

https://mts.rbsdev.com/ewallet/3.4/mts/getMtsAccountBalance.do?userId=00000000100000001555
{
"balance": {
"amount": "100,23",
"currency": "643"
},
"errorCode": 0
}

:
7 Группа сервисов «Платежи»
7.1 getPaymentTerms – Запрос расчета комиссии и лимитов на платеж

Данным запросом Витрина передает в ПЦ ЭК информацию о платеже и получает в ответ информацию о
размере комиссий и лимитах в зависимости от платежного инструмента, выбранного для оплаты. Сервис
сначала выполняет валидацию поступивших параметров. В случае успешной валидации в ответе возвращается
список результатов проверки возможности проведения операции для каждого ПИ, прикрепленного к кошельку,
при этом для каждого ПИ возвращается уникальное значение mdOrder, которое можно использовать как
входящий параметр запроса payment и не указывать прочие параметры операции. Время жизни mdOrder на ПЦ
ЭК ограничено (20 минут).
7.1.1 Запрос


Обязательный в случае инструмента
использования для операции
Платежного инструмента,
привязанного к профилю
клиента
pan Текст 19 Опциональный Номер карты
Обязательный в случае
оплаты непривязанной
картой
expiry Целое 6 Опциональный Год и месяц

число YYYYMM Может быть указан в
случае оплаты
непривязанной картой

карты
картой

число
Может быть указан в случае
картой
serviceId Текст 10 Обязательный Уникальный

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

:
число, два знака


число
serviceParams[] Набор параметров - Опциональный Атрибуты

оплачиваемой
услуги/товара
поставщика.
Если указаны, то
будут проверены

комментарий для
операции
masterpassOperati Текст 200 Опциональный Идентификатор

onId операции в
MasterPass
7.1.2 Ответ
service{} Набор - Обязательный Параметры сервиса, по

параметров которому производится
расчет деталей платежа
bindings[] Набор - Обязательный Параметры продукта

параметров

число
для errorCode=0

для errorCode=0
errorMessageDesc Текст 250 Опциональный Расшифровка причины

отказа в проведении
операции
7.1.3 service[] - Структура блока


:
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, параметр не
будет отрисован в
интерфейсе приложением

:
автоматически. Может
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[] - Структура блока


Платежного инструмента
mnemonic Текст Обязательный Мнемоническое имя

:
Платежного инструмента
isPaymentAllowe Да/Нет Обязательный Флаг, показывающий,

d возможно ли проведение
платежа с помощью
данного платежного
mdOrder Текст Опциональный Уникальный номер

операции в ПЦ ЭК,
присутствует только если
платеж с помощью
данного ПИ разрешен
actionCode Число Обязательный Код ответа для проверки

возможности проведения
платежа по данному ПИ. В
случае успеха равен 0, в
противном случае отличен
от нуля.
amount[] Набор - Обязательный Денежные параметры

параметров. операции
Комплексный
тип amount.
cvcRequired Да/Нет true/false Опциональный Признак обязательности

ввода кода CVV2/CVC2
для конкретного биндинга
по конкретной операции
Возвращается, только если
ПИ является банковской
картой.
maskedPan Текст Опциональный Маскированный номер

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

YYYYMM Возвращается, только если
картой.
cardType Текст Опциональный Тип платежной карты:

VISA/MASTERCARD/MA
ESTRO.
картой.
account Текст Опциональный Номер счета ПИ,

например, номер ЛС МТС.
ПИ не является
банковской картой.
additionalInfo{} Набор Опциональный

параметров

:
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",
"account": "79161234570",
"mdOrder": "1472812837310001",
"userSelected": false,
"actionCode": "0",
"amount": {

:
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
}
}],
"service": {
"id": "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"
}
}
Неуспешный ответ по одному из ПИ

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": [{
"maskedPan": "400001******0001",
"expiry": "202512",
"cardType": "VISA",
"mdOrder": "1472813223204002",
"actionCode": "0",
"amount": {
"total": "122,65",
"base": "111,20",
"fee": "11,45",
"currency": 643,
}
},
{
"isPaymentAllowed": false,
"account": "79161234570",
"actionCode": "1001",
"amount": {
"total": "111,20",
"base": "111,20",

:
"currency": 643,
}
}],
"service": {
"id": "test",
"icon": "a",
"amount": {
"min": 100,
"max": 10000000
},
"params": [{
"paramTitle": "p1",
"paramName": "p1",
"regExp": "\\w{1,5}",
"maxLength": 5,
}],
"regions": [],
}
}
Неуспешный ответ по всем ПИ
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": [{
"isPaymentAllowed": false,
"account": "79161234570",
"actionCode": "1001",
"amount": {
"total": "111,00",
"base": "111,00",
"currency": 643,
}
}],
"service": {
"id": "test",
"icon": "a",
"amount": {
"min": 100,
"max": 10000000
},
"params": [{
"paramTitle": "p1",
"paramName": "p1",
"regExp": "\\w{1,5}",
"maxLength": 5,
}],

:
"regions": [],
}
}
7.2 payment – Произвести платеж или перевод

Данный запрос выполняется Витриной после запроса getPaymentTerms и подтверждения пользователем
параметров операции.
7.2.1 Запрос


операции в ПЦ
Обязательный при
наличии (из ответа
getPaymentTerms)

платеж выполняется без
использования метода
getPaymentTerms
картой и если платеж
выполняется без
getPaymentTerms
expiry Целое 6 Опциональный Год и месяц действия

положительное Формат – карты
число YYYYMM Обязательный в случае
getPaymentTerms, либо
если expiry не
передавался в запросе
getPaymentTerms
cardholderName Текст 100 Опциональный Имя держателя карты

:
getPaymentTerms

число
если cvc не передавался в
запросе getPaymentTerms
serviceId Текст Опциональный Уникальный

getPaymentTerms
serviceParams[] Набор - Опциональный Атрибуты

параметров конкретного
если serviceParams не
getPaymentTerms

операции
amount Положительное 9,2 Опциональный Сумма заказа

getPaymentTerms
currency Целое 3 Опциональный Валюта заказа

число
getPaymentTerms
masterpassOperationI Текст 200 Опциональный Идентификатор

d операции в MasterPass
is3dsRequired Логический true/false Опциональный Флаг необходимости

проведения 3ds вне
зависимости от
настроек способа

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

errorDesc Текст 250 Опциональный Расшифровка кода ответа
errorCode=0

errorCode=0
errorMessageDes Текст 250 Опциональный Расшифровка причины

c отказа в проведении
операции
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",
"mnemonic": "TEST_3DS_CARD",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},

:
"comment": "Комментарий к платежу",
"service": {
"category": "test",
"categoryName": "test",
"serviceId": "test",
"serviceName": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0,
"PaReq": "..."
}
7.2.4 Пример (карта не вовлечена в 3ds)

Карта не вовлечена в 3DS
{
"errorCode": 0,
"mdOrder": "408604101",
"state": 2,
"refNum": "720614000000",
"approvalCode": "ABC123",
"date": "25/07/2017 14:58:47",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"bonusPoints": 10,
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"providerReceiptParams": {
"supportPhone": "8-800-1234567"
}
}
}

:
7.2.5 Пример (Л/С требуется подтверждение вводом пароля на платежной странице)
Требуется подтверждение вводом пароля на платежной странице
{
"mdOrder": "408604301",
"state": 5,
"date": "25/07/2017 15:02:27",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"bindingId": "838EDF827F914BEC89C206F87548B886",
"mnemonic": "Phone 9161234570"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"confirmationType": "OTP_PAYMENT_PAGE",
"otpExpiresAt": "25/07/2017 15:12:27",
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0
}
7.2.6 Пример (Л/С требуется подтверждение по SMS)

Требуется подтверждение по SMS
{
"mdOrder": "408604901",
"state": 5,
"date": "25/07/2017 15:05:39",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "11,11",
"base": "11,11",
"currency": 643,

:
},
"confirmationType": "OTP_SMS_CALLBACK",
"otpExpiresAt": "25/07/2017 15:15:39",
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
},
"errorCode": 0
}
7.2.7 Пример (Л/С подтверждение не требуется)

Подтверждение не требуется
{
"errorCode": 0,
"category": "test",
"mdOrder": "223001",
"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,
},
"isTemplateAllowed": true}
{
"errorCode": 0,
"mdOrder": "408605501",
"state": 2,
"refNum": "720615000001",
"date": "25/07/2017 15:08:51",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {

:
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
},
"bonusPoints": 6,
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
}
}
7.2.8 Пример (Л/С подтверждение не требуется, отклонено процессингом)

Подтверждение не требуется, отклонено процессингом
{
"errorCode": 24,
"errorDesc": "1001",
"errorMessage": "error.code.24.1001",
"category": "test",
"mdOrder": "223001",
"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,
},
"isTemplateAllowed": true
}
{
"errorCode": 1001,
"errorMessage": "error.code.1001",
"mdOrder": "408606101",
"state": 6,
"refNum": "720615000002",
"date": "25/07/2017 15:12:21",
"srcBinding": {

:
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"fee": "0,00",
"currency": 643,
},
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}
7.2.9 Ошибка валидации входных данных

Ошибка валидации входных данных (указано невалидное значение expiry)
userId=CUI178770451&mdOrder=223001&expiry=2016ee
{"errorCode":32,"errorCause":"INVALID_EXPIRY"}
7.2.10 Пример без вызова getPaymentTerms

userId=CUI178770451&amount=100.10&currency=643&serviceId=12345&serviceParams={%
22p1%22:%2213456%22}&bindingId=838EDF827F914BEC89C206F87548B886
{
"errorCode": 0,
"category": "test",
"serviceId": "12345",
"mdOrder": "223003",
"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,
},
"isTemplateAllowed": true
}

:
{
"errorCode": 0,
"mdOrder": "408606801",
"state": 2,
"refNum": "720615000003",
"date": "25/07/2017 15:32:32",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
},
"bonusPoints": 6,
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
}
}
7.3 finish3ds – Завершить операцию с 3DSecure

Данный запрос должен выполняться в случае применения технологии 3DSecure. Пользователь возвращается с
ACS банка эмитента на сайт витрины. Витрина для завершения операции (платежа или перевода) должна
вызвать метод finish3ds и передать параметры PaRes и MD, полученный от ACS
7.3.1 Запрос


операции в ПЦ ЭК,
полученный в ответе
на payment
PaRes Текст - Обязательный Параметр, который

был получен от ACS
банка эмитента
после прохождения
3DSecure

:
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", то для совершения операции Витрина должна запросить у пользователя

:
одноразовый код. Витрина должна передать одноразовый код, который ввел пользователь, в ПЦ с помощью
этого сервиса.
7.4.1 Запрос


операции на ПЦ
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 Пример (введен неправильный пароль, закончились попытки подтверждения)

{"errorCode":107,"errorCause":"ALL_CONFIRMATION_ATTEMPTS_FAILED"}
7.4.5 Пример (вышло время подтверждения транзакции)

{"errorCode":157,"errorCause":"CONFIRMATION_CODE_EXPIRED"}
7.4.6 Пример (транзакция в статусе отличном от «ожидает подтверждения»)

{"errorCode":919,"errorCause":"TRANSACTION_IN_INCOMPATIBLE_STATUS"}
7.4.7 Пример (успешное подтверждение)

{
"errorCode": 0,
"mdOrder": "408801901",
"state": 2,
"refNum": "720616000002",
"date": "25/07/2017 16:09:52",
"srcBinding": {
"phoneNumber": "79161234570",

:
"userId": "CUI178770451",
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"bonusPoints": 10,
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
}
}
7.4.8 Пример (успешное подтверждение, транзакция отклонена в процессинге)

{
"errorCode": 1001,
"mdOrder": "408802501",
"state": 6,
"refNum": "720616000003",
"date": "25/07/2017 16:12:00",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"fee": "0,00",
"currency": 643,
},
"service": {
"category": "test",
"serviceParams": {

:
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}
7.5 reSendOtp.do – Повторная отправка одноразового пароля

Сервис reSendOtp.do предназначен для повторной отправки одноразового пароля.
7.5.1 Запрос


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",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"currency": 643,
},
"otpExpiresAt": "25/07/2017 16:24:49",
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",

:
"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",
"mdOrder": "408803701",
"state": 6,
"date": "25/07/2017 16:15:48",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"currency": 643,
},
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}
7.6 getPaymentStatus – Запрос состояния выполнения операции

Запрос выполняется Витриной после выполнения запросов payment для получения данных о результате
выполнения платежа/перевода.
7.6.1 Запрос



:
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 Пример (статус для успешно проведенной транзакции)

userId=00000000100000001555&mdOrder=408804901
{
"errorCode": 0,
"mdOrder": "408804901",
"state": 2,
"refNum": "720616000005",
"date": "25/07/2017 16:40:39",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"bonusPoints": 10,
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
}
}
7.6.5 Пример (транзакция отклонена в процессинге)

userId=00000000100000001555&mdOrder=408802501
{
"errorCode": 1001,

:
"mdOrder": "408802501",
"state": 6,
"refNum": "720616000003",
"date": "25/07/2017 16:12:00",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "9999,05",
"base": "9999,05",
"fee": "0,00",
"currency": 643,
},
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
}
}
}
7.6.6 Пример (транзакция ожидает подтверждения)

userId=00000000100000001555&mdOrder=d1ec7181-846d-42eb-a588-9990f6ace623
{
"errorCode": 0,
"mdOrder": "408805501",
"state": 5,
"date": "25/07/2017 16:50:02",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"otpExpiresAt": "25/07/2017 17:00:02",
"service": {
"category": "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>

:
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 Запрос

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

продукта клиента, используемого в
качестве платёжного средства.
1.1.2 Ответ
bindings[] Набор параметров. - Обязательный Параметры платежных

Комплексный тип инструментов в кошельке.
binding

:

число
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",
"createdDate": "16/08/2016 18:40:18",
"updatedDate": "16/08/2016 18:40:18",
"bindingStatus": 0,
"currency": "643",
"cardType": 0,
"phoneNumber": "79169998877",
}],
"errorCode": 0
}
1.2 getBToBTransferTerms - Запрос проверки допустимости выбранного перевода и

расчета комиссий в случае перевода между привязанными к ЭК платежными
инструментами
Запрос предназначен для проверки допустимости перевода на основании лимитов, доступности платежных
инструментов и других проверок. Также в рамках данного запроса рассчитывается комиссия за операцию. В
случае возможности проведения операции в ответе возвращается mdOrder – уникальный номер операции в ПЦ
ЭК. mdOrder можно использовать как входящий параметр запроса перевода, не указывая при этом параметры
операции. Время жизни mdOrder на ПЦ ЭК ограничено (20 минут).
1.2.1 Запрос

srcBindingId UUID 32 Обязательный Уникальный идентификатор

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

:
dstBindingId UUID 32 Обязательный Уникальный идентификатор

получателя перевода
amount Положительное 9,2 Обязательный Сумма перевода (без учета

число, два знака комиссии).
currency Целое положительное 3 Обязательный Валюта перевода

число

masterpassOperatio Текст 200 Опциональный Идентификатор операции в

nId MasterPass
1.2.2 Ответ

amount Набор параметров. - Опциональный Денежные параметры

Комплексный тип Обязательный, если операции. Данный метод
amount. errorCode = 0. возвращает только один
элемент.
srcBinding Набор параметров. - Обязательный Параметры платежного

Комплексный тип инструмента – источника
binding. перевода.
dstBinding Набор параметров. - Обязательный Параметры платежного

Комплексный тип инструмента – получателя

число
для errorCode=0

для errorCode=0
minAmount Положительное 9,2 Опциональный Минимальная сумма

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

:
значение значение
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": {
"createdDate": "01/09/2016 15:34:23",
"updatedDate": "01/09/2016 16:04:33",
"bindingStatus": 0,
"expiry": "201701",
"maskedPan": "404266******0000",
"cardType": "VISA",
},
"dstBinding": {
"bindingId": "E065993D6081441AA4D1C0BFD4FBE582",
"mnemonic": "EMONEY_ACCOUNT",
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "79166249598",
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
}
}
1.2.4 Пример (перевод с привязанной карты на привязанную карту)


:
&amount=100.00
&currency=643
{
"errorCode": 0,
"mdOrder": "942003",
"srcBinding": {
"createdDate": "01/09/2016 15:34:23",
"updatedDate": "01/09/2016 16:04:33",
"bindingStatus": 0,
"expiry": "201701",
"maskedPan": "404266******0000",
"cardType": "VISA",
},
"dstBinding": {
"bindingId": "4002613001454185829422FFF7B91D65",
"mnemonic": "TEST_NON_3DS_CARD",
"createdDate": "01/09/2016 15:38:48",
"updatedDate": "01/09/2016 16:04:33",
"bindingStatus": 0,
"expiry": "201701",
"maskedPan": "400001******0019",
"cardType": "VISA",
"is3DSecureBinding": false
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
}
}
1.2.5 Пример (перевод с ЛС МТС на счет ЭДС)

&amount=100.00
&currency=643
{
"errorCode": 0,
"mdOrder": "943003",
"srcBinding": {
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "24/06/2016 15:39:10",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "9161234570",

:
},
"dstBinding": {
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "79166249598",
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
}
}
1.3 getCardToBTransferTerms - Запрос проверки допустимости выбранного перевода и

расчета комиссий в случае перевода с непривязанной карты на привязанный к
ЭК платежный инструмент
1.3.1 Запрос

pan Текст 19 Обязательный Номер карты, с которой

осуществляется перевод
expiry Целое положительное 6 Обязательный Год и месяц действия карты,

число Формат – с которой осуществляется
YYYYM перевод
M
cardholderName Текст 100 Опциональный Имя держателя карты, с

которой осуществляется
перевод
dstBindingId UUID 32 Обязательный Уникальный идентификатор



число

:


nId MasterPass
1.3.2 Ответ


элемент.



число
для errorCode=0

для errorCode=0

выходит за

выходит за

:
1.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/getCardToBTransferTerms.do?userId=00000000100000001353
&pan=4042663601000000&expiry=201701&cardholderName=Ivan%20Ivanov
&amount=200.00
&currency=643
{
"errorCode": 0,
"mdOrder": "1042001",
"srcBinding": {
"createdDate": "27/09/2016 11:27:47",
"updatedDate": "27/09/2016 11:27:47",
"bindingType": "ANONYMOUS_CARD",
"bindingStatus": 0,
"maskedPan": "400001******0035",
"cardType": "VISA",
},
"dstBinding": {
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "79166249598",
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
}
}
1.4 getCardToEMTransferTerms - Запрос проверки допустимости выбранного перевода

и расчета комиссий в случае перевода с непривязанной карты на чужой счет
ЭДС
1.4.1 Запрос

:


M

перевод
srcPhone Целое положительное 15 Опциональный Номер мобильного телефона

число отправителя, используемый
при отправке SMS-
уведомлений получателю, в
случае переводов с
анонимной карты.
phone Целое положительное 15 Опциональный Номер мобильного телефона

число Может быть заменен пользователя в
на dstBindingId международном формате
MSISDN. Номер
мобильного телефона
используется для адресации
счета ЭДС, получателя
перевода
dstBindingId UUID 32 Опциональный Уникальный идентификатор

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


число


nId MasterPass
1.4.2 Ответ



:
элемент.



число
для errorCode=0

для errorCode=0

выходит за

выходит за
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": {
"createdDate": "07/10/2016 23:51:29",
"updatedDate": "07/10/2016 23:51:29",
"bindingStatus": 0,
"expiry": "201801",
"maskedPan": "400001******0035",
"cardType": "VISA",

:
},
"dstBinding": {
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "79160000002",
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
}
}
1.5 getBToEMTransferTerms - Запрос проверки допустимости выбранного перевода и

расчета комиссий в случае перевода с привязанного к ЭК платежного
инструмента на чужой счет ЭДС
1.5.1 Запрос



число Может быть заменен пользователя в
на dstBindingId международном формате
MSISDN. Номер
мобильного телефона
перевода

ЭК.

:


число


nId MasterPass
1.5.2 Ответ


элемент.



число
для errorCode=0

для errorCode=0

выходит за


:
выходит за
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": {
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "24/06/2016 15:39:10",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "9161234570",
},
"dstBinding": {
"createdDate": "07/09/2016 13:10:39",
"updatedDate": "08/09/2016 20:40:19",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "79160000002",
},
"amount": {
"total": "23,40",
"base": "21,22",
"fee": "2,18",
"currency": 643,
}
}
1.6 getBToCardTransferTerms - Запрос проверки допустимости выбранного перевода и

расчета комиссий в случае перевода с привязанного к ЭК платежного
инструмента на непривязанную карту

:
1.6.1 Запрос


targetPan Текст 19 Обязательный Номер карты, на которую

осуществляется перевод.
Передается только номер
карты получателя, этого
достаточно для переводов
внутри страны.


число

dstPhone Числовой 10 Опциональный Номер телефона получателя

перевода

nId MasterPass
1.6.2 Ответ


элемент.



число

:
для errorCode=0

для errorCode=0

выходит за

выходит за
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": {
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "24/06/2016 15:39:10",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "9161234570",
},
"dstBinding": {
"createdDate": "04/10/2016 15:26:22",
"updatedDate": "04/10/2016 15:26:22",
"bindingStatus": 0,
"maskedPan": "400001******0035",
"cardType": "VISA",
},

:
"amount": {
"total": "11,03",
"base": "10,00",
"fee": "1,03",
"currency": 643,
}
}
1.7 getCardToCardTransferTerms - Запрос проверки допустимости выбранного

перевода и расчета комиссий в случае перевода между непривязанными
картами
1.7.1 Запрос



M

перевод
targetPan Текст 19 Обязательный Номер карты, на которую

карты получателя, этого
достаточно для переводов
внутри страны


число

srcPhone Числовой 10 Опциональный Номер телефона

отправителя

перевода

:
nId MasterPass
tokenizedTargetPan Текст 19 Необязательный Зашифрованный номер

карты, на которую
Если этот параметр передан,
то ПЦ ЭК пытается
расшифровать номер и
использовать его. Если
расшфровка не удалась,
возникает ошибка.
1.7.2 Ответ


элемент.



число
для errorCode=0

для errorCode=0

выходит за


:
выходит за
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": {
"createdDate": "08/10/2016 00:13:15",
"updatedDate": "08/10/2016 00:13:15",
"bindingStatus": 0,
"expiry": "201801",
"maskedPan": "400001******0035",
"cardType": "VISA",
},
"dstBinding": {
"createdDate": "08/10/2016 00:13:15",
"updatedDate": "08/10/2016 00:13:15",
"bindingStatus": 0,
"maskedPan": "400001******0043",
"cardType": "VISA",
"is3DSecureBinding": false,
"maxAmount": "50000,00",
},
"amount": {
"total": "24,50",
"base": "22,22",
"fee": "2,28",
"currency": 643,
}
}

:
1.8 transferBindingToBinding - Операция перевода между привязанными к ЭК
платежными инструментами
Операция инициирует перевод между платежными инструментами внутри одного ЭК. Для определения
параметров перевода может указываться только идентификатор mdOrder, полученный ранее при проверке
допустимости перевода.
1.8.1 Запрос


Указывается, если
ранее происходила
проверка
допустимости
перевода
srcBindingId UUID 32 Опциональный Уникальный идентификатор

не указан mdOrder
cvc Целое положительное 4 Опциональный СVC-код карты, с которой

число осуществляется перевод
Если тип платежного
инструмента, с
которого совершается
перевод – карта, то
указание данного
параметра
обязательно (кроме
привязанных
кошельку карт и карт
МТС Банка).

amount Положительное 9,2 Опциональный Сумма перевода (без учета

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

число

nId MasterPass

:

зависимости от настроек
способа подтверждения
операции для партнёра
1.1.1 Ответ

число
errorCode=0

errorCode=0

операции

выходит за

выходит за

operation.
1.8.2 Пример (операция с карточной связки на счет ЭДС без подтверждения)

https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToBinding.do?
userId=00000000100000001353&mdOrder=223001&cvc=123
{
"errorCode": 0,
"mdOrder": "408806401",

:
"state": 2,
"refNum": "720618000009",
"date": "25/07/2017 18:20:13",
"operationType": "TRANSFER",
"direction": "INNER",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"mnemonic": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_BINDING",
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с привязанной карты на счет ЭДС",
"bonusPoints": 6
}
1.8.3 Пример (операция с карточной связки на карточную связку без подтверждения)

{
"errorCode": 0,
"mdOrder": "408806501",
"state": 2,
"refNum": "720618000010",
"date": "25/07/2017 18:23:23",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",

:
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с привязанной карты на привязанную карту",
"bonusPoints": 6
}
1.8.4 Пример (операция с ЛС МТС на счет ЭДС с подтверждением)

userId=00000000100000001353&mdOrder=223001
{
"mdOrder": "408806601",
"state": 5,
"date": "25/07/2017 18:25:29",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "Перевод с ЛС на счет ЭДС",
"otpExpiresAt": "25/07/2017 18:35:29",
"errorCode": 0
}
1.8.5 Пример (операция с карточной связки на счет ЭДС с подтверждением по 3DS)

{
"acsUrl": "http://localhost",
"mdOrder": "408806701",
"state": 5,
"date": "25/07/2017 18:44:40",

:
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "Перевод с привязанной 3DS-карты на счет ЭДС",
"errorCode": 0,
"PaReq": "…"
}
1.9 transferCardToBinding - Операция перевода с непривязанной карты на

привязанный к ЭК платежный инструмент
Операция инициирует перевод средств из внешнего источника на один из платежных инструментов ЭК. Для
определения параметров перевода может указываться только идентификатор mdOrder, полученный ранее при
проверке допустимости перевода. Так как источником средств является непривязанная карта, то операция
может потребовать различного рода подтверждения.
Если ПИ-источник – непривязанная карта, чтобы узнать, какие ПИ доступны для получения перевода,
рекомендуется вызывать метод getTransferTargets (раздел 1.1), указав на вход ПИ "ANONYMOUS_CARD". В
ответе будет выдан список доступных ПИ.
1.9.1 Запрос


проверка
перевода
pan Текст 19 Опциональный Номер карты, с которой


:
expiry Целое положительное 6 Опциональный Год и месяц действия карты,

M не указан mdOrder

перевод
Если не указан
mdOrder, то также
остается
опциональным.
cvc Целое положительное 4 Обязательный СVC-код карты, с которой

число Даже в том случае, осуществляется перевод
если указан mdOrder



число

nId MasterPass
1.1.2 Ответ
Ответ аналогичен ответу при переводах между ПИ, привязанными к ЭК.
1.9.2 Пример (требуется подтверждение по 3DS)

https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToBinding.do?
{
"mdOrder": "408806901",
"state": 5,
"date": "25/07/2017 18:54:43",

:
"srcBinding": {
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"transferType": "CARD_TO_BINDING",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "Перевод с непривязанной 3DS-карты на счет ЭДС",
"errorCode": 0,
"PaReq": "…"
}
1.9.3 Пример (подтверждения по 3DS не требуется)

https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToBinding.do?
{
"errorCode": 0,
"mdOrder": "408807001",
"state": 2,
"refNum": "720618000011",
"date": "25/07/2017 18:58:39",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с непривязанной карты на счет ЭДС",
"bonusPoints": 18
}

:
1.10 transferCardToEMoney - Операция перевода с непривязанной карты на чужой
счет ЭДС
Операция инициирует перевод средств из внешнего источника на ЭДС чужого ЭК. Для определения
допустимости перевода. Так как источником средств является непривязанная карта, то операция может
потребовать различного рода подтверждения.
1.10.1 Запрос


проверка
перевода



перевод
Если не указан
mdOrder, то остается
опциональным

Остается
обязательным даже
при указании mdOrder

число Обязательный, если пользователя в
не указан mdOrder, но международном формате
может быть заменен MSISDN. Номер
на dstBindingId мобильного телефона
перевода

ЭК.

:


число

nId MasterPass

1.1.3 Ответ

https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToEMoney.do?
{
"errorCode": 0,
"mdOrder": "408807301",
"state": 2,
"refNum": "720619000014",
"date": "25/07/2017 19:06:36",
"direction": "OUT",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919"
},
"transferType": "CARD_TO_EMONEY",
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с непривязанной карты на чужой счет ЭДС",
"bonusPoints": 18
}

:
1.11 transferBindingToEMoney - Операция перевода с привязанного к ЭК платежного
инструмента на чужой счет ЭДС
Операция инициирует перевод с платежного инструмента ЭК на счет ЭДС, принадлежащий другому ЭК. Для
определения параметров перевода может указываться только идентификатор mdOrder, полученный ранее при
проверке допустимости перевода.
1.11.1 Запрос


проверка
перевода


параметра
обязательно.

число Обязательный, если пользователя в
не указан mdOrder, но международном формате
может быть заменен MSISDN. Номер
на dstBindingId мобильного телефона
перевода

ЭК.


:
число

nId MasterPass

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",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919",
"bindingType": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_EMONEY",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "Перевод с ЛС на чужой счет ЭДС",
"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
{

:
"errorCode": 0,
"mdOrder": "408807601",
"state": 2,
"refNum": "720619000015",
"date": "25/07/2017 19:11:07",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919",
"bindingType": "EMONEY_ACCOUNT"
},
"transferType": "BINDING_TO_EMONEY",
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с ЛС на чужой счет ЭДС",
"bonusPoints": 6
}
1.12 transferBindingToCard - Операция перевода с привязанного к ЭК платежного

инструмента на непривязанную карту
Операция инициирует перевод с платежного инструмента ЭК на произвольную карту. Для определения
допустимости перевода.
1.12.1 Запрос


проверка
перевода


:

параметра
обязательно.
targetPan Текст 19 Опциональный Номер карты, на которую

Обязательный, если карты получателя, этого
не указан mdOrder достаточно для переводов


число

перевода

nId MasterPass

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",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"dstBinding": {

:
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"transferType": "BINDING_TO_CARD",
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "Перевод с ЛС на непривязанную карту",
"otpExpiresAt": "25/07/2017 20:16:50",
"errorCode": 0
}
1.1.1 Пример (требуется подтверждение по 3DS)

https://mts.rbsdev.com/ewallet/3.4/mts/transferBindingToCard.do?
{
"mdOrder": "408900201",
"state": 5,
"date": "25/07/2017 20:09:30",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"dstBinding": {
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "Перевод с привязанной 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",
"date": "25/07/2017 20:11:45",

:
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"maskedPan": "400001******0001",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с привязанной карты на непривязанную карту",
"bonusPoints": 18
}
1.13 transferCardToCard – Операция перевода между непривязанными картами
Операция инициирует перевод средств из внешнего источника на другой внешний источник. Фактически ЭК не
задействован в качестве финансовой составляющей для операции. Для определения параметров перевода может
указываться только идентификатор mdOrder, полученный ранее при проверке допустимости перевода. Так как
источником средств является непривязанная карта, то операция может потребовать различного рода
подтверждения.
1.13.1 Запрос


проверка
перевода



:

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

Остается
обязательным даже
если указан mdOrder
targetPan Текст 19 Опциональный Номер карты, на которую

Обязательный, если карты получателя, этого
не указан mdOrder достаточно для переводов


число
srcPhone Числовой 10 Опциональный Номер телефона

отправителя

перевода

nId MasterPass

tokenizedTargetPan Текст 19 Необязательный Зашифрованный номер

карты, на которую
Если этот параметр передан,
то ПЦ ЭК пытается
расшифровать номер и
использовать его. Если
расшфровка не удалась,
возникает ошибка.
1.1.6 Ответ

:
https://mts.rbsdev.com/ewallet/3.4/mts/transferCardToCard.do?userId=CUI178770451&mdOrder=1203001&cvc=123
{
"errorCode": 0,
"mdOrder": "408900701",
"state": 2,
"refNum": "720620000003",
"date": "25/07/2017 20:16:54",
"direction": "OUT",
"srcBinding": {
"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,
}
}
1.14 finish3dsTransfer - подтверждение перевода c помощью помощью 3ds

Метод принимает на вход параметры, аналогичные finish3ds. Ответ метода аналогичен ответу transfer*To* с
учетом используемых ПИ.
1.15 confirmTransferByOtp - подтверждение перевода c помощью одноразового

пароля
Метод принимает на вход параметры, аналогичные confirmTransactionByOtp. Ответ метода аналогичен ответу
transfer*To* с учетом используемых ПИ.

:
9 Пополнение ЭДС
Данный набор API используется для пополнения счета ЭДС.
Поддерживается следующий список транзакций:
 Проверка возможности внесения средств;
 Внесение средств;
 Отмена внесения средств.
При выполнении операции пополнения ЭДС подразумевается, что кошелек создается в случае его отсутствия.
Создание происходит за счет внутренних алгоритмов, на внешнюю систему не накладывается обязательств по
явному вызову процедуры создания кошелька. При создании кошелька не подразумевается использование
никаких механизмов подтверждения операции конечным пользователем.
Механизм пополнения на текущий момент подразумевает наличие только одного счета ЭДС в электронном
кошельке, поэтому идентификатором для обращения к ЭДС выступает номер телефона.
9.1 emoneyTopUpCheck – проверка возможности внесения средств

Проверка не влияет никаким образом на доступный остаток, а служит для того, чтобы проверить, что
пополнение возможно выполнить. В рамках проверки не выполняется никаких расчетов (например, комиссий),
но может создаваться электронный кошелек.
9.1.1 Запрос

положительное телефона Клиента в
число международном
Является
идентификатором
кошелька Клиента в
сервисе МТС Деньги
В текущей версии
поддерживаются
7XXXNNNNNNN


положительное 643 – рубли
число
9.1.2 Ответ


число

:
ответа. Техническая
информация для
инженеров
Присутствует, если эксплуатации
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 Запрос

Является
7XXXNNNNNNN
partnerMdOrder Текст 50 Обязательный Уникальный номер

операции в системе
партнера,
подключенной к ПЦ
ЭК
amount Положительное 9,2 Обязательный Сумма заказа. В

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

:
Зачисление
производится именно
по этой сумме.

число
description Текст 250 Опциональный Описание операции
localDate Дата/время Формат – Время совершения

ДД/ММ/ГГГ операции на стороне
Г ЧЧ:ММ:СС вызывающей системы.
9.2.2 Ответ

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

положителье 1-транзакция успешно
число выполнена;
3-транзакция отменена;
6-транзакция
отклонена;
7-транзакция в
процессе обработки.

число

Присутствует, если инженеров
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 – отмена пополнения

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

:
платежа. Отмена допустима только для операции пополнения. Отмена должна содержать ссылку на
оригинальное пополнение (partnerMdOrder).
В случае, если по каким-то причинам, вызывающей системой не был получен ответ на сообщение отмены
операции, вызывающая система может повторно отправить копию сообщения в ПЦ. Если в ПЦ
зарегистрировано такое сообщение, то ПЦ будет обрабатывать эту копию как запрос статуса, то есть вернет
состояние транзакции, которая была сформирована изначальным сообщением. Если сообщение не
зарегистрировано, то ПЦ инициирует новую транзакцию.
9.3.1 Запрос

оригинальной операции
в системе партнера,
подключенной к ПЦ ЭК
9.3.2 Ответ


отклонена;

число


9.3.3 Пример
https:// mts.rbsdev.com/ewallet/3.4/mts/emoneyTopUpReversal.do?
partnerMdOrder=223001

:
9.4 emoneyTopUpStatus – проверка статуса пополнения
Запрос статуса операции может использоваться для проверки конечного состояния по транзакции в случае
разбора проблемных ситуаций, запрос статуса должен содержать ссылку на оригинальное пополнение
(partnerMdOrder).
9.4.1 Запрос

в системе партнера,
подключенной к ПЦ ЭК
9.4.2 Ответ


отклонена;

число


9.4.3 Пример
https:// mts.rbsdev.com/ewallet/3.4/mts/emoneyTopUpStatus.do?
partnerMdOrder=223001

:
10 Интерфейс подключения ТСП
Данный набор API используется в двух случаях, в случае подключения ТСП или в случае подключения другого
источника транзакций, который использует типы транзакций «классические» для ритейла.
Поддерживается следующий список транзакций:
 Покупка
 Предавторизация
 Завершение предавторизации
 Возврат
 Отмена (для всех поддерживаемых типов операций)
 Статус (для всех поддерживаемых типов операций)
 Сверка итогов
Базовым параметром идентификации клиента при совершении транзакции является номер телефона, при этом
также допустимо указание типа задействованного платежного инструмента. По некоторым операциям
поддерживается только определенный тип инструмента. Важным моментом является то, что не
подразумевается использование getWallet(). При отсутствии кошелька или соответствующего платежного
инструмента в нем вызывающая система получает отказ. Если платежный инструмент не указан, то может
применяться платежный инструмент ЭК по умолчанию.
Клиент может подтверждать свою идентификацию посредством различных механизмов:
 Идентификация клиента по СМС с ожиданием ответа по СМС на номер телефона, используемый
также в качестве идентификатора ЭК. Использование идентификации такого рода определяется на
уровне конкретной подключаемой внешней системы. Используемый адрес для подтверждения
операции привязывается к записи о партнерской системе в ПЦ. При использовании такой схемы
реальная авторизация операции выполняется после подтверждения от клиента.
 Одноразовый пароль, который отправляется клиенту по СМС в момент совершения операции. При
этом от клиента ожидается не ответ по СМС, а ввод полученного пароля на терминальном устройстве.
Использование идентификации такого рода определяется на уровне конкретной подключаемой
внешней системы. При использовании такой схемы реальная авторизация операции выполняется после
получения пароля.
ТСП или концентратор ТСП или другая внешняя система подключается к ПЦ МТС по той же схеме, что и
другие внешние системы, используя определенный URL и клиентский сертификат.
Поддерживаемый тип аутентификации клиента настраивается на уровне подключаемой системы, но может
быть переопределен параметром confirmationType в запросе на совершение операции.
Взаимодействие состоит из циклов между сверками итогов. Сверка итогов выполняется всегда по инициативе
внешней системы. ПЦ МТС не инициирует сверку итогов самостоятельно. Если необходимость в сверке итогов
отсутствует, то подключаемая система может не посылать сверку, в этом случае будет существовать только
один цикл, в рамках которого ПЦ будет держать счетчики.
10.1 purchase - покупка
10.1.1 Запрос

Является

:
7XXXNNNNNNN
partnerMdOrder Текст 50 Опциональный Уникальный номер

операции в системе
партнера, подключенной
к ПЦ ЭК


число
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",
"userId": "CUI178770451",

:
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"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 Обязательный Сумма заказа.

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

число

:
10.2.2 Ответ

р

errorCode=0

errorCode=0

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

возврата:
CREATED - создан;
IN_PROGRESS - в процессе;
SUCCESS - успешный,
DECLINED - отказано.
ERROR - ошибка.

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",
"date": "26/07/2017 15:15:52",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",

:
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"service": {
"serviceParams": {}
}
}
10.3 reversal - отмена (для всех поддерживаемых типов операций)

Частичные отмены не поддерживаются, отмена происходит по полной сумме. Отмена завершения
предавторизации пополнения отменяет и саму предавторизацию пополнения. Это же касается и
предавторизации внесения средств. Отмена может не содержать явную ссылку на оригинальную операцию
(mdOrder), в этом случае выполняется поиск оригинала по partnerMdOrder, который должен быть указан.
Последнее используется для отмен по таймауту.
10.3.1 Запрос

Является
7XXXNNNNNNN

в ПЦ
значение было получено
из оригинальной
операции

Указывается, если ответ оригингальной
на оригинальную операции в системе
операциию не был партнера,
получен подключенной к ПЦ ЭК

:
10.3.2 Ответ
10.3.3 Пример
https://mts.rbsdev.com/mtspayment/reversal.do?
phone=79161234567&mdOrder=12345&partnerMdOrder=234567
{
"errorCode": 0,
"mdOrder": "408901301",
"state": 3,
"refNum": "720715000008",
"date": "26/07/2017 15:28:19",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"service": {
"serviceParams": {}
}
}
10.4 getStatus - статус (для всех поддерживаемых типов операций)

Запрос статуса операции может применяться в том случае, если ответ на запрос не был получен в заданный
промежуток времени или возникла непредвиденная ошибка. Статус используется, чтобы проверить
необходимость отправки отмены.
10.4.1 Запрос

Является

:
7XXXNNNNNNN

Указывается, если ответ оригинальной операции
на оригинальную в системе партнера,
операциию не был подключенной к ПЦ ЭК
получен

в ПЦ
значение было получено
из оригинальной
операции
10.4.2 Ответ
10.4.3 Пример
https://mts.rbsdev.com/mtspayment/getStatus.do?
phone=79161234567&partnerMdOrder=234567
{
"errorCode": 0,
"mdOrder": "408901401",
"state": 2,
"refNum": "720715000009",
"date": "26/07/2017 15:36:47",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"service": {
"serviceParams": {}
}
}

:
10.5 confirmOTP – передача одноразового пароля, введенного клиентом
Передача одноразового пароля выполняется в случае использования схемы передачи одноразового пароля для
ввода на терминале по СМС клиенту. В случае использования такой схемы авторизация операции выполняется
при получении именно этого сообщения. Сообщение с данными операции трактуется как подготовительное.
10.5.1 Запрос

Является
7XXXNNNNNNN

в ПЦ
Значение получается из
password Текст 50 Обязательный Код подтверждения

идентификации клиента
10.5.2 Ответ
10.5.3 Пример
https://mts.rbsdev.com/mtspayment/confirmOtp.do?
phone=79161234567&mdOrder=1234567890&password=123456
{
"errorCode": 0,
"mdOrder": "408900901",
"state": 2,
"refNum": "720713000004",
"date": "26/07/2017 13:47:40",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,

:
},
"service": {
"serviceParams": {}
}
}

:
11 Получение истории операций
11.1 getOperationsHistory – запрос истории операций
11.1.1 Запрос

bindindId UUID 32 Необязательный Уникальный

платежного
инструмента, операции
по которому требуется
показать
dateFrom Дата/время Формат – Необязательный Дата начала периода, за

ДД/ММ/ГГГ который требуется
Г ЧЧ: найти операции
ММ:СС Может быть
использован при поиске
операций
dateTo Дата/время Формат – Необязательный Дата начала периода, за

ДД/ММ/ГГГ который требуется
Г ЧЧ: найти операции
ММ:СС Может быть
использован при поиске
операций
services[] JSON-массив 500 Необязательный Перечень сервисов

(поставщиков),
транзакции в пользу
Может быть которых необходимо
использован, если получить
требуется получение
подмножества операций
только по выбранным Разделитель – запятая,
сервисам например:
services=[“test”,”test_p”]
direction JSON-массив из 100 Необязательный Пример:

значений direction=["IN","OUT"]
“IN”/”OUT”
Может быть
использован, если
трубуется полуние
операций,
входящих/исходящих
относительно кошелька.
По умолчанию
отображаются все.
sortColumn Текст 100 Необязательный Колонка, которая

выбрана для
сортировки
Может быть
использован, если По умолчанию

:
пользователем сортировка
применена сортировка производится по дате
значений в столбце создания заказа.
Допустимые значения:
DATE, SERVICE_ID,
AMOUNT
sortDirection Текст 4 Необязательный Направление

сортировки: ACS/DESC
Может быть По умолчанию
использован, если сортировка
пользователем производится в порядке
применена сортировка возрастания
значений в столбце
page Целое 0-999 Обязательный Номер страницы

положительное Для отображения
число первой страницы
необходимо задать page
=0
pageSize Целое 1-999 Обязательный Количество элементов

положительное на странице
число
requiredState Текст 100 Необязательный Операции с какими

статусами должны
быть возвращены.
Может быть
использован, если Допустимые значения:
трубуется фильтрация SUCCESSFUL,
успешных/неуспешных UNSUCCESSFUL, ALL
операций. По
умолчанию
отображаются все.
1.1.1 Ответ

число


operations[] Массив - Обязательный Список операций,

объектов типа отвечающих критерию
operation. поиска.

:
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",
"date": "25/07/2017 19:03:44",
"direction": "IN",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919",
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"bonusPoints": 18
},
{--платеж
"mdOrder": "408604101",
"state": 2,
"refNum": "720614000000",
"date": "25/07/2017 14:58:47",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"bonusPoints": 10,
"service": {
"category": "test",

:
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
}
},
{--перевод на чужой ПИ
"mdOrder": "408807101",
"state": 2,
"refNum": "720619000012",
"date": "25/07/2017 19:03:44",
"direction": "OUT",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"bonusPoints": 18
},
{--перевод между своими ПИ
"mdOrder": "408806401",
"state": 2,
"refNum": "720618000009",
"date": "25/07/2017 18:20:13",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"bindingId": "4002613001454185829422FFF7B91D65",
"maskedPan": "400001******0019",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",

:
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод с привязанной карты на счет ЭДС",
"bonusPoints": 6
},
{--пополнение счета ЭДС (TOP UP)
"mdOrder": "0C355ED6F9994C3D88B41BEF4006C51E",
"state": 1,
"refNum": "720915000002",
"date": "28/07/2017 15:35:53",
"operationType": "TOP_UP",
"dstBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
}
}],
"errorCode": 0
}
11.2 getOperationDetails – деталей по операции
11.2.1 Запрос


1.1.2 Ответ

число


:


operation* Набор полей из - Обязательный Данные об операции

комплексного
типа operation.
11.2.2 Пример (платеж)

https://mts.rbsdev.com/ewallet/3.4/mts/getOperationDetails.do?
{
"mdOrder": "408604101",
"state": 2,
"refNum": "720614000000",
"date": "25/07/2017 14:58:47",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "400001******0043",
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"bonusPoints": 10,
"service": {
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
},
"errorCode": 0
}
11.2.3 Пример (перевод на чужой ПИ)


:
{
"mdOrder": "408807101",
"state": 2,
"refNum": "720619000012",
"date": "25/07/2017 19:03:44",
"direction": "OUT",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919"
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
"bonusPoints": 18,
"errorCode": 0
}
11.2.4 Пример (перевод с чужого ПИ)

{
"mdOrder": "408807101",
"state": 2,
"refNum": "720619000012",
"date": "25/07/2017 19:03:44",
"direction": "IN",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"dstBinding": {
"phoneNumber": "79160000002",
"userId": "CUI842613919",
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},

:
"bonusPoints": 18,
"errorCode": 0
}

:
12 Группа сервисов «Электронная коммерция»
12.1 getECommercePurchaseTerms – запрос расчета комиссии и лимитов на e-

commerce покупку
12.1.1 Запрос


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

число YYYYMM Может быть указан в
случае оплаты

карты
картой

число
Может быть указан в случае
картой


число
serviceId Текст 10 Обязательный Уникальный

услуги

:
purchaseParams[] Набор параметров - Опциональный Параметры

покупки.
Если указаны, то
будут проверены

операции
12.1.2 Ответ
Ответ аналогичен ответу для getPaymentTerms
service{} Набор - Обязательный Параметры сервиса, по

параметров которому производится
расчет деталей платежа.
См. описание в разделе
группа сервисов
«платежи»
bindings[] Набор - Обязательный Параметры продукта

параметров См. описание в разделе
группа сервисов
«платежи»

число
для errorCode=0

для errorCode=0

операции
12.1.3 Пример
Неуспешный ответ (ошибка валидации входных данных)
https://mts.rbsdev.com/ewallet/3.4/mts/getECommercePurchaseTerms.do?
userId=CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&serviceId=kniga_
ru&purchaseParams={"merchantOrderNumber": "12345", "description": "Заказ №12345
игрушки", "verificationValue": "b041e7…a48b1"}&amount=100&currency=643

:
{
"errorCode": 56,
"errorCause": "AMOUNT_GREATER_THAN_MAX_ALLOWED_AMOUNT_FOR_SERVICE"
}
Успешный ответ по всем ПИ

https://mts.rbsdev.com/ewallet/3.4/mts/getECommercePurchaseTerms.do?
игрушки", "verificationValue": "b041e7…a48b1"}&amount=100&currency=643
{
"errorCode": 0,
"bindings": [
{
"account": "9161234570",
"mdOrder": "3010006",
"actionCode": "0",
"amount": {
"total": "101,92",
"base": "100,00",
"fee": "1,92",
"currency": 643,
}
},
{
"maskedPan": "404266******0000",
"expiry": "201801",
"cardType": "VISA",
"mdOrder": "3010007",
"actionCode": "0",
"amount": {
"total": "101,92",
"base": "100,00",
"fee": "1,92",
"currency": 643,
}
},
…
],
"service": {
"id": "kniga_ru",
"subline": "ООО Книга.ру",
"icon": "a",
"amount": {},
"params": [],
"regions": [],
"payeeHidden": false,
"providerName": "Книга.ру",
"allowedSrcTypes": [
"MTS_ACCOUNT",
"ANONYMOUS_CARD",
"BOUND_CARD",
"EMONEY_ACCOUNT",
"EXTERNALLY_TOKENIZED_CARD"
]

:
}
}
12.2 eCommercePurchase – Произвести e-commerce покупку

Данный запрос выполняется Витриной без запроса getECommercePurchaseTerms.
12.2.1 Запрос


платеж выполняется с
по ПИ, привязанного к
кошельку
картой
expiry Целое 6 Опциональный Год и месяц действия

положительное Формат – карты
число YYYYMM Обязательный в случае
картой
cardholderName Текст 100 Опциональный Имя держателя карты
картой

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

purchaseParams[ Набор параметров - Обязательный Параметры покупки.

]

операции


:

число
12.2.2 Ответ
Ответ аналогичен ответу для payment.
12.2.3 Пример (карта вовлечена в 3ds)

Карта вовлечена в 3DS
https://mts.rbsdev.com/ewallet/3.4/mts/eCommercePurchase.do?
userId=CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&cvc=123&serviceI
d=kniga_ru&purchaseParams={"merchantOrderNumber": "12345", "description":
"Заказ №12345 игрушки", "verificationValue": "b041e…
6a48b1"}&amount=100&currency=643
{
"mdOrder": "223001",
"acsUrl": "http://acs.bank.ru/pareq",
"state": 5,
"errorCode": 0,
"PaReq": "…"
}
{
"mdOrder": "410900101",
"state": 5,
"date": "26/07/2017 20:49:36",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
"maskedPan": "404266******0000",
"cardType": "VISA"
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "моя покупка",
"service": {
"category": "eCommercePurchase",
"categoryName": "e-comm purchase",
"serviceId": "kniga_ru",
"serviceName": "Книга.ру",
"serviceParams": {
"merchantOrderNumber": "12345",
"verificationValue":
"b041e7daf58474fdb6c60c1713e94084ca0c160c023b9ca53b7e5a34db426cceaae7b527f950dc9d880e09
d398be45a7b4e9952bda72c660f63f499cc26a48b1"
}

:
},
"errorCode": 0,
"PaReq": "…"
}
12.2.4 Пример (Л/С требуется подтверждение вводом пароля на платежной странице)

Требуется подтверждение вводом пароля на платежной странице
https://mts.rbsdev.com/ewallet/3.4/mts/ eCommercePurchase.do?
игрушки", "verificationValue": "b041e…a48b1"}&amount=100&currency=643
{
"mdOrder": "408901501",
"state": 5,
"date": "26/07/2017 16:27:16",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"amount": {
"total": "100,00",
"base": "100,00",
"currency": 643,
},
"comment": "моя покупка",
"otpExpiresAt": "26/07/2017 16:37:16",
"service": {
"category": "eCommercePurchase",
"categoryName": "e-comm purchase",
"serviceId": "kniga_ru",
"serviceName": "Книга.ру",
"serviceParams": {
"merchantOrderNumber": "12345",
"verificationValue":
"b041e7daf58474fdb6c60c1713e94084ca0c160c023b9ca53b7e5a34db426cceaae7b527f950dc9d880e09
d398be45a7b4e9952bda72c660f63f499cc26a48b1"
}
},
"errorCode": 0
}
12.3 eCommercePurchaseByMdOrder – Произвести e-commerce покупку

Данный запрос выполняется Витриной после запроса getECommercePurchaseTerms.
12.3.1 Запрос
Парамет Тип данных Размер Обязательность Описание
р

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

номер операции в

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

число YYYYMM Обязательный в случае оплаты
непривязанной картой если expiry не
getECommercePurchaseTerms

число
Обязательный в случае оплаты
непривязанной картой если cvc не
getECommercePurchaseTerms
12.3.2 Ответ
Ответ аналогичен ответу для eCommercePurchase.

:
13 Группа сервисов «Токенизация»
13.1 /mdes/getCardDataForTokenization – Расчет TAV
13.1.1 Запрос


13.1.2 Ответ
tav Строковый 1024 Опциональный Расситанное значение

TAV
errorCode=0
pan Числовой 13..16 Опциональный Номер карты
errorCode=0
expiry Дата (ГГГГММ) 6 Опциональный Дата окончания срока

действия карты
errorCode=0

число
для errorCode=0

для errorCode=0

операции

:
13.1.3 Пример
Успешный ответ
https://mts.rbsdev.com/ewallet/3.4/mts/ mdes/getCardDataForTokenization.do?
userId=CUI178770451&bindingId=B31238AA38CE4D20AF92690991E29771
{
"tav":
"eyJ2ZXJzaW9uIjoiMiIsImV4cGlyYXRpb25EYXRlSW5jbHVkZWQiOiJ0cnVlIiwidG9rZW5VbmlxdWVSZWZlcm
VuY2VJbmNsdWRlZCI6ImZhbHNlIiwic2lnbmF0dXJlQWxnb3JpdGhtIjoiUlNBLVNIQTI1NiIsInNpZ25hdHVyZ
SI6IjNvclNiTmVRU3NGNG54UE1RK2xmb2RhOGEwcndGUHlmelBzbTNqOHQ3RjFVTmJPNWZzRkU2cFBnVlRYQ1FD
M3FDTlFNdFl0emdJRDFtMGJKWGpUSkhpQ2hqREd5by8zcUZLVzRJdWhSUWxUNXFZTlpUK0dkQ05BQ0xDMnl6WFR
zTDUwSXc1dmNNUlovWXhuSkNJOVFGOSt0TlplQWF1cHFEWkduSGJkRDlueDNvakxvMXgvUldsbG5xTEZpWjhsU2
5QZWFxK0hUbE43SnJVNUk2dkJZN0JHbUhiZnNnNmkvOGpFcXlsWlEvOWJNNHljM2VVWGNOV3IzeXMvTVpORzNiQ
k9raEptemY4eVhyRDRKYmIxQ1FaaXpXZU5CaUJuTE9idTlFWXA2dUVvRzNOU25oSXg0QklEMkF0TGNFWG5yajNG
QzhyTE4zcXR5eG5HM3AvWVpydz09In0=",
"errorCode": 0
}

:
14 Группа сервисов «Переводы не клиентам»
14.1 /transfer/ondemand/getTermsFromBinding – Запрос проверки допустимости и

расчета комиссии для перевода не клиенту с ПИ, привязанного к кошельку
14.1.1 Запрос


amount Положительное 9,2 Обязательный Сумма перевода

число, два знака (без учета
после запятой комиссии).
currency Целое 3 Обязательный Валюта перевода

число
targetPhoneNumber Целое 11 Обязательный Номер мобильного

число получателя
неклиента в

операции
14.1.2 Ответ

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

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

положительное телефона получателя
число неклиента в
международном формате
MSISDN
amount Набор - Опциональный Денежные параметры

параметров. Обязательный, если операции. Данный метод
Комплексный errorCode = 0. возвращает только один
тип amount. элемент.

:
для errorCode=0

для errorCode=0

операции

выходит за

выходит за
14.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/getTermsFromBinding.do
?
userId=CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&amount=22,22&cur
rency=643&targetPhoneNumber=79161000010&comment=Перевод
{
"errorCode": 0,
"mdOrder": "406600101",
"srcBinding": {
"createdDate": "24/06/2016 15:39:10",
"updatedDate": "21/10/2016 13:00:26",
"bindingStatus": 0,
"currency": "643",
"phoneNumber": "9161234570",

:
},
"amount": {
"total": "57,22",
"base": "22,22",
"fee": "35,00",
"currency": 643,
},
"targetPhoneNumber": "79161000010"
}
14.2 /transfer/ondemand/getTermsFromCard – Запрос проверки допустимости и расчета

комиссии для перевода не клиенту с непривязанной карты
14.2.1 Запрос

pan Числовой 13-19 Обязательный Номер

непривязанной
карты
expiry Числовой 6 Опциональный Год и месяц

Формат – действия карты, с
YYYYMM которой
осуществляется
перевод

карты, с которой
перевод


число


операции
14.2.2 Ответ
Аналогично ответу при переводе с привязанного ПИ.

:
14.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/getTermsFromCard.do?
userId=CUI178770451&amount=100&currency=643&targetPhoneNumber=79161000010&comme
nt=Перевод&pan=4000010000000027&expiry=202512
{
"errorCode": 0,
"mdOrder": "406600201",
"srcBinding": {
"createdDate": "24/07/2017 12:18:58",
"updatedDate": "24/07/2017 12:18:58",
"bindingStatus": 0,
"expiry": "202512",
"maskedPan": "400001******0027",
"cardType": "VISA",
},
"amount": {
"total": "135,00",
"base": "100,00",
"fee": "35,00",
"currency": 643,
},
}
14.3 /transfer/ondemand/executeByMdOrder – Запрос проведения перевода не клиенту

с использованием полученного ранее mdOrder
14.3.1 Запрос

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

номер операции в
ПЦ ЭК
expiry Числовой 6 Опциональный Год и месяц

Формат – Обзятельный, если в случае действия карты, с
YYYYMM перевода с непривязанной которой
карты значение не осуществляется
указывалось в запросе перевод
*/getTermsFromCard
cvc Целое 4 Опциональный СVC-код карты, с

положительное которой
число осуществляется
Обязательный в случае перевод
перевода с непривязанной
карты

:
операции
14.3.2 Ответ
Ответ аналогичен ответу для API переводов. В ответе присутствует блок transferOnDemandData, в котором
указывается номер телефона – получателя.
14.3.3 Пример (с ЛС, требуется подтверждение по OTP)

https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/executeByMdOrder.do?
{
"mdOrder": "410900301",
"state": 5,
"date": "26/07/2017 20:58:12",
"operationType": "TRANSFER_ON_DEMAND",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"transferOnDemandData": {
"uuid": "AACE9B57C4094274820F211E48D8DAE4",
"date": "26/07/2017 20:58:13",
"expiresAt": "29/07/2017 20:58:13",
"status": "CREATED",
},
"amount": {
"total": "22,21",
"base": "22,21",
"currency": 643,
},
"comment": "Перевод неклиенту",
"otpExpiresAt": "26/07/2017 21:08:12",
"errorCode": 0
}
14.3.4 Пример (с ЛС, подтверждение не требуется)

https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/executeByMdOrder.do?
{
"errorCode": 0,
"mdOrder": "410900401",
"state": 2,
"refNum": "720721000001",
"date": "26/07/2017 21:02:49",
"direction": "OUT",
"srcBinding": {

:
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"uuid": "A2C72F39577249239CFEF838BF9DDF22",
"date": "26/07/2017 21:02:49",
"expiresAt": "29/07/2017 21:02:49",
"status": "WAITING_CONFIRMATION",
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод неклиенту"
}
14.4 /transfer/ondemand/executeFromBinding – Запрос проведения перевода не клиенту

с ПИ, привязанного к кошельку
14.4.1 Запрос


инструмента,
источника
перевода
cvc Целое 4 Опциональный СVC-код карты, с

перевод


число


:

операции
14.4.2 Ответ
Аналогичен ответу при проведении перевода с использованным ранее mdOrder.
14.4.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/executeFromBinding.do?
userId=CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&amount=22,22&cur
rency=643&targetPhoneNumber=79161000010&comment=Перевод
{
"errorCode": 0,
"mdOrder": "410900501",
"state": 2,
"refNum": "720721000002",
"date": "26/07/2017 21:04:20",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"uuid": "0FD525DF5D8841C6B7C86AF1034D1569",
"date": "26/07/2017 21:04:20",
"expiresAt": "29/07/2017 21:04:20",
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Комментарий к переводу"
}
14.5 /transfer/ondemand/executeFromCard – Запрос проведения перевода не клиенту с

непривязанной карты
14.5.1 Запрос


:
карты
expiry Числовой 6 Обязательный Год и месяц

Формат – действия карты, с
YYYYMM которой
перевод
cvc Целое 4 Обязательный СVC-код карты, с

перевод

карты, с которой
перевод


число


операции
14.5.2 Ответ
Аналогичен ответу при проведении перевода с использованным ранее mdOrder.
14.5.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/executeFromCard.do?
userId=CUI178770451&amount=100&currency=643&targetPhoneNumber=79161000010&comme
nt=Комментарий к переводу&pan=4000010000000027&expiry=202512&cvc=123
{
"errorCode": 0,
"mdOrder": "410900601",
"state": 2,
"refNum": "720721000003",
"date": "26/07/2017 21:10:46",
"direction": "OUT",
"srcBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"

:
},
"uuid": "8069F33359FD47EBA7E60501B4B90263",
"date": "26/07/2017 21:10:46",
"expiresAt": "29/07/2017 21:10:46",
},
"amount": {
"total": "100,00",
"base": "100,00",
"fee": "0,00",
"currency": 643,
},
}
14.6 /transfer/ondemand/getIncoming – Запрос списка входящих переводов не

клиентам
14.6.1 Запрос

14.6.2 Ответ
transfers[] Массив элементов с - Опциональный Список входящих

типом Обязательный, если переводов
transferOnDemandDat errorCode = 0.
a


ответа
errorCode=0

errorCode=0

операции

:
14.6.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/getIncoming.do?
userId=CUI204999154
{
"errorCode": 0,
"transfers": [
{
"uuid": "6F7A9A0A8072476A9829F6E234C57B54",
"date": "24/07/2017 12:44:36",
"expiresAt": "27/07/2017 12:44:36",
"amount": "22,22",
"currency": "643",
"comment": "Комментарий к переводу",
"sourcePhoneNumber": "79161234570"
},
{
"uuid": "63D2DC98C7C84B1792E31F9DD0284DC8",
"date": "24/07/2017 13:59:00",
"expiresAt": "27/07/2017 13:59:00",
"amount": "22,22",
"currency": "643",
},
{
"uuid": "E5977FB2B33C49E2835103FBAB8C5239",
"date": "24/07/2017 14:01:59",
"expiresAt": "27/07/2017 14:01:59",
"amount": "100,00",
"currency": "643",
}
]
}
14.7 /transfer/ondemand/acceptToBinding – Получение входящего перевода на ПИ,

привязанный к кошельку
14.7.1 Запрос


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

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

:
14.7.2 Ответ
Ответ аналогичен ответу для API переводов. В ответе присутствует блок transferOnDemandData, в котором
указывается номер телефона – отправителя.
14.7.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/acceptToBinding.do?
userId=CUI204999154&bindingId=71A3254516244986A30AA0C8E2871475&uuid=6F7A9A0A807
2476A9829F6E234C57B54
{
"errorCode": 0,
"mdOrder": "410900701",
"state": 2,
"refNum": "720721000008",
"date": "26/07/2017 21:18:09",
"direction": "IN",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451"
},
"dstBinding": {
"phoneNumber": "79161000012",
"userId": "CUI809000699",
"bindingId": "819E9A498B584CB98A1335A9AEA0E3AB",
"mnemonic": "emoney"
},
"uuid": "0FD525DF5D8841C6B7C86AF1034D1569",
"date": "26/07/2017 21:04:20",
"expiresAt": "29/07/2017 21:04:20",
"status": "FINISHED",
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"bonusPoints": 6
}
14.8 /transfer/ondemand/acceptToCard – Получение входящего перевода на

непривязанную карту
14.8.1 Запрос


:

карты

перевода
неклиенту
14.8.2 Ответ
Аналогичен ответу при получении на ПИ, привязанный к кошельку.
14.8.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/acceptToCard.do?
userId=CUI204999154&pan=4000010000000027&uuid=63D2DC98C7C84B1792E31F9DD0284DC8
{
"errorCode": 0,
"mdOrder": "410901901",
"state": 2,
"refNum": "720721000021",
"date": "26/07/2017 21:30:35",
"direction": "IN",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451"
},
"dstBinding": {
"maskedPan": "400001******0027",
"cardType": "VISA"
},
"uuid": "A2C72F39577249239CFEF838BF9DDF22",
"date": "26/07/2017 21:02:49",
"expiresAt": "29/07/2017 21:02:49",
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"comment": "Перевод неклиенту",
"bonusPoints": 6
}
14.9 /transfer/ondemand/acceptAsPayment – Получение входящего перевода как платеж

Данный запрос должен применяться для получения перевода на ЛС МТС.

:
14.9.1 Запрос


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

serviceParams[] Набор параметров - Обязательный Атрибуты

конкретного
14.9.2 Ответ
Аналогичен ответу при получении на ПИ, привязанный к кошельку. В ответе дополнительно присутствуют
данные об оплаченном сервисе.
14.9.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/acceptAsPayment.do?
userId=CUI204999154&uuid=E5977FB2B33C49E2835103FBAB8C5239&serviceId=MTS&service
Params={"NUMBER":"79161000010"}
{
"errorCode": 0,
"mdOrder": "410902001",
"state": 2,
"refNum": "720721000022",
"date": "26/07/2017 21:33:24",
"direction": "IN",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451"
},
"uuid": "6B7489C89BC04C1784FF353F5576B3EA",
"date": "26/07/2017 21:29:53",
"expiresAt": "29/07/2017 21:29:53",
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
"bonusPoints": 6,
"service": {

:
"category": "test",
"serviceParams": {
"p1": "12345",
"p2": "a",
"NUMBER": "79161000009",
"p3": "1234"
},
"supportPhone": "8-800-1234567"
}
}
}
14.10 /transfer/ondemand/declineAccept – Отказ от входящего перевода получателем
14.10.1 Запрос


перевода
неклиенту
14.10.2 Ответ
Аналогичен ответу при получении на ПИ, привязанный к кошельку.
14.10.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/declineAccept.do?
userId=CUI252812188&uuid=7F7117AEC7BA43CC9DA0FE7F17DFE380
{
"errorCode": 0,
"mdOrder": "410901401",
"state": 3,
"refNum": "720721000014",
"date": "26/07/2017 21:29:56",
"direction": "IN",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451"
},
"uuid": "260283F82DF14C228DAABEF9FE68489F",
"date": "26/07/2017 21:29:56",
"expiresAt": "29/07/2017 21:29:56",
"status": "CANCELLED_BY_RECIPIENT",
},
"amount": {

:
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,
},
}
14.11 /transfer/ondemand/cancel – Отмена перевода неклиенту отправителем
14.11.1 Запрос


перевода
неклиенту
14.11.2 Ответ
Аналогичен ответу вслучае отказа получателем.
14.11.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/transfer/ondemand/cancel.do?
userId=CUI178770451&uuid=E6C54AF0FDE048CEAFA5B685BCAD8A2F
{
"errorCode": 0,
"mdOrder": "410901101",
"state": 3,
"refNum": "720721000011",
"date": "26/07/2017 21:29:54",
"direction": "OUT",
"srcBinding": {
"phoneNumber": "79161234570",
"userId": "CUI178770451",
},
"uuid": "4042E5CF60F2492A91E42C1E2857A380",
"date": "26/07/2017 21:29:54",
"expiresAt": "29/07/2017 21:29:54",
"status": "CANCELLED_BY_SENDER",
},
"amount": {
"total": "22,22",
"base": "22,22",
"fee": "0,00",
"currency": 643,

:
},
}

:
15 Группа сервисов «Управление виртуальными картами»
15.1 /virtualcard/create.do – создать виртуальную карту и привязать ее к платежному

инструменту
15.1.1 Запрос
userId Строковый Обязательный Уникальный

пользователя.
bindingId Строковый Обязательный Уникальный

родительского
платежного инструмента,
к которому
привязывается
создаваемая ВК
15.1.2 Ответ

число
createdBindingId Строковый Только для запросов, Уникальный

завершившихся идентификатор созданного
успешно. платежного инструмента.
Необязательный для
errorCode=0
15.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/virtualcard/create.do?
userId=0000000010&bindingId=629911298603407B9E56B67B452799D9
{
"createdBindingId":"0B17062F1C7D4617B1B1102554AB0F68","errorCode":0
}
15.2 /virtualcard/reCreateOnCompromised.do – перевыпустить виртуальную карту в

случае компрометации
15.2.1 Запрос


:
bindingId Строковый Обязательный Уникальный

платежного инструмента
ВК, которую следует
перевыпустить
15.2.2 Ответ

число
createdBindingId Строковый Только для запросов, Уникальный

завершившихся идентификатор созданного
успешно. платежного инструмента.
errorCode=0
15.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/virtualcard/reCreateOnCompromised.do?
userId=0000000010&bindingId=629911298603407B9E56B67B452799D9
{
"createdBindingId":"0B17062F1C7D4617B1B1102554AB0F68","errorCode":0
}
15.3 /virtualcard/list.do – получить список виртуальных карт
15.3.1 Запрос

parentBindingId Строковый Опциональный Уникальный

платежного инструмента,
к которому привязаны
карты.
15.3.2 Ответ


:
bindings[] Набор - Обязательный Параметры платежных

параметров. инструментов типа
Комплексный тип VIRTUAL_CARD.
binding. Заполняется, если
errorCode==0
errorCode=0
15.3.3 Расширение типа binding для виртуальных карт

Если вызов метода /virtualcard/list.do был успешным errorCode == 0, в агрегате bindings[] возвращается набор
комплексных типов binding, соответствующих описанию 2.2.2.
Для виртуальных карт ПИ = VIRTUAL_CARD тип binding содержит расширенные данные. У возвращаемых в
массиве объектов поле bindingType будет иметь новое значение 'VIRTUAL_CARD', будет присутствовать новое
поле pan, содержащее полный номер карты, и будет добавлено новое поле parentBindingId, содержащее
bindingId ПИ, к которому привязана виртуальная карта.
bindings[]
bindingType Строковый Обязательный VIRTUAL_CARD

для виртуальных
карт
pan Строковый 19 Обязательный Полный номер

карты
bankStatus Строковый Обязательный Статус карты в

системах банка
parentBindingId Строковый Обязательный binding ПИ, к

которому привязана
виртуальная карта
panHashSha1 Строковый Опциональный Хэш SHA-1 номера

виртуальной карты
15.3.4 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/virtualcard/create.do?userId=0000000010
{"bindings":[{"bindingId":"82B1BD604CDA42EF9FD1A42AC3EF575E","mnemonic":"VIRTUAL
CARD","createdDate":"26/02/2018 12:01:00","updatedDate":"26/02/2018
12:01:00","isDefaultBinding":false,"bindingType":"VIRTUAL_CARD","bindingStatus":0,"curr
ency":"643","cardStatus":0,"pan":"4000010000000035","bankStatus":"UNKNOWN","parentBindi
ngId":"82B1BD604CDA42EF9FD1A42AC3EF574C","panHashSha1":"232b103b6d724f0184389fcc2ae02c3

:
8bb930184","isMobile":false}],"errorCode":0}

:
16 Группа сервисов «Платежи с использованием
ApplePay/GooglePay/SamsungPay»
Сервисы данной группы отличаются от всех остальных сервисов тем, что в них запрос передается в виде JSON
и Content-Type = application/json
16.1 /tokenpayments/paymentWithApplePay.do – выполнить платеж с использованием

ApplePay
16.1.1 Запрос (описаны поля JSON)



serviceParams Текст - Обязательный Атрибуты конкретного

(экранированный поставщика, значение
JSON) поля передается в виде
экранированной строки
JSON

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

число

операции
applePayTokenDat Текст Обязательный Экранированный JSON-

a (экранированный объект pk_token,
JSON) полученный от ApplePay
16.1.2 Ответ
16.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/tokenpayments/paymentWithApplePay.do
Тело запроса:
{
"userId": "CUI178770451",
"amount": "100",
"currency": "643",
"serviceParams": "{\"NUMBER\":\"9160000001\"}",//обратите внимание на
экранирование

:
"comment": "Комментарий для платежа ApplePay",
"applePayTokenData": //обратите внимание на экранирование
"{\"version\":\"EC_v1\",\"data\":\"StsFdAq1eFIIY5YiOZ6zKh0fCexRoPN1IJuBEy3r8OWE
ROLlTIgoV7tIULqtl4SY1s8rucF5FY2qkJmc21z\/8Ph3VvKnftsFMHk4CYTkbycFnuhOEgE4OOmavQ
KZZfINY2u9nmYyakD090CXb4KwDnDZuWh9etMMCQ+qvEbv2gp6ClWdbHqR4Y6HZi6t1CP2jeG9OdWEc
bQc5IQVJ+CAaUJFOCq+OlrIooCSsfLbf1MWKSRjpHG1cXJTepye6FwxFVR+FQWFW+IN3o5IXHTwK367
mrC7DiVAM4Kb2ocYNrmtU9oXWcOVpe+YQ2zKHqi4Dbaa7tfFHL7iGt4Yh2GroHYJ+PNrRnBgyMR2Y2b
fIcku+\/KwzegmSviX30NjeHMqnX3LsHcYHr2k43kMoxgLD\/ZHsIGdgUu2PYQUy5nuxS8=\",\"sig
nature\":\"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEA
AKCAMIID4jCCA4igAwIBAgIIJEPyqAad9XcwCgYIKoZIzj0EAwIwejEuMCwGA1UEAwwlQXBwbGUgQXB
wbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbi
BBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE0MDkyNTIyMDYxM
VoXDTE5MDkyNDIyMDYxMVowXzElMCMGA1UEAwwcZWNjLXNtcC1icm9rZXItc2lnbl9VQzQtUFJPRDEU
MBIGA1UECwwLaU9TIFN5c3RlbXMxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwY
HKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhV37evWx7Ihj2jdcJChIY3HsL1vLCg9hGCV2Ur0pUEbg0IO2B
HzQH6DMx8cVMP36zIg1rrV1O\/0komJPnwPE6OCAhEwggINMEUGCCsGAQUFBwEBBDkwNzA1BggrBgEF
BQcwAYYpaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZWFpY2EzMDEwHQYDVR0OBBYEFJR
X22\/VdIGGiYl2L35XhQfnm1gkMAwGA1UdEwEB\/wQCMAAwHwYDVR0jBBgwFoAUI\/JJxE+T5O8n5sT
2KGw\/orv9LkswggEdBgNVHSAEggEUMIIBEDCCAQwGCSqGSIb3Y2QFATCB\/jCBwwYIKwYBBQUHAgIw
gbYMgbNSZWxpYW5jZSBvbiB0aGlzIGNlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBhc3N1bWVzIGFjY2V
wdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFyZCB0ZXJtcyBhbmQgY29uZGl0aW9ucy
BvZiB1c2UsIGNlcnRpZmljYXRlIHBvbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjdGljZSBzdGF0Z
W1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2VydGlmaWNhdGVhdXRob3Jp
dHkvMDQGA1UdHwQtMCswKaAnoCWGI2h0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlYWljYTMuY3JsMA4
GA1UdDwEB\/wQEAwIHgDAPBgkqhkiG92NkBh0EAgUAMAoGCCqGSM49BAMCA0gAMEUCIHKKnw+Soyq5m
XQr1V62c0BXKpaHodYu9TWXEPUWPpbpAiEAkTecfW6+W5l0r0ADfzTCPq2YtbS39w01XIayqBNy8bEw
ggLuMIICdaADAgECAghJbS+\/OpjalzAKBggqhkjOPQQDAjBnMRswGQYDVQQDDBJBcHBsZSBSb290IE
NBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBc
HBsZSBJbmMuMQswCQYDVQQGEwJVUzAeFw0xNDA1MDYyMzQ2MzBaFw0yOTA1MDYyMzQ2MzBaMHoxLjAs
BgNVBAMMJUFwcGxlIEFwcGxpY2F0aW9uIEludGVncmF0aW9uIENBIC0gRzMxJjAkBgNVBAsMHUFwcGx
lIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUz
BZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABPAXEYQZ12SF1RpeJYEHduiAou\/ee65N4I38S5PhM1bV
Zls1riLQl3YNIk57ugj9dhfOiMt2u2ZwvsjoKYT\/VEWjgfcwgfQwRgYIKwYBBQUHAQEEOjA4MDYGCC
sGAQUFBzABhipodHRwOi8vb2NzcC5hcHBsZS5jb20vb2NzcDA0LWFwcGxlcm9vdGNhZzMwHQYDVR0OB
BYEFCPyScRPk+TvJ+bE9ihsP6K7\/S5LMA8GA1UdEwEB\/wQFMAMBAf8wHwYDVR0jBBgwFoAUu7DeoV
gziJqkipnevr3rr9rLJKswNwYDVR0fBDAwLjAsoCqgKIYmaHR0cDovL2NybC5hcHBsZS5jb20vYXBwb
GVyb290Y2FnMy5jcmwwDgYDVR0PAQH\/BAQDAgEGMBAGCiqGSIb3Y2QGAg4EAgUAMAoGCCqGSM49BAM
CA2cAMGQCMDrPcoNRFpmxhvs1w1bKYr\/0F+3ZD3VNoo6+8ZyBXkK3ifiY95tZn5jVQQ2PnenC\/gIw
Mi3VRCGwowV3bF3zODuQZ\/0XfCwhbZZPxnJpghJvVPh6fRuZy5sJiSFhBpkPCZIdAAAxggGLMIIBhw
IBATCBhjB6MS4wLAYDVQQDDCVBcHBsZSBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJ
AYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjEL
MAkGA1UEBhMCVVMCCCRD8qgGnfV3MA0GCWCGSAFlAwQCAQUAoIGVMBgGCSqGSIb3DQEJAzELBgkqhki
G9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTE4MDMyMjExMTcxNFowKgYJKoZIhvcNAQk0MR0wGzANBglghk
gBZQMEAgEFAKEKBggqhkjOPQQDAjAvBgkqhkiG9w0BCQQxIgQg9svFrRZsXzYTVfcjEY1GLP\/7zX+w
iSV49+wZWUuSPp0wCgYIKoZIzj0EAwIERjBEAiBvWxX3iYe9WoO\/gIFcJJwXwRXZk4rLQDW7GKedt1
VxfgIgFjTiK1d0LYX3TszoGY1SW78UjIKXXqGvDOcZGRFXeawAAAAAAAA=\",\"header\":
{\"ephemeralPublicKey\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEHG5xx6UTOdZhZ+rgs
iQFowpMGdjJjJ3FbDd4mDz2aonTqvpi80BzIYo7F26w4LBuuRavdPVFJ19\/8arHU9G2Cg==\",\"pu
blicKeyHash\":\"unmbHhzYYLMB\/z2lp5JB5bU9m8DWAIA04wdRFBQkhZU=\",\"transactionId
\":\"632c74aef15d8f11d2fdbceda9d6e24bc9da1f2431854f955670612da5cc129e\"}}"
}
{
"errorCode": 0,
"mdOrder": "584800701",
"state": 2,
"date": "17/04/2018 11:02:51",
"srcBinding": {//обратите внимание на набор данных, возвращаемый для карты списания
"bindingId": "TOKENIZED_CARD",
"bindingType": "EXTERNALLY_TOKENIZED_CARD",
"mnemonic": "APPLE_PAY",
"maskedPan": "480623******7846",//это маскированный токен, полученный от ApplePay

:
"cardType": "VISA"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"comment": "Комментарий для платежа ApplePay",
"bonusPoints": 1,
"refNum": "000004815701",
"approvalCode": "171437",
"service": {
"category": "mobilianyi_telefon",
"categoryName": "Мобильный телефон",
"serviceName": "МТС",
"serviceParams": {
"NUMBER": "9160000001"
}
},
"refnum": "000004815701",
"authCode": "171437"
}
Исходный объект pk_token (до экранирования):

{
"version": "EC_v1",
"data":
"eRXI+Ahiho2vpDLr4zkVbQaWp+yQL1iCTsKb+ndI8mvYGAOwaDM0Rc6Jd9/eiVeay7hSoEg/W4/0Gb40pBrtQS9/F2y2BnWe/
P4pCCWzANIkfGfQ0lYys6ll/2fjviiQlbhd0s7p1W8Y6/hpg+f5N8b6xabTNlpppoFIM+hJ+t2v/l9hrT1kwgN3bCVqXNWoxDY
udDmjptfIf9eXYrhEQfDMIyTZG+gzPdC9/MtqGfL5h7SxmgeKm8zFvsV/ic0ieprhqgBWTPWsYV/prpz3n6vAblXemkxMvnlNJ
3ZgbWnfL6tpireuf6Qj8/opx8OEeQIM0Pdu28Ad7rymtTPxtq+kaJcKhPz6spRxeyf1avCfhFbIEJ5PnBmVQroEB8+s8VPq9Rw
Nl0caZ+kmZw==",
"signature":
"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCAMIID4jCCA4igAwIBAgIIJEPyq
Aad9XcwCgYIKoZIzj0EAwIwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1U
ECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE0M
DkyNTIyMDYxMVoXDTE5MDkyNDIyMDYxMVowXzElMCMGA1UEAwwcZWNjLXNtcC1icm9rZXItc2lnbl9VQzQtUFJPRDEUMBIGA1U
ECwwLaU9TIFN5c3RlbXMxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQ
gAEwhV37evWx7Ihj2jdcJChIY3HsL1vLCg9hGCV2Ur0pUEbg0IO2BHzQH6DMx8cVMP36zIg1rrV1O/0komJPnwPE6OCAhEwggI
NMEUGCCsGAQUFBwEBBDkwNzA1BggrBgEFBQcwAYYpaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZWFpY2EzMDEwH
QYDVR0OBBYEFJRX22/VdIGGiYl2L35XhQfnm1gkMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUI/JJxE+T5O8n5sT2KGw/orv
9LkswggEdBgNVHSAEggEUMIIBEDCCAQwGCSqGSIb3Y2QFATCB/jCBwwYIKwYBBQUHAgIwgbYMgbNSZWxpYW5jZSBvbiB0aGlzI
GNlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBhc3N1bWVzIGFjY2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGF
yZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRlIHBvbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjd
GljZSBzdGF0ZW1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2VydGlmaWNhdGVhdXRob3JpdHkvMDQ
GA1UdHwQtMCswKaAnoCWGI2h0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlYWljYTMuY3JsMA4GA1UdDwEB/wQEAwIHgDAPBgkqh
kiG92NkBh0EAgUAMAoGCCqGSM49BAMCA0gAMEUCIHKKnw+Soyq5mXQr1V62c0BXKpaHodYu9TWXEPUWPpbpAiEAkTecfW6+W5l
0r0ADfzTCPq2YtbS39w01XIayqBNy8bEwggLuMIICdaADAgECAghJbS+/OpjalzAKBggqhkjOPQQDAjBnMRswGQYDVQQDDBJBc
HBsZSBSb290IENBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSB
JbmMuMQswCQYDVQQGEwJVUzAeFw0xNDA1MDYyMzQ2MzBaFw0yOTA1MDYyMzQ2MzBaMHoxLjAsBgNVBAMMJUFwcGxlIEFwcGxpY
2F0aW9uIEludGVncmF0aW9uIENBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQ
KDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABPAXEYQZ12SF1RpeJYEHduiAou/ee
65N4I38S5PhM1bVZls1riLQl3YNIk57ugj9dhfOiMt2u2ZwvsjoKYT/VEWjgfcwgfQwRgYIKwYBBQUHAQEEOjA4MDYGCCsGAQU
FBzABhipodHRwOi8vb2NzcC5hcHBsZS5jb20vb2NzcDA0LWFwcGxlcm9vdGNhZzMwHQYDVR0OBBYEFCPyScRPk+TvJ+bE9ihsP
6K7/S5LMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUu7DeoVgziJqkipnevr3rr9rLJKswNwYDVR0fBDAwLjAsoCqgKIY
maHR0cDovL2NybC5hcHBsZS5jb20vYXBwbGVyb290Y2FnMy5jcmwwDgYDVR0PAQH/BAQDAgEGMBAGCiqGSIb3Y2QGAg4EAgUAM
AoGCCqGSM49BAMCA2cAMGQCMDrPcoNRFpmxhvs1w1bKYr/0F+3ZD3VNoo6+8ZyBXkK3ifiY95tZn5jVQQ2PnenC/gIwMi3VRCG
wowV3bF3zODuQZ/0XfCwhbZZPxnJpghJvVPh6fRuZy5sJiSFhBpkPCZIdAAAxggGLMIIBhwIBATCBhjB6MS4wLAYDVQQDDCVBc
HBsZSBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml
0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMCCCRD8qgGnfV3MA0GCWCGSAFlAwQCAQUAoIGVMBgGCSqGSIb3D
QEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTE4MDMyMjA4MzQwMlowKgYJKoZIhvcNAQk0MR0wGzANBglghkgBZQM
EAgEFAKEKBggqhkjOPQQDAjAvBgkqhkiG9w0BCQQxIgQg8XaGe21xaN/RRkQl10d+KA3D5tMapWPtXdMIFXoZyWswCgYIKoZIz
j0EAwIERjBEAiBikWAEoX9uUnv7SoBqs3H2HOd/GxxI4njmE8hVeiOJqgIgPXzuJDv/Fo/qMMRs4S/bdHmcLMXc2HJv5KE42gS
fxTAAAAAAAAA=",
"header": {
"ephemeralPublicKey":
"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEysF79fOSxHhs4qGheTAg43VSoyC3WlCQbvXyRKIwBo4mrEqW8YhETnZVr6mTR
8fSOFxUMXCKB/woNbW3QfLi0g==",
"publicKeyHash": "xLuF1onJ13jeVj3C95GBNNbovNLsMEVhgyJNfB/e/3U=",
"transactionId": "83fb674442edf49d6437b469448105d5278bc2ec49de07fe58703246d0be2737"

:
}
}
16.2 /tokenpayments/paymentWithGooglePay.do – выполнить платеж с использованием

GooglePay




JSON


число

операции
googlePayTokenD Текст Обязательный Экранированный JSON-

ata (экранированный объект “токен”,
JSON) полученный от
GooglePay
16.2.2 Ответ
16.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/tokenpayments/paymentWithGooglePay.do
{
"userId": "CUI178770451",
"amount": "100",
"currency": "643",
"comment": "Комментарий для платежа GooglePay",
"googlePayTokenData": //обратите внимание на экранирование
"\
{"signature\": \"MEQCIDXFn\/E38PdcgV9e7Hq78pz+ZZuVstSDClnLMDTMuoQAAiBKUAbN7eYBj
uOTVTgMr1vSWyhAUS\/c7hXKWtI8obXOcA\\u003d\\u003d\",\r\n\t\"protocolVersion\": \

:
"ECv1\",\r\n\t\"signedMessage\": \"{\\\"encryptedMessage\\\":\\\"6q1kZOLvFen8Mh
TvbPKhVE2LABOWGyxb32YC8wQz+oDyZXU7wc4ybWcYO4s3GnQTWGJMGMrYDeGrnTqwVOBf\/E8tzNVf
AOvzMaO0ZeD2o075UEwxXYG4mBj3CC1rnTs\/8jsqLB2UbPzi7NL5i9\/3x\/35DlUefUGBny+vL1DC
TCVPZEZwg4jlvxaBYxAoa3bWfR6mH3eQiWkqqeGq8E4hT\/mBKHe8ZDA6pwZNoTk+4pjbaVss2O6Ndh
5v2rJhnpK+FTCMFEJx\/oyqpK7lmRZHZEk9nLffjW2b33MgQwkSLsUCeaCW3Ypy7unW4kidCtroAaRN
fl6Fwkxxzwz2gXP74wvET0SidzFrlsFbMtijxL3BRkEJdhSHQMKpw4yfsHQqqWfoAW1VaPjaIoViIj+
CfxcxaNzMvHXJep9CbnyZEm0iVFQqdTRH\/zL1OB7oCnMvu9rCarfWJIxOSWKsacaIQOktymxFAEJiA
DLGL7sDLmwInT3UNr8H7tYp2sOJXi8Ts+shAReqT9S5mDI\\\\u003d\\\",\\\"ephemeralPublic
Key\\\":\\\"BFNpSQ89UEUdiv1MZGo8uP3pb4Atv2RPgp2S1UFo+4uR3dWKzzSfXHc5xgRD3+X\/7t
XqQdjHBjsmTf5CUV\/GdBM\\\\u003d\\\",\\\"tag\\\":\\\"nDILsI9W5XjKzeOGWYKHWx9jgQH
D6Qybt6YvmjL8\/y4\\\\u003d\\\"}\"}"
}
{
"errorCode": 0,
"mdOrder": "584800701",
"state": 2,
"date": "17/04/2018 11:02:51",
"mnemonic": "GOOGLE_PAY",
"maskedPan": "520424******7840",//это маскированный токен, полученный от ApplePay
"cardType": "MASTERCARD"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"comment": "Комментарий для платежа GooglePay",
"bonusPoints": 1,
"refNum": "000004815701",
"service": {
"serviceParams": {
"NUMBER": "9160000001"
}
},
"refnum": "000004815701",
}
Исходный «токен» (до экранирования):

{
"signature":
"MEQCIDXFn/E38PdcgV9e7Hq78pz+ZZuVstSDClnLMDTMuoQAAiBKUAbN7eYBjuOTVTgMr1vSWyhAUS/c7hXKWtI8obXOcA\u0
03d\u003d",
"protocolVersion": "ECv1",
"signedMessage":
"{\"encryptedMessage\":\"6q1kZOLvFen8MhTvbPKhVE2LABOWGyxb32YC8wQz+oDyZXU7wc4ybWcYO4s3GnQTWGJMGMrYD
eGrnTqwVOBf/E8tzNVfAOvzMaO0ZeD2o075UEwxXYG4mBj3CC1rnTs/8jsqLB2UbPzi7NL5i9/3x/35DlUefUGBny+vL1DCTCV
PZEZwg4jlvxaBYxAoa3bWfR6mH3eQiWkqqeGq8E4hT/mBKHe8ZDA6pwZNoTk+4pjbaVss2O6Ndh5v2rJhnpK+FTCMFEJx/oyqp
K7lmRZHZEk9nLffjW2b33MgQwkSLsUCeaCW3Ypy7unW4kidCtroAaRNfl6Fwkxxzwz2gXP74wvET0SidzFrlsFbMtijxL3BRkE
JdhSHQMKpw4yfsHQqqWfoAW1VaPjaIoViIj+CfxcxaNzMvHXJep9CbnyZEm0iVFQqdTRH/zL1OB7oCnMvu9rCarfWJIxOSWKsa
caIQOktymxFAEJiADLGL7sDLmwInT3UNr8H7tYp2sOJXi8Ts+shAReqT9S5mDI\\u003d\",\"ephemeralPublicKey\":\"B
FNpSQ89UEUdiv1MZGo8uP3pb4Atv2RPgp2S1UFo+4uR3dWKzzSfXHc5xgRD3+X/7tXqQdjHBjsmTf5CUV/GdBM\\u003d\",\"
tag\":\"nDILsI9W5XjKzeOGWYKHWx9jgQHD6Qybt6YvmjL8/y4\\u003d\"}"
}

:
16.3 /tokenpayments/paymentWithSamsungPay.do – выполнить платеж с
использованием SamsungPay




JSON


число

операции
samsungPayToken Текст Обязательный Экранированный JSON-

Data (экранированный объект
JSON) “paymentCredential”,
полученный от
SamsungPay
16.3.2 Ответ
16.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/tokenpayments/paymentWithSamsungPay.do
{
"userId": "CUI178770451",
"amount": "100",
"currency": "643",
"comment": "Комментарий для платежа SamsungPay",
"googlePayTokenData": //обратите внимание на экранирование
"{\"3DS\":
{\r\n\t\t\"data\": \"eyJhbGciOiJSU0ExXzUiLCJraWQiOiJld0lWNXZhYUVqVmdlZGlyNHo4WW
5RV3czUzh6eVpxQ3NHMTd6dE16TXVrPSIsInR5cCI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250Z
Xh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.wK81ygelynhqo-
485pOuzPm_tr29JwXEDVB7X0q0Mgl58xIwsc6RQTMFEZPMYl6Opkn7eMWoyniuj4F_WkTSv2jAcfOPz

:
qxhTJh-snoJhBeUqLr17IrVEte3sWPf6NMBU-Ehvj7Mnan5i5jTNGtsrzDbjJIqHQa_b4D7P-1EC-
V96jj7DQW4vU4cvcpZCmdYUw5ySOcr8_hB_7ZfULNmIfwBDqqVNTQZhEr-
UdSMsXyK5mwqbsObPp1XrwpFmPjgEPsMfXN6W0fXcl34bwik0teTllS-
Y7c82IlEnHgueIoceu5dTGRhDj3WPy--
ccTYy2R8XPb27Vq1z0S2y9w5zA.ZvF61S_NIv8jh3hh.D4CU3wLXjlCPpEYgSCrk0G1bod9N_C8irn-
S1fViXrBFV8Q7m1FJuByLwJwY_TxJ_IR_aH0rt9crHQQwewFtTEANs9npVjbAVIAMVY3P72-
jv1O08sZqMA37p7jd52pkOzpoZJeXbQW484Ds63P8WywdlyeDnz0d73aHIFsAddwZ-
yb4EelZjVr9EpnUPXQVAzHx4SgUQ1qMn1eloSLPwzBTcxHjaDuYId449Z4DVQly-
g7jDWv_Kg.sHv1LRz6HvrpP8muGkbd3Q\",\r\n\t\t\"type\": \"S\",\r\n\t\t\"version\":
\"100\"\r\n\t},\r\n\t\"payment_card_brand\": \"MC\",\r\n\t\"payment_currency_ty
pe\": \"RUB\",\r\n\t\"payment_eco_opt_in\": \"true\",\r\n\t\"payment_last4_dpan
\": \"2363\",\r\n\t\"payment_last4_fpan\": \"4540\",\r\n\t\"merchant_ref\": \"b
f6103d152d441d2b33709\",\r\n\t\"method\": \"3DS\",\r\n\t\"recurring_payment\":
false,\r\n\t\"payment_shipping_address\": {\r\n\t\t\"shipping\":
{},\r\n\t\t\"email\": \"\"\r\n\t},\r\n\t\"payment_shipping_method\": \"\"}"
}
{
"errorCode": 0,
"mdOrder": "584800701",
"state": 2,
"date": "17/04/2018 11:02:51",
"mnemonic": "SAMSUNG_PAY",
"maskedPan": "515544******2363",//это маскированный токен, полученный от SamsungPay
"cardType": "MASTERCARD"
},
"amount": {
"total": "110,30",
"base": "100,00",
"fee": "10,30",
"currency": 643,
},
"comment": "Комментарий для платежа SamsungPay",
"bonusPoints": 1,
"refNum": "000004815701",
"service": {
"serviceParams": {
"NUMBER": "9160000001"
}
},
"refnum": "000004815701",
}
Исходный объект paymentCredential (до экранирования):
{
"3DS": {
"data":
"eyJhbGciOiJSU0ExXzUiLCJraWQiOiJld0lWNXZhYUVqVmdlZGlyNHo4WW5RV3czUzh6eVpxQ3NHMTd6dE16TXVrPSIsInR5c
CI6IkpPU0UiLCJjaGFubmVsU2VjdXJpdHlDb250ZXh0IjoiUlNBX1BLSSIsImVuYyI6IkExMjhHQ00ifQ.wK81ygelynhqo-
485pOuzPm_tr29JwXEDVB7X0q0Mgl58xIwsc6RQTMFEZPMYl6Opkn7eMWoyniuj4F_WkTSv2jAcfOPzqxhTJh-
snoJhBeUqLr17IrVEte3sWPf6NMBU-Ehvj7Mnan5i5jTNGtsrzDbjJIqHQa_b4D7P-1EC-
V96jj7DQW4vU4cvcpZCmdYUw5ySOcr8_hB_7ZfULNmIfwBDqqVNTQZhEr-
UdSMsXyK5mwqbsObPp1XrwpFmPjgEPsMfXN6W0fXcl34bwik0teTllS-Y7c82IlEnHgueIoceu5dTGRhDj3WPy--
ccTYy2R8XPb27Vq1z0S2y9w5zA.ZvF61S_NIv8jh3hh.D4CU3wLXjlCPpEYgSCrk0G1bod9N_C8irn-
S1fViXrBFV8Q7m1FJuByLwJwY_TxJ_IR_aH0rt9crHQQwewFtTEANs9npVjbAVIAMVY3P72-
jv1O08sZqMA37p7jd52pkOzpoZJeXbQW484Ds63P8WywdlyeDnz0d73aHIFsAddwZ-
yb4EelZjVr9EpnUPXQVAzHx4SgUQ1qMn1eloSLPwzBTcxHjaDuYId449Z4DVQly-g7jDWv_Kg.sHv1LRz6HvrpP8muGkbd3Q",
"type": "S",

:
"version": "100"
},
"payment_card_brand": "MC",
"payment_currency_type": "RUB",
"payment_eco_opt_in": "true",
"payment_last4_dpan": "2363",
"payment_last4_fpan": "4540",
"merchant_ref": "bf6103d152d441d2b33709",
"method": "3DS",
"recurring_payment": false,
"payment_shipping_address": {
"shipping": {
},
"email": ""
},
"payment_shipping_method": ""
}

:
2 Группа сервисов «Управление пользовательскими
блокировками»
2.1 /binding/addBindingBlockByCustomer.do – добавить полную пользовательскую

блокировку
2.1.1 Запрос

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

идентификатор связки
reasonDesc Текст 255 Опциональный Описание причины

блокировки в свободной
форме
2.1.2 Ответ

errorCode=0

errorCode=0

операции
bindingBlock* Набор полей из - Данные об операции

bindingBlock.
2.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/binding/addBindingBlockByCustomer.do?
userId=CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&reasonCode=1&rea
sonDesc=
{
"bindingId": 838EDF827F914BEC89C206F87548B886,
"uuid": "9D36F8D0CE8E4D79B31B417B970ADB41",

:
"source": "USER",
"blockType": "FULL",
"reasonCode": "1",
"startDateTime": "26/06/2018 17:04:07",
"errorCode": 0
}
2.2 /binding/removeBindingBlockByCustomer.do – убрать пользовательскую блокировку
2.2.1 Запрос


reasonCode Текст 64 Опциональный Код причины


2.2.2 Ответ

errorCode=0

errorCode=0

операции
bindingBlock* Набор полей из - Данные об операции

bindingBlock.
2.2.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/binding/removeBindingBlockByCustomer.do?
userId=CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&reasonCode=&reas

:
onDesc=
{
"uuid": "9D36F8D0CE8E4D79B31B417B970ADB41",
"source": "USER",
"blockType": "FULL",
"reasonCode": "1",
"startDateTime": "26/06/2018 17:04:07",
"blockEndSource": "USER",
"blockEndDateTime": "26/06/2018 17:12:33",
"errorCode": 0
}
2.3 /binding/addBindingBlock.do – добавить блокировку
2.3.1 Запрос


source Текст Обязательный Источник блокировки
blockType Обязательный Тип блокировки
reasonCode 64 Опциональный Код причины


блокировки в свободной
форме
2.3.2 Ответ

errorCode=0

errorCode=0

операции

:
bindingBlock* Набор полей из - Данные об блокировке

bindingBlock.
2.3.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/binding/addBindingBlock.do?userId=
CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&source=&blockType=&reas
onCode=1&reasonDesc=
{
"uuid": "43A665DE43BB47DCA155AC7C3833AD2B",
"source": "SYSTEM",
"blockType": "PARTIAL",
"reasonCode": "1",
"startDateTime": "26/06/2018 17:16:45",
"blockEndDateTime": "",
"errorCode": 0
}
2.4 /binding/removeBindingBlock.do – убрать блокировку
2.4.1 Запрос


source Текст Обязательный Источник разблокировки
blockType Обязательный Тип блокировки
reasonCode 64 Опциональный Код причины


2.4.2 Ответ

errorCode=0

:

errorCode=0

операции
bindingBlock * Набор полей из - Данные об операции

bindingBlock.
2.4.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/binding/removeBindingBlock.do? userId=
CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886&source=SYSTEM&blockType
=PARTIAL&reasonCode=1&reasonDesc=
{
"uuid": "43A665DE43BB47DCA155AC7C3833AD2B",
"source": "SYSTEM",
"startDateTime": "26/06/2018 17:16:45",
"blockEndReasonCode": "1",
"blockEndSource": "SYSTEM",
"blockEndDateTime": "26/06/2018 17:21:43",
"errorCode": 0
}
2.5 /binding/getBindingBlockList.do – получить список бокировок для связки
2.5.1 Запрос


2.5.2 Ответ

errorCode=0

:

errorCode=0

операции
blocks Набор полей из - Данные об операции

bindingBlock.
2.5.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/binding/getBindingBlockList.do?userId=
CUI178770451&bindingId=838EDF827F914BEC89C206F87548B886
{
"blocks": [
{
"uuid": "966B9998EBA64746888465380986D281",
"source": "SYSTEM",
"startDateTime": "26/06/2018 17:23:15",
"blockEndDateTime": ""
}
],
"errorCode": 0
}

:
17 Вспомогательные операции
17.1 /sms/send.do – отправить SMS-сообщение
17.1.1 Запрос
phone Строковый Обязательный Номер получателя.
text Строковый Обязательный Текст сообщения.
servicePhone Строковый Номер

отправителя.
17.1.2 Ответ

число
errorCode=0
17.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/sms/send.do?phone=79023332211&text=Test
{
"errorCode": 0
}

:
18 Информационные запросы
18.1 /mobileoperator/getInfoMyMsisdn.do – получить информацию об операторе

сотовой связи по переданному номеру телефона
18.1.1 Запрос
msisdn Номер телефона Обязательный Номер телефона,

(MSISDN) об операторе
которого
требуется
информация.
18.1.2 Ответ

положитель 0 если ошибок нет
ное число
Необязательный
для errorCode=0
operatorCode Текст Опциональный. Код ОСС, полученный от RegionService
если
errorCode=0
regionCode Текст Опциональный. Код региона абонента, полученный от

RegionService
если
errorCode=0
MNC Число Опциональный. Код мобильной сети, полученный от

RegionService
если
errorCode=0
route Текст Опциональный. Уникальный код маршрутизации для

каждого оператора, полученный от
RegionService
если
errorCode=0
topUpServiceUnique Текст Опциональный. Значение serviceId платежа для

Id пополнения баланса номера телефона у
найденного оператора.
если Если для полученного от RegionService

:
errorCode=0 кода ОСС в настройках eWallet не задано

значение serviceId, то в данном поле будет
значение
‘TOP_UP_SERVICE_UNIQUE_ID_UNKN
OWN’
18.1.3 Пример – serviceId для пополнения баланса задан

https://mts.rbsdev.com/ewallet/3.4/mts/mobileoperator/getInfoMyMsisdn.do?
msisdn=79161234567
{
"operatorCode": "mMTC",
"regionCode": "66",
"MNC": 10,
"route": "D6617",
"topUpServiceUniqueId": "1150",
"errorCode": 0
}
18.1.4 Пример – serviceId для пополнения баланса не задан

https://mts.rbsdev.com/ewallet/3.4/mts/mobileoperator/getInfoMyMsisdn.do?
msisdn=79161234567
{
"operatorCode": "mMTC",
"regionCode": "66",
"MNC": 10,
"route": "D6617",
"topUpServiceUniqueId": "TOP_UP_SERVICE_UNIQUE_ID_UNKNOWN",
"errorCode": 0
}

:
19 API для SMS переводов
19.1 /smsapi/transfer.do – Произвести перевод
19.1.1 Запрос

topUpServiceUniqueI Текст Обязательный Уникальный

d идентификатор
serviceParams[] Набор - Обязательный Атрибуты

параметров конкретного
transferAmount Положительное 9,2 Обязательный Сумма заказа

19.1.2 Ответ
Структура ответ идентична ответу на метод payment
19.1.3 Пример
https://mts.rbsdev.com/ewallet/3.4/mts/smsapi/transfer.do?
userId=00000000100000001555&serviceParams={%22p1%22:%221234%22}&transferAmount=22
.22&topUpServiceUniqueId=test
{
"errorCode": 0,
"mdOrder": "154228831124335500",
"state": 5,
"date": "15/11/2018 16:25:58",
"srcBinding": {
"phoneNumber": "79166000162",
"userId": "00000000100000001555",
"bindingId": "bindingId_MTS_ACCOUNT_79166000162",
"mnemonic": "mnemonic_MTS_ACCOUNT_79166000162"
},
"amount": {
"total": "22,22",
"base": "22,22",
"currency": 643,
},
"otpExpiresAt": "15/11/2018 16:35:58",
"service": {
"category": "test",
"serviceParams": {

:
"p1": "13456"
}
}
}

:
20 API для MasterPass
20.1 /masterpass/getBinding.do – Метод для получения ревкизитов карты

Для работы данного метода у партнера должен быть задан параметр
MasterPass.bindingManagement.allowed=true
20.1.1 Запрос
Парамет Тип данных Разме Обязательность Описание
р р
userId Строка 32 Обязательный Уникальный идентификатор клиента ЭК

(числовая)
bindingId Строка (UUID) Обязательный Уникальный идентификатор Платежного

инструмента в ЭК
2.5.4 Ответ

число
для errorCode=0
errorDesc Текст 250 Опциональный Описание ошибки
для errorCode=0
errorType Текст 200 Опциональный Присутствует в случае отсутствия у

партнера параметра, разрешающего
использовать API MasterPass
для errorCode=0
pan Строка (PAN) 19 Eсли errorCode=0 Номер карты (PAN)
expiry Строка 6 Eсли errorCode=0 Год и месяц окончания срока

действия карты (YYYYMM)
cardholderNam Строка 100 Eсли errorCode=0 Имя и фамилия держателя карты

e
mnemonic Строка 100 Eсли errorCode=0 Имя карты, присвоенное клиентом в

ЭК
20.1.2 Пример (успешный вызов)

https://mts.rbsdev.com/ewallet/3.4/mts/masterpass/getBinding.do?
userId=userId_79166000302&bindingId=bindingId_BOUND_CARD_79166000302
{
"pan": "4000020000005256",

:
"expiry": "204912",
"cardholderName": "CARDHOLDER NAME BOUND_CARD",
"mnemonic": "mnemonic_BOUND_CARD_79166000302",
"errorCode": 0
}
20.1.3 Пример (у мерчанта отсутствует параметр)

userId=userId_79166000302&bindingId=bindingId_BOUND_CARD_79166000302
{
"errorCode": 914,
"errorCause": "PARTNER_AUTHENTICATION_FAILED",
"errorType": "PARTNER_AUTH",
"errorDesc": "Not allowed to use API"
}
20.1.4 Пример (ПИ привязан к другому кошельку)

userId=userId_79166000302&bindingId= bindingId_BOUND_CARD_79166000307
{
"errorCode": 100,
"errorCause": "BINDING_DOES_NOT_BELONG_TO_WALLET"
}
20.1.5 Пример (ПИ не является картой (BOUND_CARD/GENERAL_CARD))

userId=userId_79166000302&bindingId= bindingId_EMONEY_ACCOUNT_79166000312
{
"errorCode": 243,
"errorCause": "Illegal binding type"
}
20.2 /masterpass/updateCardBindingData.do – Метод для обновления ревкизитов карты

Для работы данного метода у партнера должен быть задан параметр
MasterPass.bindingManagement.allowed=true
20.2.1 Запрос
ь
userId Строка 32 Обязательный Уникальный идентификатор клиента ЭК

(числовая)
bindingId Строка Обязательный Уникальный идентификатор Платежного

(UUID) инструмента в ЭК
pan Строка (PAN) 19 Обязательный Номер карты (PAN) – новое значение
expiry Строка 6 Обязательный Год и месяц окончания срока действия карты

(YYYYMM) – новое значение
cardholderNam Строка 100 Обязательный Имя и фамилия держателя карты – новое

e значение
mnemonic Строка 100 Обязательный Имя карты, присвоенное клиентом в ЭК –

новое значение

:
2.5.5 Ответ
р

errorCaus Текст 250 Опциональный Расшифровка кода

e ответа
errorCode=0
errorDesc Текст 250 Опциональный Описание ошибки
errorCode=0
20.2.2 Пример (успешный вызов)

https://mts.rbsdev.com/ewallet/3.4/mts/masterpass/updateCardBindingData.do?
userId= userId_79166000339 &bindingId=F8913996AC53481F84BF2A4FC9700D1B&pan=
4000020000005827&expiry=205012&cardholderName=CARDHOLDER NAME
B&mnemonic=mnemonic_4000020000005827
{"errorCode":0}

:

МТС ПЦ ЭК Протокол Подключения Агрегаторов и ТСП

Загружено:

Сведения о документе

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

МТС ПЦ ЭК Протокол Подключения Агрегаторов и ТСП

Загружено:

Авторское право:

Доступные форматы

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

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

__________________ / _____________/ __________________ /_____________./

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

____________ / _/ /_./

30.03.2017 Добавлен параметр comment в методах getTerms, transferTo*, Аносов Д.А.