Дата последнего обновления 16 декабря 2015 г.
ПОДПИСКА – услуга, подразумевающая регулярные списания фиксированных сумм денежных средств и предоставляющая доступ к определенному контенту на весь период действия услуги.
ПОТОК – гибко настраиваемый субаккаунт партнера, предназначенный для выделения трафика определенной категории (тематика трафика, источник и т.д).
ТАРИФИКАТОР – комплекс оборудования и ПО Mosbill, осуществляющий взаимодействие с оператором в течении всего жизненного цикла подписки.
СЕРВИС – Согласованная с оператором витрина, предоставляющая абоненту оригинальный контент на платной основе.
LANDING – принадлежащая оператору страница подтверждения согласия с подключением услуги и списанием денежных средств, кастомизированная в соответствии с тематикой сервиса.
РОТАЦИЯ – механизм, позволяющий предложить абоненту альтернативный Landing, в случае отказа от подписки, либо ошибки на стороне Оператора.
TRAFFBACK_URL – url, задаваемый для переадресации абонента в случае невозможности подписки абонента на основной и альтернативный Landing.
BACKURL – url, задаваемый для каждого сервиса, для переадресации абонента в случае успешного подключения подписки.
NOTIFICATION_URL - url обработчика уведомлений на стороне партнера.
1.Для инициализации подписки Партнер вызывает метод begin_subscribe. В ответ тарификатор отдает уникальный идентификатор операции tid.
2.Получив идентификатор, партнер переадресует абонента на тарификатор, добавляя GET параметр, содержащий полученный ранее tid.
3.Тарификатор осуществляет переадресацию абонента на лэндинговую страницу Оператора, где абонент либо подтверждает свое согласие с услугой, либо отказ от нее.
4.После подтверждения абонентом согласия с услугой происходит переадресация абонента на BACKURL (по требованиям Оператора, абонент должен быть переадресован на страницу с контентом той тематики, на которую он подписался), а на обработчик партнера поступает уведомление о подключении услуги и списании денежных средств.
Важно понимать, что уведомление и переадресация абонента не связанные события. Уведомление может поступить как раньше чем произойдет переадресация абонента так и позже этого.
5.В случае отказа абонента, или невозможности подписки на стороне Оператора или тарификатора по ряду причин, тарификатор производит переадресацию абонента на URL, заданный Партнером для traffback_url.
6.При наличии в настройках Потока альтернативных лэндингов, тарификатор при отказе абонента или невозможности подписки на основной лэндинг, производит переадресацию абонента на альтернативные landing page, настроенные для потока. Если ни на одном из доступных landing page подписка не оформляется, тарификатор переадресует абонента на traffback_url.
Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/begin_subscribe
Передаваемые параметры:
Параметр | Описание | Формат | Обязательный |
---|---|---|---|
stream_id | Идентификатор потока | Строка, до 40 символов | Да |
ip | IP-адрес абонента | Формат AAA.BBB.CCC.DDD | Да, если отсутствует номер абонента |
crc | Подпись запроса | Md5 контрольная сумма,формирование описывается в пункте "Подпись запросов" | Да |
ext_id | Идентификатор подписки на стороне партнера, будет возвращен при редиректе абонента | Строка, до 45 символов | Нет |
msisdn | Номер абонента | Международный формат 79ХХХХХХХХХ | Да, если отсутствует IP-адрес |
Пример запроса:
http://subscribe.mosbill.ru/begin_subscribe?stream_id=8c1ea140-5318-11e5-a698-005056aafe8c&ip=69.30.231.66&crc=test_partner&ext_id=232
Пример ответа:
66d69022-90b5-4e34-ac8e-a6e7653c6200
Выполняется HTTP GET запросом на URL http://subscribe.mosbill.ru/subscribe
Передаваемые параметры:
Параметр | Описание | Формат | Обязательный |
---|---|---|---|
tid | Уникальный идентификатор транзакции | Строка, до 255 символов | Да |
Пример запроса:
http://subscribe.mosbill.ru/subscribe?tid=66d69022-90b5-4e34-ac8e-a6e7653c6200
Результатом будет переадресация на Landing page.
Возможна подписка без предварительного получения временной ссылки. В этом случае Партнер переадресует абонента на статичную ссылку.Единственным обязательным передаваемым параметром является stream_id. Партнер также может передавать параметры, которые ему необходимы, например ext_id
Передаваемые параметры:
Параметр | Описание | Формат | Обязательный |
---|---|---|---|
stream_id | Идентификатор потока | Строка, до 40 символов | Да | tmpl | Идентификатор шаблона лэндинга | Строка, до 40 символов | Нет. Передается только для сервисов, поддерживающих мультилэндинг. Уточняйте в техподдержке. |
Пример запроса:
http://subscribe.mosbill.ru/ext/subscribe?stream_id=8c1ea140-5318-11e5-a698-005056aafe8c
Переадресация абонента на ресурс в случае успешного оформления подписки.
Передаваемые параметры:
Параметр | Описание | Формат | Обязательный |
---|---|---|---|
msisdn | Номер абонента | Международный формат 79ХХХХХХХХХ | Да |
Subscribe_Result | Результат операции | Может принимать значение 0 или 1 | Да |
ext_id | Идентификатор транзакции на стороне Партнера | Строка, до 45 символов | Да |
Пример запроса:
Выполняется HTTP GET запросом на URL traffback_url
Переадресация абонента на traffback_url, в случае невозможности активации подписки ни на одном из сервисов, настроенных для потока и оператора абонента.
Передаваемые параметры.
Параметр | Описание | Формат | Обязательный |
---|---|---|---|
ext_id | Идентификатор подписки на стороне партнера | Строка, до 45 символов | Да |
Выполняется HTTP GET запросом на URL http://subscribe.mosbill.ru/unsubscribe
Передаваемые параметры:
Параметр | Описание | формат | Обязательный |
---|---|---|---|
msisdn | Номер абонента | Международный формат 79ХХХХХХХХХ | Да, если отсутствует IP-адрес |
stream_id | Идентификатор потока | Строка, до 40 символов | Да |
crc | Подпись запроса | Md5 контрольная сумма, формирование описано в пункте "Подпись запросов" | Да |
Пример запроса:
http://subscribe.mosbill.ru/unsubscribe?crc=test_partner&msisdn=79856351936&stream_id=5ddb3262-5604-11e5-a698-005056aafe8c
В ответ партнер получает HTTP код 200.
Подпись запросов на подписку и отписку представляет собой контрольную сумму, которая формируется следующим образом:
все передаваемые параметры сортируются по именам параметров в алфавитном порядке и выстраиваются в строку ключ+значение, где + - конкатенация.
К полученной строке добавляется секретное слово (Salt) для потока.
Таким образом, для параметров b=1&a=2&c=3 и Salt qwerty, crc будет md5('a2b1c3qwerty')
Выполняется HTTP POST запросом на notification_url
Данные передаются в формате xml.
Для каждого события (Активация подписки, Тарификация, Неуспешная тарификация, Отписка) высылается отдельное уведомление.
Передаваемые параметры:
Параметр | Описание | Формат |
---|---|---|
action | Тип события | Может принимать значения SUBSCRIBE(активация подписки), PROLONG(тарификация), FAIL(неуспешная тарификация) UNSUBSCRIBE(отписка) |
notify_id | Уникальный идентификатор уведомления.Позволяет исключить повторную обработку уведомления в случае переотправки | Строка, до 40 символов |
timestamp | Метка времени события | timestamp |
partner_share | Размер отчисления партнера по конкретному событию | Число, разделитель целой и дробной части - точка |
write_off | Сумма, списанная с абонента | Число, разделитель целой и дробной части - точка |
subscription_id | Уникальный идентификатор подписки на стороне тарификатора | Строка, до 40 симоволов |
ext_id | Идентификатор подписки на стороне Партнера, переданный ранее при вызове метода begin_subscribe | Строка, до 45 символов |
service_id | Идентификатор сервиса на стороне тарификатора,на который в итоге подписался абонент. | Строка, до 40 символов |
stream_id | Идентификатор Потока | Строка, до 40 символов |
msisdn | Номер абонента | Международный формат 79ХХХХХХХХХ |
operator_group | Группа оператора абонента | Число.Может принимать значения для Билайн=2,Мегафон=3,МТС=4,Tele2=9 |
Примеры нотификации:
XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <partnerNotify> <notify_id>c17e8ce3-443d-4535-ab05-2c4889262e55</notify_id> <action>PROLONG</action> <subscription_id>74ab51c6-8656-4ea2-ba1e-c60c5239324d</subscription_id> <tid>25547b43-3db7-4f52-bc71-a3a730657b6a</tid> <ext_id>44202</ext_id> <service_id>31f6f1f7-5146-11e5-a698-005056aafe8c</service_id> <stream_id>252770a2-7346-11e5-a698-005056aafe8c</stream_id> <operator_group>4</operator_group> <msisdn>79886316813</msisdn> <write_off>20</write_off> <partner_share>4.585</partner_share> <timestamp>1447755683</timestamp> </partnerNotify>
РАЗОВЫЙ КЛИК – услуга, подразумевающая единовременное списание фиксированной суммы денежных средств и предоставляющая доступ к определенному контенту на весь период действия услуги.
ПОТОК – гибко настраиваемый субаккаунт партнера, предназначенный для выделения трафика определенной категории (тематика трафика, источник и т.д).
ТАРИФИКАТОР – комплекс оборудования и ПО Mosbill, осуществляющий взаимодействие с оператором в течении всего жизненного цикла подписки.
СЕРВИС – Согласованная с оператором витрина, предоставляющая абоненту оригинальный контент на платной основе.
LANDING – принадлежащая оператору страница подтверждения согласия с подключением услуги и списанием денежных средств, кастомизированная в соответствии с тематикой сервиса.
РОТАЦИЯ – механизм, позволяющий предложить абоненту альтернативный Landing, в случае отказа от подписки, либо ошибки на стороне Оператора.
TRAFFBACK_URL – url, задаваемый для переадресации абонента в случае невозможности подписки абонента на основной и альтернативный Landing.
BACKURL – url, задаваемый для каждого сервиса, для переадресации абонента в случае успешного подключения подписки.
NOTIFICATION_URL - url обработчика уведомлений на стороне партнера.
Для инициализации списания Партнер вызывает метод begin_subscribe. В ответ тарификатор отдает уникальный идентификатор операции tid.
Получив идентификатор, партнер переадресует абонента на тарификатор, добавляя GET параметр, содержащий полученный ранее tid.
Тарификатор осуществляет переадресацию абонента на лэндинговую страницу Оператора, где абонент либо подтверждает свое согласие с услугой, либо отказ от нее.
После подтверждения абонентом согласия с услугой происходит переадресация абонента на BACKURL (по требованиям Оператора, абонент должен быть переадресован на страницу с контентом той тематики, на которую он подписался), а на обработчик партнера поступает уведомление о подключении услуги и списании денежных средств.
Важно понимать, что уведомление и переадресация абонента не связанные события. Уведомление может поступить как раньше чем произойдет переадресация абонента так и позже этого.
В случае отказа абонента, или невозможности подписки на стороне Оператора или тарификатора по ряду причин, тарификатор производит переадресацию абонента на URL, заданный Партнером для traffback_url.
При наличии в настройках Потока альтернативных лэндингов, тарификатор при отказе абонента или невозможности подписки на основной лэндинг, производит переадресацию абонента на альтернативные landing page, настроенные для потока. Если ни на одном из доступных landing page подписка не оформляется, тарификатор переадресует абонента на traffback_url.
Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/begin_subscribe
Передаваемые параметры:
Параметр | Описание | Обязательный |
---|---|---|
stream_id | Идентификатор потока | да |
ip | IP-адрес абонента | да, если отсутствует номер абонента |
crc | md5 контрольная сумма | да |
ext_id | Идентификатор транзакции на стороне партнера | нет |
msisdn | Номер абонента | да, если отсутствует IP-адрес |
Пример запроса:
http://subscribe.mosbill.ru/begin_subscribe?streamid=8c1ea140-5318-11e5-a698-005056aafe8c&ip=69.30.231.66&crc=test_partner&ext_id=232
Пример ответа:
66d69022-90b5-4e34-ac8e-a6e7653c6200
Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/subscribe
Передаваемые параметры:
Параметр | Описание | Обязательный |
---|---|---|
tid | Уникальный идентификатор транзакции | да |
Пример запроса:
http://subscribe.mosbill.ru/subscribe?tid=66d69022-90b5-4e34-ac8e-a6e7653c6200
В ответ партнер получает HTTP код 302.
В заголовке Location будет ссылка на Landing page.
Выполняется HTTP GET запросом на URL traffback_url
Переадресация абонента на traffback_url, в случае невозможности подключения сервисов, настроенных для потока.
Переадресация осуществляется без каких-либо GET параметров.
Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/unsubscribe
Передаваемые параметры:
Параметр | Описание | Обязательный |
---|---|---|
msisdn | Номер абонента | да, если отсутствует IP-адрес |
service_id | Идентификатор сервиса, на который подписан абонент | да |
stream_id | Идентификатор потока | да |
crc | md5 контрольная сумма | да |
Пример запроса:
http://subscribe.mosbill.ru/unsubscribe?crc=test_partner&msisdn=79856351936&serviceid=86c46ce6-516a-11e5-a698-005056aafe8c
&streamid=5ddb3262-5604-11e5-a698-005056aafe8c
В ответ партнер получает HTTP код 200.
Выполняется HTTP POST запросом на notification_url
Данные передаются в формате xml.
Для каждого события высылается отдельное уведомление.
Передаваемые параметры:
Параметр | Описание |
---|---|
type | Тип события. Может принимать значения subscribe,prolong и close |
notify_id | Уникальный идентификатор уведомления.Позволяет исключить повторную обработку уведомления в случае переотправки |
timestamp | Метка времени события |
partner_share | Размер отчисления партнера по конкретному событию |
write_off | Сумма списанная с абонента |
subscription_id | Уникальный идентификатор подписки на стороне тарификатора |
ext_id | Партнерский идентификатор подписки, переданный ранее при вызове метода begin_subscribe |
service_id | Идентификатор сервиса на стороне тарификатора,на который подписался абонент. |
stream_id | Идентификатор Потока |
msisdn | Номер абонента в международном формате |
region | Идентификатор региона абонента |
operator | Название оператора абонента |
Примеры нотификации:
XML
{"event":{"type":"PROLONG","notify_id":"c12e3521-5799-11e5-a221-00259057bc07", "timestamp":1441879352,"partner_share":"5.00","write_off":"20.00","subscription_id": "73a2d437-579a-11e5-a221-00259057bc07","ext_id":"7eaa80b0-579a-11e5-a221-00259057bc07","service_id":"55f155383f65f", "stream_id":"55f155383f69a","msisdn": "71111111111","region":"123","operator":"mts"}}
На всех страницах сайта должна быть указана цена услуги, информация о способе отписки.
На сайте должны быть указаны корректные префиксы отписки (выдаются техподдержкой) в разделах: Стоимость услуги(для МТС), Правила подписки на контент, Получить контент, Управление подпиской на контент, Футер. Префиксы отписки по МТС и Теле2 указываются с пробелом после слова СТОП, по оператору Билайн и Мегафон – БЕЗ пробела.
Для сайтов с эротическим контентом требуется размещать на сайте значок 18+ либо надпись "запрещено для детей". Значок/надпись необходимо размещать в верхней части сайта.
На сайте - в оферте, футере, разделе "Управление подпиской на контент" должен быть указан телефон центра поддержки абонентов 8-800-302-03-90 и e-mail: claim@mosbill.ru
Текст основных полей страниц сайта, текст на кнопках и ссылках должен быть контрастным по отношению к фону. Ссылки в футере должны быть подчеркнуты
Кнопка "Получить контент" должна присутствовать на всех страницах сайта
В футере – должны присутствовать следующие ссылки – "Получить контент", "Управление подпиской на контент", "Правила подписки на контент", "Стоимость услуги"(для оператора МТС). При наличии футера для нескольких операторов – в конце каждой фразы добавляется – «для абонентов <Оператора>». Текст футера – должен быть контрастным по отношению к фону. Величина шрифта – не менее 10pt. Межстрочный интервал должен быть такой, чтобы ни строки ни ссылки не сливались.
Тексты основных полей, футера и Правил – заполняются по шаблонам, представленным в разделе "Скачать".
Поля для ввода номера – не должны быть очень мелкими. Инструкция для ввода номера – понятной.
На сайтах, предоставляющих файлы для скачивания, для пользователей IOS добавляется фраза: "Сайт доступен только для пользователей сетей мобильного интернета. При оформлении подписки пользователям устройств Apple Iphone предоставляются ссылки для скачивания файлов. Владельцы Apple Iphone могут открывать файлы при помощи стандартных приложений, установленных из Appstore.
На сайтах с музыкой и роликами – внизу перед футером должна присутствовать фраза: «Весь контент на сайте исключительно для ознакомления».
Сайт с контентной услугой должен содержать не менее 120-150 единиц контента.
Сайт по умолчанию должен блокировать доступ к контенту, в том числе и при входе с WEB. Для тестов и проверки контента оператором - партнер предоставляет логин для тестового входа на сайт.
На момент отправки сайта Оператору на согласование сайт должен обеспечивать переход мобильного абонента на лэндинговую страницу.
При нажатии кнопки Отмена на лэндинге – абонент должен быть переадресован обратно на сайт. При нажатии на лэндинговой странице кнопки подтверждения – также должен происходить возврат абонента на сайт соответствующей контентной услуги. При этом абонент получает доступ к Контенту.
Должен работать функционал раздела "Получить Контент". При наличии подписки – после ввода номера абонент получает доступ к контенту, при отсутствии подписки – сайт выдает сообщение «Указанный номер не найден».
Должен работать функционал раздела "Управление подпиской на контент". При заполнении номера в форму отписки и нажатии кнопки "Отписаться" сайт выдает сообщение: «Подписка отключена», при отсутствии номера в базе сайт выдает сообщение: «У Вас нет Подписок на Контент».
Нажатие на логотип – должно вести на главную страницу.
Если на сайте реализовано несколько разделов – обязательны должны присутствовать кнопки для навигации - "Вперед", "Назад".
Если на сайте реализована функция Поиска – она должен работать корректно.
При отправке SMS с кодом отписки, указанным на сайте, подписка должна отключиться, абонент должен получить смс об отключении подписки.
ОПЕРАТОР МТС
Стоимость услуги для абонентов МТС
Правила подписки на контент для абонентов МТС
Управление подпиской на контент для абонентов МТС
Получить контент
Стоимость услуги составляет 20 рублей с НДС за 1 календарный день для абонентов ПАО "МТС". С размером стоимости услуги
и порядком ее списания можно ознакомиться на cайте ПАО «МТС» www.mts.ru в разделе «Услуги по коротким номерам»,
введя короткий номер или идентификатор услуги в строке поиска,а также позвонив по единому номеру 88002500890.
Для отказа от предоставления Подписки на Контент отправьте смс-сообщение с текстом СТОП 20014 на номер 772370
(смс бесплатно в домашнем регионе) или наберите ussd-команду *152*22#вызов (бесплатно). Услуги предоставляются
ООО «Стрим» Контакты службы технической поддержки 8-800-234-0534, claim@mosbill.ru
ОПЕРАТОР БИЛАЙН
Правила подписки на контент
Управление подпиской на контент
Получить контент
Стоимость доступа составляет 20.00 рублей (включая НДС) за 1 день для абонентов ОАО «ВымпелКом»; Продление доступа происходит автоматически,
посредством подписки. Для отказа от предоставления Подписки на услугу отправьте SMS-сообщение со словом СТОП33333 на номер XXXX для абонентов ОАО
"ВымпелКом" сообщение бесплатно в домашнем регионе; Либо воспользуйтесь формой управления подпиской. Контакты службы поддержки: claim@mosbill.ru,
8-800-302-03-90 (звонок бесплатный).
ОПЕРАТОР ТЕЛЕ2
Правила подписки на контент
Управление подпиской на контент
Получить контент
Стоимость услуги: 20 руб. с НДС в сутки для абонентов Теле2. Услуга: Доступ к подписке «XXXXXX.ru». Нажатием кнопки «Подтвердить»
вы осуществляете заказ доступа к подписке «XXXXXX.ru», подтверждаете ознакомление и согласие с «Правилами предоставления услуги».
Услуга оказывается ООО «XXXXX», ОГРН 111222333444, http://xxx.com/. Информация для абонентов: тел. +8 (800) 234-05-34 (круглосуточно),
claim@mosbill.ru. Списание будет производиться с Вашего лицевого счета. GPRS-трафик оплачивается в соответствии с Вашим тарифным планом.
Не допускается скроллинг страницы LP (необходимость пролистывания страницы для просмотра всех её элементов. LP должен помещаться на один экран 320x480 в полном объёме.
Текст футера должен быть достаточно контрастным по отношению к фону. Ссылки в футере должны быть подчеркнутыми.
Обязательно наличие кнопки "Отмена". Она должна быть достаточно контрастной по отношению к фону.
Текст кнопки подтверждения выбирается из допустимо возможных (см. выдержки из Правил Операторов).
Кнопка на лэндинговой странице не должна быть слишком сильно закруглена так, чтобы отсутствовала кликабельная прямоугольная область вокруг нее и возможность подтвердить подписку, нажав не на саму кнопку, а на область рядом.
Для оператора МТС - партнер готовит верстку по шаблону, предоставляемому оператором, строго придерживаясь структуры файлов в архиве а также макет готового лэндинга.
Для оператора Билайн - партнер готовит архив, содержащий фоновый тизер, макет лэндинга и текстовый документ с описанием атрибутов лэндинга по предоставляемому оператором шаблону.
Для оператора Теле2 - лэндинг находится на сайте с контентом, партнер предоставляет скриншот-макет для утверждения оператором.
Для оператора Мегафон - Zip архив должен содержать HTML страницу, изображения, файлы стилей. При этом все файлы должны располагаться на одном уровне, то есть НЕ размещены по поддиректориям css, imgs. Архив не должен превышать размер 10mb.