Данный метод позволяет получить информацию обо всех платежных инструментов в электронном кошельке.
POST <Основные параметры> |
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| Request-Id | guid | да | Идентификатор конкретного запроса |
Requestor-Name | string | нет | Наименование сервиса.
|
| Requestor-Type | string | нет | Тип витрины.
|
| Requestor-Version | string | нет | Версия виджета/sdk |
Поле | Тип | Обязат. | Описание |
|---|---|---|---|
ssoTokenId | base64 | одно из двух | Идентификатор токена системы МТС.Логин |
ssoCookie | base64 | одно из двух | Идентификатор сессии пользователя МТС Логин (значение куки MTSWebSSO) |
Обязательность ssoTokenId и ssoCookie полей:
Должен быть передан один из двух параметров. Если переданы оба, то идентификация будет выполнена по параметру ssoTokenId.
Заголовок ответа
Content-Type: application/json; charset=utf-8 |
Тело ответа
Поле | Тип | Обязат. | Описание |
payerData | object | нет | Набор данных с параметрами плательщика |
paymentTools | object | нет | Блок с информацией по ПИ |
Описание структуры payerData
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| profile | object | нет | Набор данных профиля пользователя |
Описание структуры profile
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
phone | string[11] | да | Номер телефона авторизованного покупателя |
| title | string | да | Наименование профиля |
| subTitle | string | да | Доп информация профиля |
| image | string | нет | URL аватара профиля, с расширением (.jpeg, .png) |
| balance | amount | нет | Баланс счета |
| type | string (enum) | да | Тип профиля
|
Описание структуры paymentTools
Поле | Тип | Обяз. | Описание | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | string | да | Идентификатор платежного инструмента, присвоенный шлюзом | ||||||||||||||||||||||||||||
canDelete | boolean | да | Признак возможности удалить платежный инструмент | ||||||||||||||||||||||||||||
title | string | нет | Наименование платежного инструмента. Поле mnemonic в платежном инструменте МТС Деньги | ||||||||||||||||||||||||||||
| subTitle | string | нет | Дополнительное наименование платежного инструмента. Поле userCardMnemonic в платежном инструменте МТС Деньги | ||||||||||||||||||||||||||||
| mnemonic | string [100] | нет | Мнемоническое имя ПИ, заданное пользователем | ||||||||||||||||||||||||||||
type | typeEnum | да | Тип платежного инструмента | ||||||||||||||||||||||||||||
| complexType | string | да | Тип платежного инструмента
| ||||||||||||||||||||||||||||
| order | int32 | да | Порядковый номер для сортировки, по умолчанию 999 | ||||||||||||||||||||||||||||
imageUrl | string | нет | Ссылка на изображение платежного инструмента | ||||||||||||||||||||||||||||
ewalletBinding | object | да | Оплата со счета электронного кошелька МТС Деньги | ||||||||||||||||||||||||||||
cardInfo | object | нет | Блок с информацией по ПИ, специфичные для карты |
Описание структуры cardInfo
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| expiryYear | int32 | нет | Год срока действия карты |
| expiryMonth | int32 | нет | Месяц срока действия карты |
| maskedPan | string | нет | Маскированный номер карты |
Описание структуры ewalletBinding
Рекомендуем не использовать
Поле | Тип | Обяз. | Описание |
|---|---|---|---|
bindingId | string | да | Идентификатор счета/токена |
| bindingType | string | да | список типов, если "bindingType": "GENERAL_CARD", его заменяем на "BOUND_CARD". |
| cardType | string | нет | Тип карты, если ПИ имеет тип карты |
| userCardMnemonic | string | нет | Составное имя карты: тип карты + 4 последние цифры |
| userId | string | нет | Уникальный идентификатор пользователя в ПЦ ЭК |
POST |
{
"ssoCookie": "00d2a25f-bdd7-49a2-9444-0c167bcac67b....."
}
{
"ssoTokenId": "00d2a25f-bdd7-49a2-9444-0c167bcac67b....."
}
Content-Type: application/json; charset=utf-8 |
{
"payerData": {
"profile": {
"phone": "79455312312",
"title": "Иванов Иван",
"subTitle": "+7 945 531-23-12",
"image": "https://static.mts.ru/upload-sso/avatar/31dc7940-c8ee-4665-a3e1-9ea0ff01be2e.jpeg",
"type": "mobile"
}
},
"paymentTools": [
{
"id": "27Yw9cFxj27JrUxcQbNGMZL9Y6gt8vfqrffKje1KuckY1NG",
"title": "Phone 79181230012",
"mnemonic": "Phone 79181230012",
"complexType": "mtsMobileCommerce",
"imageUrl":"http://localhost/mtsaccount/",
"type": "eWalletBinding",
"canDelete": false,
"eWalletBinding": {
"bindingId": "123B9B1A448647EC8993DE8F0233E001",
"bindingType": "MTS_ACCOUNT",
"userId": "00013221231"
},
"order": 0
},
{
"id": "27Yvt3JFp7eVA1zTxAMuVmTy466aVV5DfotSLThgJyX4ELB",
"title": "5***8146",
"subTitle": "MASTERCARD *8146",
"mnemonic": "5***8146",
"canDelete": true,
"cardInfo": {
"expiryYear": 2023,
"expiryMonth": 5,
"maskedPan": "1231*****45456"
},
"complexType": "boundCard",
"type": "eWalletBinding",
"eWalletBinding": {
"bindingId": "12782FDFFD2F4FDDB1D23BAB23B0504D",
"bindingType": "BOUND_CARD",
"cardType": "MASTERCARD",
"userCardMnemonic": "MASTERCARD *8146",
"userId": "00013221231"
},
"order": 5
},
{
"id": "27Yw1oVg719zgX4Z2MPDAiN3Nna9qB2udGoK8dueTCj4uks",
"title": "Мой кошелек",
"mnemonic": "Мой кошелек",
"canDelete": false,
"complexType": "ewalletBinding",
"imageUrl":"http://localhost/mtsaccount/",
"type": "eWalletBinding",
"eWalletBinding": {
"bindingId": "12AC768B610F41A1836DCC24638585E1",
"bindingType": "EMONEY_ACCOUNT",
"userId": "00013221231"
},
"order": 6
}
]
}
code | message | userMessage |
|---|---|---|
00199998 | Validation error | Не пройдена валидация данных |
00199999 | An unexpected error has occurred | Непредвиденная ошибка |
00100002 | WEBSSO: Authentication is not taken place | WEBSSO: Аутентификация не пройдена |