«МТС»

Обзор

«МТС» — платёжный метод для проведения оплат с использованием физических терминалов «МТС». Оплаты осуществляются через Gate.

Характеристика

Тип платёжного метода физический терминал
Регионы использования RU
Валюты платежей RUB
Конвертация валют
Оплаты +
Выплаты
Оплаты по сохранённым данным
Полные возвраты
Частичные возвраты
Опротестования
Особенности оплата наличными
Организация и стоимость подключения по согласованию с курирующим менеджером ECommPay

Схема работы

В проведении отдельного платежа с использованием «МТС» задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ECommPay, а также сервис «МТС».

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

Интерфейсы Суммы, RUB Время*
Payment Page CMS Plug-ins Gate Dashboard (Old Dashboard) минимум максимум базовое предельное
Оплаты + 15 000,00 5 минут 1 час
* Базовое и предельное время определяются следующим образом:
  • Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время, определяемое для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя (там, где они необходимы). Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа.
  • Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус decline. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки ECommPay.

Сценарии использования

Проведение оплат с использованием метода «МТС» выполняется использованием физических терминалов «МТС».

Рис.: Оплата через Gate



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

Оплаты через Gate

Общая информация

Для оплаты через Gate с использованием метода «МТС» со стороны веб-сервиса необходимо:

  1. Обработать запрос на проверку существования лицевого счёта пользователя.
  2. Отправить ответ с информацией о существовании лицевого счёта пользователя.
  3. Обработать запрос на получение идентификатора платежа на стороне веб-сервиса.
  4. Отправить ответ с идентификатором платежа.
  5. Принять оповещение о результате оплаты.

Полная схема проведения оплаты представлена далее.



Рис.: Проведение оплаты через Gate

  1. Пользователь выбирает веб-сервис, лицевой счёт в котором он хочет пополнить, и затем вводит свои учётные данные в системе мерчанта.
  2. От физического терминала на заданный URL ECommPay передаётся запрос на проверку существования лицевого счёта пользователя.
  3. Выполняется обработка запроса.
  4. От платёжной платформы к веб-сервису передаётся запрос на проверку существования лицевого счёта пользователя.
  5. На стороне веб-сервиса проводится обработка запроса.
  6. От веб-сервиса к платёжной платформе передаётся ответ на запрос.
  7. От платёжной платформы к сервису «МТС» передаются результаты проверки данных лицевого счёта пользователя.
  8. Пользователю отображается форма оплаты «МТС».
  9. Пользователь вносит наличные для пополнения лицевого счёта.
  10. На стороне сервиса «МТС» выполняется обработка платежа.
  11. От сервиса «МТС» к платёжной платформе направляется уведомление о результате оплаты.
  12. От платёжной платформы к веб-сервису передаётся запрос на получение идентификатора платежа на стороне веб-сервиса.
  13. На стороне веб-сервиса проводится обработка запроса.
  14. От веб-сервиса к платёжной платформе передаётся информация об идентификаторе платежа.
  15. На стороне платёжной платформы создаётся операция.
  16. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
  17. Пользователь получает информацию о результате проведения оплаты на экране физического терминала.

Информация о формате запросов и параметрах инициирования оплат через Gate при работе с методом «МТС», а также о формате оповещений о результатах оплат приведена далее.

Формат запросов

При работе с запросами на проверку существования лицевого счёта пользователя необходимо учитывать следующее:

  1. Запрос verify для проверки существования лицевого счёта пользователя отправляется методом POST на заданный URL веб-сервиса.
  2. Запрос содержит следующие обязательные параметры:
    • type — тип операции на стороне веб-сервиса, значение параметра всегда verify;
    • customer_id — идентификатор пользователя в системе мерчанта;
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • signature — подпись запроса.

    Рис.: Пример запроса на проверку существования лицевого счёта пользователя

    {
       "type":"verify",
       "project_id":111,
       "customer_id":"ovleg@gmail.com",
       "signature":"lY0LTSAz85R7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gVcE1q
                                  VeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg=="
    }
  3. Ответ на запрос verify должен быть отправлен синхронно и содержать следующие обязательные параметры:
    • code — код ответа на запрос;
    • currency — валюта платежа в формате ISO-4217 alpha-3.

    Рис.: Пример ответа на запрос

    {
       "code":0,
       "currency":"RUB"
    }
При работе с запросами на получение идентификатора платежа необходимо учитывать следующее:
  1. Запрос check_deposit для получения идентификатора платежа на стороне веб-сервиса отправляется методом POST на заданный URL веб-сервиса.
  2. Запрос содержит следующие обязательные параметры:
    • type — тип операции на стороне веб-сервиса, значение параметра всегда check_deposit;
    • customer_id — идентификатор пользователя в системе мерчанта;
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • amount — сумма платежа в минорных единицах;
    • currency — валюта платежа в формате ISO-4217 alpha-3;
    • payment_method — код терминальной сети, значение параметра всегда Terminal/MTSRetail;
    • signature — подпись запроса.

    Рис.: Пример запроса на получение идентификатора платежа на стороне веб-сервиса

    {
       "type":"check_deposit",
       "project_id":111,
       "customer_id":"ovle8@mail.ru",
       "amount":10000,
       "currency":"RUB",
       "payment_method":"Terminal/MTSRetail",
       "signature":"lY0LTSAzpR7zGce5qfYGacOuYlHGWqkMcQlqmjlsDDZI2gV
                         cE1qVeWANnkIR7mdOqRXJnL1kO0lUmkQ0YYLWRg=="
    }
  3. Ответ на запрос check_deposit должен быть отправлен синхронно и содержать следующие обязательные параметры:
    • code — код ответа на запрос,
    • payment_id — уникальный идентификатор платежа на стороне веб-сервиса.

    Рис.: Пример ответа на запрос

    {
       "code":0,
       "payment_id":"test2345"
    }

Формат оповещений

Для оповещений о результатах оплат с применением метода «МТС» используется стандартный формат, описание которого представлено в разделе Оповещения.

Рис.: Пример оповещения о проведенной оплате

"project_id": 31,
"payment": {
	"id": "push-ecp2-3983778",
	"type": "purchase",
	"status": "success",
	"date": "2019-12-05T08:49:51+0000",
	"method": "MTSRetail",
	"sum": {
	"amount": 10000,
	"currency": "RUB"
},
"description": ""
},
"account": {
	"number": "79999815360"
},
"customer": {
	"id": "79999815360"
},
"operation": {
	"id": 5025076000003672,
	"type": "sale",
	"status": "success",
	"date": "2019-12-05T08:49:51+0000",
	"created_date": "2019-12-05T08:49:50+0000",
	"request_id": "a94e8ab7b38e5e7847c0bb5b1570d42ca792ed6ab6322bfb3545f09-05025077",
	"sum_initial": {
		"amount": 10000,
		"currency": "RUB"
	},
	"sum_converted": {
		"amount": 10000,
		"currency": "RUB"
	},
	"code": "0",
	"message": "Success",
	"provider": {
		"id": 1269,
	"payment_id": "415464276",
	"auth_code": "",
	"date": "2019-12-05T11:49:49+0000"
	}
},
"signature": "RxfJEibfv41Ryx3St2/6IzUNrhLiyIy5a2eYc6cN...zBIZ5A7YeEEi3bomAJ8Pe8Q=="
}

Дополнительные материалы

Для организации работы с оплатами через Gate также могут быть полезны следующие материалы:

Анализ результатов проведения платежей

Как и при работе с другими платёжными методами, которые предоставляет ECommPay, при использовании метода «МТС» доступны разные способы анализа информации о платежах и операциях с применением этого метода — как в отдельности, так и в совокупности с другими методами.

Всю необходимую информацию можно получать и анализировать средствами Dashboard (Old Dashboard), в том числе с помощью аналитических панелей на вкладке Analytics.

Также можно выгружать нужную информацию для последующего анализа с помощью специализированных аналитических средств сторонних разработчиков:

  • Dashboard (Old Dashboard) позволяет выгружать данные в форматах CSV и XLS с помощью инструментов на вкладке Платежи. При этом можно выполнять разовые выгрузки информации на локальный компьютер и задействовать периодическую выгрузку и отправку информации на заданные адреса электронной почты.
  • Data API позволяет получать информацию в формате JSON и отправлять ее на заданный URL — для этого применяются запросы /operations/get.

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